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ózat 2. Infrastruktúra-kezelés 3. Teljesítmény

Hálózat

A Helyszíni 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 helyszíni 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 a szolgáltatásokhoz befelé irányuló hozzáférés szükséges. 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ó:

| | | | | | | | | | | | Tulip | | Ügyfél | | | Technikai erőforrások biztosítása az OPCH-hoz | X | | | Virtuális gép hosting és telepítés | | | X | | | Virtuális gép felügyelet és frissítések | | | X | | | OPCH hitelesítő adatok létrehozása | X | | | | | OPCH telepítése | | | X | | OPCH frissítése | | | X | | | OPCH felügyelete | | | X | | | OPCH hibaelhárítás | X | X | X | | X

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 technológiákat, például a Dockert.

Teljesítmény

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

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 Tuliphoz ( 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) (MEGJEGYZÉS) A**helyhez kötött Connector Host hitelesítő adatokat nem szabad egynél több Connector Host létrehozására használni - ez a hitelesítő adatokat megosztó összes hoszt esetében kapcsolódási problémákat eredményezne.**:::


### Elérhető On-Premise Connector Host verziók (Címkék)


A Tulip a Docker image tageket használja 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) (FIGYELMEZTETÉS) A legjobb teljesítmény érdekében a Tulip Instance verziójának és az On-Premise Connector Host verziójának meg kell egyeznie. A Connector Host nem garantáltan előre kompatibilis a példányverziókkal (pl. LTS8-as Connector Host verzió egy LTS7-es példányon). :::


| Címke | LTS verzió | Kétheti verzió | | | --- | --- | --- | --- | | | `lts7` | LTS7 | r222 - r232 | | `lts8` | LTS8 | r233 - r237 | | `lts9` | LTS9 | r238 - r248 | | | `lts10` | LTS10 | r249 - r261 | | `lts11` | LTS11 | r262 - r274 | | `lts12` | LTS12 | r275+ |


:::(Warning) (Prod tag visszavonása) A `prod` taggel korábban az OPCH legfrissebb verziójára lehetett mutatni. Ezt a funkciót már nem használjuk. A jövőben a `prod` tag az LTS11.3 OPCH-ra fog mutatni. 
:::


### Deployment


A következő szakasz 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/>.


:::(Warning) (LTS12 előtti OPCH) Az LTS12 előtt a CONNECTORS\_HTTPS\_PROXY és CONNECTORS\_HTTP\_PROXY környezeti változókat HTTPS\_PROXY és HTTP\_PROXY változókra kell cserélni :::


* Azure:


`\ -g <az AZURE ERŐFORRÁSCSOPORT NEVE> \ --név <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) (LTS12 előtti OPCH) LTS12 előtt a CONNECTORS\_HTTPS\_PROXY és CONNECTORS\_HTTP\_PROXY környezeti változókat HTTPS\_PROXY és HTTP\_PROXY változókra kell cserélni :::


`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) (MEGJEGYZÉS) Az**OPCH frissítési folyamata a pod leállítása és újbóli létrehozása közben állásidővel jár.**:::


1. Szerezze be az On-Premise Connector Host Docker image 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 ps`3. 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> env`4. Á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) (LTS12 előtti OPCH) LTS12 előtt a CONNECTORS\_HTTPS\_PROXY és CONNECTORS\_HTTP\_PROXY környezeti változókat HTTPS\_PROXY és HTTP\_PROXY változókra kell cserélni ::: `docker run -d \ --name tulip-connector-host \ -e TULIP_FACTORY='https://<FACTORY>.tulip.co' \ -e TULIP_UUID='<UUUID>' \ -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!