Visão geral dos hosts do conector no local

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:

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.

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!