MENU
    Visão geral dos hosts do conector no local
    • 08 Jan 2025
    • 6 Minutos para Ler
    • Contribuintes

    Visão geral dos hosts do conector no local


    Resumo do artigo

    Objetivo

    Saiba como aproveitar os On-Premise Connector Hosts para suas integrações.

    Pré-requisitos

    Para saber mais sobre Connector Hosts no Tulip, primeiro leia este artigo

    Visão geral

    Este artigo pretende servir como um ponto de referência para os On-Premise Connector Hosts (OPCH) na Tulip. O Connector Host é um serviço usado para facilitar as conexões da Tulip com serviços web externos, bancos de dados e servidores OPC UA. Todas as instâncias da Tulip têm um Cloud Connector Host por padrão.

    Há várias considerações a serem feitas ao determinar se um Connector Host local é a arquitetura correta.

    Principais considerações sobre o On-Premise Connector Host

    As considerações para um On-Premise Connector Host podem ser divididas em algumas categorias:

    1. Rede2. Gerenciamento de infraestrutura3. Desempenho

    Rede

    A justificativa mais comum para a implementação de um On-Premise Connector Host são as vantagens que ele oferece ao se conectar a sistemas hospedados em uma rede local. Com a oferta on-premise, todas as conexões da Tulip com sistemas externos começam em sua rede local. Todas as conexões de sua rede são enviadas para a Tulip por meio de um WebSocket seguro.

    Isso contrasta com os Cloud Connector Hosts, que exigem acesso de entrada aos serviços. Normalmente, essa é uma decisão de TI para permitir conexões WebSocket seguras de entrada da nuvem da Tulip para o serviço, muitas vezes usando regras de encaminhamento de porta no roteador/firewall WAN.

    Gerenciamento de infraestrutura

    Para implementar um On-Premise Connector Host, há vários componentes de infraestrutura pelos quais o cliente é responsável. Veja abaixo uma matriz básica de funções e responsabilidades:

    TulipaCliente
    Fornecer recursos técnicos no OPCHX
    Hospedagem e implementação de máquinas virtuaisX
    Monitoramento e atualizações de máquinas virtuaisX
    Geração de credenciais OPCHX
    Implementação do OPCHX
    Atualização do OPCHX
    Monitoramento da OPCHX
    Solução de problemas do OPCHXX

    O ideal é que o cliente esteja familiarizado com as tecnologias que usa para implementar o Connector Host, bem como com tecnologias como o Docker para gerenciamento de contêineres.

    Desempenho

    Como recomendação de práticas recomendadas, a Tulip recomenda também o uso de um Connector Host local ao conectar um servidor OPC UA. Embora seja possível usar a solução em nuvem, pode haver uma grande demanda de largura de banda na rede à medida que o número de tags OPC UA assinadas aumenta.

    Implantação de um host do conector local

    Padrões técnicos

    Quando se decide implantar uma solução local, a Tulip recomenda uma rota de autoatendimento usando uma imagem distribuída do Docker. A maneira mais fácil de fazer isso seria usar uma máquina virtual com uma distribuição do Linux (o Ubuntu é o preferido).

    A Tulip também recomenda hospedar apenas um On-Premise Connector Host por máquina virtual para evitar um único ponto de falha para os sites.

    Requisitos da máquina virtual:

    • RAM - 4 GB
    • ROM - 8-16 GB de tamanho de disco
    • CPU - 2 núcleos
    • Versão do Docker - 20.10+

    Para os requisitos de rede, o host do On-Premise Connector tem o seguinte:

    • Um endereço IP
    • Resolução de DNS para
    • Acesso de saída na porta 443 para a Tulip (IPs listados aqui)
    • Acesso de saída ao repositório Docker aqui
    • Acesso de saída a todos os sistemas externos relevantes com portas

    Veja a lista completa de requisitos de rede aqui

    Solicitação de credenciais

    Entre em contato com o Tulip Support(support@tulip.co) para solicitar credenciais do On-Premise Connector Host usando o seguinte modelo, preenchendo todos os detalhes entre colchetes:

    Esta é uma solicitação para criar um novo On-Premise Connector Host.
    
    
    Instância do Tulip:
    OPCH name: ---CH```
    
    
    A Tulip criará e compartilhará as credenciais por meio de um link de senha seguro e temporário. Os detalhes devem ser transferidos para um armazenamento de credenciais gerenciado internamente e incluir o seguinte:
    
    
    * Fábrica
    * UUID
    * Segredo da máquina
    
    
    :::(Info) (NOTE)
    **On-Premise Connector Host credentials should not be used to create more than one Connector Host - this would result in connectivity problems for all hosts sharing credentials.**
    :::
    
    
    ### Versões disponíveis do Connector Host no local (Tags)
    
    
    O Tulip usa tags de imagem do Docker para versionar imagens do Connector Host. Abaixo está uma lista de tags do On-Premise Connector Host com suporte ativo que podem ser usadas em conjunto com os comandos Docker `run` e `pull`.
    
    
    :::(Warning) (WARNING)
    For best performance, your Tulip Instance version and the On-Premise Connector Host version should match. The Connector Host is not guaranteed to be forward-compatible with instance versions (i.e. an LTS8 connector host version on an LTS7 instance).
    :::
    
    
    
    
    | Tag | Versão LTS | Versão quinzenal |
    | --- | --- | --- |
    | `lts7` | LTS7 | r222 - r232 |
    | `lts8` | LTS8 | r233 - r237 |
    | `lts9` | LTS9 | r238 - r248 |
    | `lts10` | LTS10 | r249 - r261 |
    | `lts11` | LTS11 | r262 - r274 |
    | `lts12` | LTS12 | r275-r287 |
    | `lts13` | LTS13 | r288+ |
    
    
    :::(Warning) (Prod Tag Deprecation)
    Historically, the `prod` tag could be used to point at the most recent version of OPCH. This has been deprecated. Going forward, the `prod` tag will point at LTS11.3 OPCH.
    :::
    
    
    ### Implantação
    
    
    A seção a seguir descreve como implantar um On-Premise Connector Host em uma variedade de ambientes. O AWS e o Azure oferecem serviços de contêineres capazes de executar a imagem do Docker.
    
    
    * AWS:
    
    
    	+ Use a UI da Web e este conjunto de instruções: <https://aws.amazon.com/getting-started/hands-on/deploy-docker-containers/>
    
    
    :::(Warning) (Pre-LTS12 OPCH)
    Prior to LTS12, the environment variables CONNECTORS\_HTTPS\_PROXY and CONNECTORS\_HTTP\_PROXY must be replaced with HTTPS\_PROXY and HTTP\_PROXY, respectively
    :::
    
    
    * Azure:
    
    `az container create \ -g <NOME DO GRUPO DE RECURSOS NO AZURE> \ --name <NOME DO CONTÊINER> \ --cpu 2 \ --memory 3 \ --restart-policy Always \ --image bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG> \ -e TULIP_UUID='<UUID>' \ TULIP_FACTORY='https://<YOUR SITE>.tulip.co' \ TULIP_MACHINE_SECRET='<SECRET>' \ TULIP_DEVICE_TYPE='onprem' \ CONNECTORS_HTTP_PROXY='' \ CONNECTORS_HTTPS_PROXY=''`
    * VM Linux: :::(Warning) (Pre-LTS12 OPCH)
    Prior to LTS12, the environment variables CONNECTORS\_HTTPS\_PROXY and CONNECTORS\_HTTP\_PROXY must be replaced with HTTPS\_PROXY and HTTP\_PROXY, respectively
    :::
    
    `docker run -d \ --name tulip-connector-host \ -e TULIP_FACTORY='https://<FACTORY>.tulip.co' \ -e TULIP_UUID='<UUID>' \ -e TULIP_MACHINE_SECRET='<SECRET>' \ -e TULIP_DEVICE_TYPE='onprem' \ -e CONNECTORS_HTTP_PROXY='' \ -e CONNECTORS_HTTPS_PROXY='' \ -e EXIT_ON_DISCONNECT=true \ --restart=always \ --net=host \ --mount type=volume,source=tuliplog,target=/log \ bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>`
    
    
    ## Atualização de um host de conector no local
    
    
    A Tulip lança atualizações para o On-Premise Connector Host de acordo com nosso cronograma de lançamento de suporte de longo prazo (LTS). Para atualizar o serviço, siga as instruções abaixo:
    
    
    :::(Info) (NOTE)
    **The upgrade process for an OPCH will result in downtime while the pod is stopped and recreated.**
    :::
    
    
    1. Obtenha a versão mais recente da imagem do Docker do On-Premise Connector Host.
    
    `docker pull bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>2`. Execute o comando abaixo para obter o ID do contêiner do Docker.
    
    `docker ps3`. Se você tiver acesso a `TULIP_FACTORY`, `TULIP_UUID` e `TULIP_MACHINE_SECRET`, vá para a etapa 4. Caso contrário, execute o seguinte comando e armazene a saída desse comando em um local seguro.
    
    `docker exec <container-id> env4`. Pare o contêiner do Docker existente.
    
    `docker stop <container-id>5`. Remova o contêiner do Docker existente.
    
    `docker rm <container-id>6`. Execute o comando padrão `de execução do Docker` aproveitando o conjunto de credenciais armazenadas.
    
    
    :::(Warning) (Pre-LTS12 OPCH)
    Prior to LTS12, the environment variables CONNECTORS\_HTTPS\_PROXY and CONNECTORS\_HTTP\_PROXY must be replaced with HTTPS\_PROXY and HTTP\_PROXY, respectively
    ::: `docker run -d \ --name tulip-connector-host \ -e TULIP_FACTORY='https://<FACTORY>.tulip.co' \ -e TULIP_UUID='<UUID>' \ -e TULIP_MACHINE_SECRET='<SECRET>' \ -e TULIP_DEVICE_TYPE='onprem' \ -e CONNECTORS_HTTP_PROXY='' \ -e CONNECTORS_HTTPS_PROXY=''`\ `-e EXIT_ON_DISCONNECT=true \ --restart=always \ --net=host \ --mount type=volume,source=tuliplog,target=/log \ bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>7`. Confirme se o novo contêiner do Docker está ativo.
    Plain text

    docker ps

    ## Referências adicionais
    
    
    ### Habilitação de rotações de registro para o Docker
    
    
    Para os Hosts do On-Premise Connector existentes que não estão usando rotações de log do Docker, siga as instruções documentadas [aqui](https://support.tulip.co/docs/enabling-log-rotations-for-existing-on-premise-connector-host-container) para garantir que o espaço em disco seja mantido adequadamente.
    
    
    
    
    ---
    
    Encontrou o que estava procurando?
    
    
    Você também pode acessar [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) para postar sua pergunta ou ver se outras pessoas tiveram uma pergunta semelhante!
    Plain text

    Este artigo foi útil?