Visión general de los hosts de conectores locales
  • 04 Nov 2023
  • 6 Minutos para leer
  • Colaboradores

Visión general de los hosts de conectores locales


Article Summary

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 2. Gestión de la infraestructura 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 se inician 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 T ulip 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 roles y responsabilidades:

| | | | | | | | | | | Tulip | Cliente | | | Proporcionar recursos técnicos sobre OPCH | X | | Alojamiento y despliegue de máquinas virtuales | | X | | Supervisión y actualizaciones de máquinas virtuales | | X | | Generación de credenciales OPCH | X | | Despliegue de OPCH | | X | | Actualización de OPCH | | X | | Supervisión de OPCH | | X | | Resolución de problemas de OPCH | X | X | | X |.

Lo ideal es que el cliente se sienta cómodo con las tecnologías que utiliza para desplegar el Connector Host, 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 el Soporte de Tulip(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) (NOTA) Las credenciales del host de conector**local no deben utilizarse para crear más de un host de conector, ya que esto provocaría problemas de conectividad en todos los hosts que compartan credenciales.**:::


### Versiones disponibles del host conector local (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 hosts de conectores locales que se pueden utilizar junto con los comandos de `ejecución` y `extracción` de Docker. 


:::(Warning) (ADVERTENCIA) Para obtener el mejor rendimiento, la versión de tu instancia de Tulip y la versión del host del conector local deben coincidir. No se garantiza que el Connector Host sea compatible con las versiones de la instancia (por ejemplo, una versión de host de conector LTS8 en una instancia LTS7). :::


| Tag | LTS Version | Biweekly Version | | --- | --- | --- | | `lts7` | LTS7 | r222 - r232 | | `lts8` | LTS8 | r233 - r237 | | `lts9` | LTS9 | r238- r248 | | `lts10` | LTS10 | r249+ | | `prod` | LTS10 | r249+ | | `Prod` 


### Despliegue


En la siguiente sección se describe cómo implementar un host de conector local en diversos entornos. Tanto AWS como Azure ofrecen servicios de contenedor capaces de ejecutar la imagen Docker. 


* AWS:


	+ Utiliza la interfaz de usuario web y este conjunto de instrucciones: <https://aws.amazon.com/getting-started/hands-on/deploy-docker-containers/>
	+ 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' \ HTTP_PROXY=''`\`HTTPS_PROXY=''`\* Linux VM:


`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 HTTP_PROXY='' \ -e 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, siga las siguientes instrucciones:


:::(Info) (NOTA)**El proceso de actualización de un OPCH provocará un tiempo de inactividad mientras se detiene y se vuelve a crear el pod.**:::


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 la imagen Docker del pod. Ejecuta el siguiente comando para obtener el ID del contenedor Docker.


`docker ps`3. 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> env`4. Detenga el contenedor Docker existente. Detenga el contenedor Docker existente.


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


docker`rm`<id-contenedor> 6. Ejecute el comando Docker run estándar.`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 HTTP_PROXY='' \ -e 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 el nuevo contenedor Docker. 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 conector 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 mantenga 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.


¿Te ha sido útil este artículo?