Überblick über On-Premise Connector Hosts

Dies ist eine Anfrage zur Erstellung eines neuen On-Premise Connector Hosts.


Tulip-Instanz:
OPCH Name: ---CH```


Tulip wird die Anmeldedaten über eine sichere, temporäre Passwortverbindung erstellen und weitergeben. Die Details sollten in einen intern verwalteten Anmeldungsspeicher übertragen werden und Folgendes beinhalten:


* Werk
* UUID
* Maschinengeheimnis


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


### Verfügbare On-Premise Connector Host-Versionen (Tags)


Tulip verwendet Docker Image Tags, um Connector Host Images zu versionieren. Nachstehend finden Sie eine Liste der aktiv unterstützten On-Premise Connector Host Tags, die in Verbindung mit Docker `run` und `pull` Befehlen verwendet werden können.


:::(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 | LTS-Version | Zweiwöchentliche Version |
| --- | --- | --- |
| `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.
:::


### Bereitstellung


Im folgenden Abschnitt wird beschrieben, wie ein On-Premise Connector Host in verschiedenen Umgebungen bereitgestellt werden kann. AWS und Azure bieten beide Containerdienste an, die das Docker-Image ausführen können.


* AWS:


	+ Verwenden Sie die Web-UI und diesen Befehlssatz: <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 <NAME DER RESOURCE GROUP IN AZURE> \ --name <NAME FÜR DEN CONTAINER> \ --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>`


## Aktualisieren eines On-Premise Connector Hosts


Tulip veröffentlicht Updates für den On-Premise Connector Host in Übereinstimmung mit unserem Long Term Support (LTS) Release-Plan. Um den Dienst zu aktualisieren, folgen Sie den unten stehenden Anweisungen:


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


1. Besorgen Sie sich die neueste Version des On-Premise Connector Host Docker-Images.

`docker pull bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>2`. Führen Sie den folgenden Befehl aus, um die Docker-Container-ID zu erhalten.

`docker ps3`. Wenn Sie Zugriff auf `TULIP_FACTORY`, `TULIP_UUID` und `TULIP_MACHINE_SECRET` haben, fahren Sie mit Schritt 4 fort. Wenn nicht, führen Sie den folgenden Befehl aus und speichern Sie die Ausgabe dieses Befehls an einem sicheren Ort.

`docker exec <container-id> env4`. Stoppen Sie den vorhandenen Docker-Container.

`docker stop <container-id>5`. Entfernen Sie den vorhandenen Docker-Container.

`docker rm <container-id>6`. Führen Sie den Standardbefehl `"Docker run"` aus und nutzen Sie dabei die gespeicherten Anmeldeinformationen.


:::(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`. Bestätigen Sie, dass der neue Docker-Container aktiv ist.

## Zusätzliche Referenzen


### Aktivieren von Log-Rotationen für Docker


Für bestehende On-Premise Connector Hosts, die keine Docker Log-Rotationen verwenden, befolgen Sie die [hier](https://support.tulip.co/docs/enabling-log-rotations-for-existing-on-premise-connector-host-container) dokumentierten Anweisungen, um sicherzustellen, dass der Speicherplatz ordnungsgemäß verwaltet wird.




---

Haben Sie gefunden, wonach Sie gesucht haben?


Sie können auch zu [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) gehen, um Ihre Frage zu stellen oder zu sehen, ob andere mit einer ähnlichen Frage konfrontiert wurden!