Visión general de los hosts de conectores locales

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.

## 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.