Visión general de los hosts de conectores locales

Propósito

Aprenda a aprovechar los hosts de conectores locales para sus integraciones.

Requisitos previos

Para aprender sobre Connector Hosts en Tulip, primero revisa este artículo

Visión general

Este artículo pretende servir como punto de referencia para los On-Premise Connector Hosts (OPCH) en Tulip. El Connector Host es un servicio utilizado para facilitar las conexiones de Tulip a servicios web externos, bases de datos y servidores OPC UA. Todas las instancias de Tulip tienen un Cloud Connector Host por defecto.

Hay varias consideraciones a tener en cuenta a la hora de determinar si un Connector Host On-Premise es la arquitectura correcta.

Consideraciones clave para un host de conector local

Las consideraciones para un On-Premise Connector Host se pueden dividir en varias categorías:

1. 2. Gestión de la infraestructura Gestión de la infraestructura3. Rendimiento

Redes

La razón más común para desplegar un On-Premise Connector Host es por las ventajas que ofrece cuando se conecta a sistemas alojados dentro de una red local. Con la oferta on-premise, todas las conexiones de Tulip a sistemas externos comienzan dentro de su red local. Todas las conexiones desde su red son salientes a Tulip a través de un WebSocket seguro.

Esto contrasta con los Cloud Connector Hosts, que requieren acceso entrante a los servicios. Esto es típicamente una decisión de TI para permitir conexiones WebSocket seguras entrantes desde la nube de Tulip al servicio, a menudo utilizando reglas de reenvío de puertos en el router/firewall WAN.

Gestión de Infraestructura

Para desplegar un On-Premise Connector Host, hay varios componentes de infraestructura de los que el cliente es responsable. A continuación se muestra una matriz básica de funciones y responsabilidades:

Lo ideal es que el cliente se sienta cómodo con las tecnologías que utiliza para desplegar el Host Conector, así como con el uso de tecnologías como Docker para la gestión de contenedores.

Rendimiento

Como recomendación de buenas prácticas, Tulip recomienda utilizar también un Connector Host On-Premise al conectar un servidor OPC UA. Aunque es posible utilizar la solución en la nube, puede haber una gran demanda de ancho de banda en la red a medida que crece el número de etiquetas OPC UA suscritas.

Despliegue de un host conector local

Estándares técnicos

Cuando se toma la decisión de desplegar una solución on-premise, Tulip recomienda una ruta de autoservicio utilizando una imagen Docker distribuida. La forma más fácil de lograr esto sería utilizar una máquina virtual con una distribución de Linux (Ubuntu es preferible).

Tulip también recomienda alojar solo un On-Premise Connector Host por máquina virtual para evitar un único punto de fallo para los sitios.

Requisitos de la máquina virtual:

• RAM - 4 GB
• ROM - 8-16 GB de disco
• CPU - 2 núcleos
• Versión de Docker - 20.10+

En cuanto a los requisitos de red, el host del conector local tiene lo siguiente:

• Una dirección IP
• Resolución DNS a
• Acceso saliente en el puerto 443 a Tulip (IPs listadas aquí)
• Acceso saliente al repositorio Docker aquí
• Acceso saliente a todos los sistemas externos relevantes con puertos

Revisa la lista completa de requisitos de red aquí

Solicitud de credenciales

Ponte en contacto con Tulip Support(support@tulip.co) para solicitar las credenciales de On-Premise Connector Host utilizando la siguiente plantilla, rellenando los datos entre paréntesis.:

Esta es una solicitud para crear un nuevo On-Premise Connector Host. 


Instancia de Tulip:   
OPCH nombre: ---CH```


Tulip creará y compartirá las credenciales a través de un enlace seguro de contraseña temporal. Los detalles deben transferirse a un almacenamiento de credenciales gestionado internamente e incluir lo siguiente:


* Fábrica
* UUID
* Secreto de 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.**  
:::


### Versiones disponibles del Host Conector (Etiquetas)


Tulip utiliza etiquetas de imagen Docker para versionar las imágenes de Connector Host. A continuación se muestra una lista de etiquetas de host de conector local soportadas activamente que se pueden utilizar junto con los comandos de `ejecución` y `extracción` de Docker. 


:::(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).  
:::




| Etiqueta | Versión LTS | Versión quincenal |
| --- | --- | --- |
| `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.   
:::


### Despliegue


La siguiente sección describe cómo desplegar un Host Conector Local en una variedad de entornos. Tanto AWS como Azure ofrecen servicios de contenedor capaces de ejecutar la imagen Docker. 


* AWS:


	+ Utiliza la Web UI y este conjunto de instrucciones: <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 <NOMBRE DEL GRUPO DE RECURSOS EN AZURE> \ --name <NOMBRE DEL CONTENEDOR> \ --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=''`
* Linux VM: :::(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>`


## Actualización de un host de conector local


Tulip lanza actualizaciones para el On-Premise Connector Host de acuerdo con nuestro calendario de lanzamientos de soporte a largo plazo (LTS). Para actualizar el servicio, sigue las siguientes instrucciones:


:::(Info) (NOTE)
**The upgrade process for an OPCH will result in downtime while the pod is stopped and recreated.**  
:::


1. Obtenga la última versión de la imagen Docker del On-Premise Connector Host.

`docker pull bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>2`. Ejecute el siguiente comando para obtener el ID del contenedor Docker.

`docker ps3`. Si tienes acceso a `TULIP_FACTORY`, `TULIP_UUID`, y `TULIP_MACHINE_SECRET`, ve al paso 4. Si no, ejecute el siguiente comando y guarde la salida de este comando en una ubicación segura.

`docker exec <id-contenedor> env4`. Detenga el contenedor Docker existente.

`docker stop <id-contenedor>5`. Elimine el contenedor Docker existente.

`docker rm <id-contenedor>6`. Ejecute el comando de `ejecución` estándar de Docker aprovechando el conjunto de credenciales almacenadas.


:::(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 que el nuevo contenedor Docker está activo.

docker ps

## Referencias adicionales


### Activación de Log-Rotations para Docker


En el caso de los hosts de conectores locales existentes que no utilicen las rotaciones de registro de Docker, siga las instrucciones documentadas [aquí](https://support.tulip.co/docs/enabling-log-rotations-for-existing-on-premise-connector-host-container) para garantizar que el espacio en disco se mantiene correctamente.




---

¿Has encontrado lo que buscabas?


También puedes dirigirte a [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) para publicar tu pregunta o ver si otros se han enfrentado a una pregunta similar.