A helyben telepített csatlakozó hosztok áttekintése

Cél

Ismerje meg, hogyan használhatja ki a Helyszíni csatlakozógazdákat integrációi számára.

Előfeltételek

A Tulipban található Connector Hosts megismeréséhez először olvassa el ezt a cikket.

Áttekintés

Ez a cikk a Tulipban található On-Premise Connector Hosts (OPCH) referenciaként szolgál. A Connector Host egy olyan szolgáltatás, amely a Tulip külső webszolgáltatásokhoz, adatbázisokhoz és OPC UA-kiszolgálókhoz való kapcsolódásának megkönnyítésére szolgál. Alapértelmezés szerint minden Tulip-példány rendelkezik Cloud Connector Hostdal.

Számos megfontolásra van szükség annak eldöntéséhez, hogy egy On-Premise Connector Host megfelelő architektúrát jelent-e.

Legfontosabb megfontolások az On-Premise Connector Host esetében

Az On-Premise Connector Hostdal kapcsolatos megfontolások néhány kategóriára bonthatók:

1. Hálózat2. Az infrastruktúra kezelése3. Teljesítmény

Hálózat

A Helyi csatlakozógazda telepítésének leggyakoribb oka a helyi hálózaton belül hosztolt rendszerekhez való csatlakozáskor nyújtott előnyök. A helyhez kötött ajánlat esetén a Tulip minden kapcsolata a külső rendszerekhez a helyi hálózaton belülről indul. Az Ön hálózatából minden kapcsolat biztonságos WebSocket-en keresztül indul a Tulip felé.

Ez ellentétben áll a Cloud Connector Hostokkal, amelyeknél befelé irányuló hozzáférés szükséges a szolgáltatásokhoz. Ez jellemzően egy informatikai döntés, hogy a Tulip felhőjéből befelé irányuló biztonságos WebSocket-kapcsolatokat engedélyezzenek a szolgáltatáshoz, gyakran porttovábbítási szabályok használatával a WAN-routeren/tűzfalon.

Infrastruktúra-kezelés

Az On-Premise Connector Host telepítéséhez több infrastrukturális komponens van, amelyekért az ügyfél felelős. Az alábbiakban egy alapvető szerepek és felelősségi körök mátrixa látható:

Az ügyfél ideális esetben jól ismeri a Connector Host telepítéséhez használt technológiákat, valamint a konténer-kezeléshez használt olyan technológiákat, mint a Docker.

Teljesítmény

A legjobb gyakorlatok ajánlásaként a Tulip az OPC UA-kiszolgáló csatlakoztatásakor is egy On-Premise Connector Host használatát ajánlja. Bár a felhőmegoldás használata lehetséges, a hálózaton nagy sávszélességigény jelentkezhet, ahogy a feliratkozott OPC UA címkék száma növekszik.

Helyszíni Connector Host telepítése

Műszaki szabványok

Ha a döntés egy helyben telepített megoldás mellett születik, a Tulip egy elosztott Docker-képet használó önkiszolgáló útvonalat ajánl. Ennek legegyszerűbb módja egy virtuális gép használata egy Linux-disztribúcióval (az Ubuntu előnyben részesül).

A Tulip azt is ajánlja, hogy virtuális gépenként csak egy On-Premise Connector Hostot üzemeltessenek, hogy elkerüljék a telephelyek egyetlen hibapontját.

Virtuális gépre vonatkozó követelmények:

• RAM - 4 GB
• ROM - 8-16 GB lemezméret
• CPU - 2 mag
• Docker verzió - 20.10+

A hálózati követelmények tekintetében az On-Premise Connector Host a következőkkel rendelkezik:

• IP-cím
• DNS-feloldás a következőre
• Kimenő hozzáférés a 443-as porton a Tulip-hoz ( itt felsorolt IP-k)
• Kimenő hozzáférés a Docker tárolóhoz itt
• Kimenő hozzáférés az összes releváns külső rendszerhez portokkal

A hálózati követelmények teljes listájának áttekintése itt

Hitelesítési adatok kérése

Vegye fel a kapcsolatot a Tulip ügyfélszolgálattal(support@tulip.co), hogy az alábbi sablon segítségével kérjen On-Premise Connector Host hitelesítő adatokat, és töltse ki a zárójelben lévő adatokat..:

Ez egy új On-Premise Connector Host létrehozására irányuló kérelem. 


Tulip példány:   
OPCH név: ---CH```


A Tulip létrehozza és megosztja a hitelesítő adatokat egy biztonságos, ideiglenes jelszavas kapcsolaton keresztül. Az adatokat egy belsőleg kezelt hitelesítő adatok tárolására kell átvinni, és a következőket kell tartalmaznia:


* Gyári
* UUID
* Gépi titok


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


### Elérhető helyszíni csatlakozó host-verziók (címkék)


A Tulip Docker image tageket használ a Connector Host képek verziózásához. Az alábbiakban az aktívan támogatott On-Premise Connector Host címkék listája található, amelyek a Docker `run` és `pull` parancsokkal együtt használhatók. 


:::(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 verzió | Kéthetes verzió |
| --- | --- | --- |
| `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.   
:::


### Deployment


A következő szakasz azt ismerteti, hogyan lehet egy On-Premise Connector Hostot különböző környezetekben telepíteni. Az AWS és az Azure egyaránt kínál olyan konténerszolgáltatásokat, amelyek képesek a Docker-kép futtatására. 


* AWS:


	+ Használja a webes felhasználói felületet és ezt az utasításkészletet: [https://aws.amazon.com/getting-started/hands-on/deploy-docker-containers/.](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:

`\ -g <az AZURE-ban lévő erőforráscsoport neve> \ --name <a konténer neve> \ --cpu 2 \ --memória 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>`


## Helyi Connector Host frissítése


A Tulip az On-Premise Connector Host frissítéseit a hosszú távú támogatási (LTS) kiadási ütemtervünknek megfelelően adja ki. A szolgáltatás frissítéséhez kövesse az alábbi utasításokat:


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


1. Szerezze be az On-Premise Connector Host Docker-kép legújabb verzióját.

`docker pull bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>2`. Futtassa az alábbi parancsot a Docker konténer azonosítójának lekérdezéséhez.

`docker ps3`. Ha hozzáfér a `TULIP_FACTORY`, `TULIP_UUID` és `TULIP_MACHINE_SECRET` adatokhoz, akkor folytassa a 4. lépéssel. Ha nem, futtassa a következő parancsot, és a parancs kimenetét tárolja egy biztonságos helyen.

`docker exec <container-id> env4`. Állítsa le a meglévő Docker konténert.

`docker stop <container-id>5.`Távolítsa el a meglévő Docker konténert.

`docker rm <container-id>6.`Futtassa a standard `Docker run` parancsot a tárolt hitelesítő adatok felhasználásával.


:::(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`. Erősítse meg, hogy az új Docker konténer aktív.



```
````docker ps```
```

## További hivatkozások


### Naplóforgatások engedélyezése a Docker számára


A meglévő On-Premise Connector Hostok esetében, amelyek nem használják a Docker naplóforgatásokat, kövesse az [itt](https://support.tulip.co/docs/enabling-log-rotations-for-existing-on-premise-connector-host-container) dokumentált utasításokat a lemezterület megfelelő karbantartásának biztosítása érdekében.




---

Megtalálta, amit keresett?


A [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) oldalon is megteheti, hogy felteszi kérdését, vagy megnézheti, hogy mások is szembesültek-e hasonló kérdéssel!