::::(Figyelmeztetés) (LTS12+ OPCH hálózati változások) Az LTS12-vel megváltozott az OPCH és a Tulip Cloud közötti kommunikáció módja. Ezekre a változtatásokra azért volt szükség, hogy az OPCH képes legyen támogatni a csatlakozók és gépek tömeges telepítését.
Ezzel a változtatással az OPCH a felhővel való folyamatos websocket-kapcsolat fenntartásáról áttért az állapot nélküli működésre. Ez az OPCH és a Tulip Cloud közötti RESTful hívások számának növekedéséhez vezet. Az OPCH frissítések során az ügyfelek felelősek annak biztosításáért, hogy a proxyk és tűzfalak képesek legyenek támogatni ezt a megnövekedett terhelést.
:::
Cél
Ismerje meg, hogyan használhatja ki az On-Premise Connector Hostokat az 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 Hostra vonatkozó 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 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-nál | X | |
| Virtuális gép hosting és telepítés | X | |
| Virtuális gépek felügyelete és frissítése | X | |
| OPCH hitelesítő adatok generálása | X | |
| OPCH tesztelése | X | |
| Az OPCH üzembe helyezése | X | |
| OPCH frissítése | X | |
| Az OPCH felügyelete | X | |
| Hibaelhárítás OPCH | 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 olyan technológiákat, mint a Docker.
Helyszíni Connector Host telepítése
Műszaki szabványok
The amount of resources needed to run OPCH will increase as its usage increases. If you consistently use it beyond 250Hz of throughput, we strongly advise allocating more resources to your virtual machines to ensure optimal performance.
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 javasol. Ennek legegyszerűbb módja egy virtuális gép használata egy Linux-disztribúcióval (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:
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) (Reusing Credentials)
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)
:::(Info) (Version Compatibility)
OPCH must be kept up-to-date with the Tulip product. More [information](/r230/docs/on-prem-connector-host-version-support).
:::
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.
| LTS verzió | Kéthetes verzió | Legutóbbi OPCH címke |
| --- | --- | --- |
| LTS11 | r262 - r274 | lts11.7 |
| LTS12 | r275-r287 | lts12.10 |
| LTS13 | r288-r307 | lts13.4 |
| LTS14 | r308+ | lts14 |
### Telepítés
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> \ --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) (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 \
## Helyi csatlakozógazda frissítése
:::(Info) (Version Compatibility)
OPCH must be kept up-to-date with the Tulip product. More [information](/r230/docs/on-prem-connector-host-version-support).
:::
:::(Info) (Recommended Upgrade Procedure for OPCH)
Tulip recommends proactively confirming the upgrade by successfully running a test OPCH connection to the development environment and/or developement instance. Once this verification is complete, the production environment can be confidently upgraded. Details on how can be found below.
:::
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:
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-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>
```
1. Erősítse meg, hogy az új Docker konténer aktív.
`docker ps`
### Connector-környezetek használata a frissítés teszteléséhez
Minden csatlakozónak három különböző környezete van (gyártás, gyártás előtti és fejlesztés), és mindegyik környezetnek saját csatlakozó hostja lehet, és ezek különböző verziók lehetnek.Az alkalmazás állapotától függően (fejlesztési verzió, jóváhagyásra váró, közzétett) különböző környezetet lehet használni.A várható folyamat a csatlakozó hostjának validálásához a következő kell legyen:1. Frissítse a fejlesztői OPCH2. Frissítse a validációs csatlakozógazda rendszerét (a gyártás előtti környezet itt a dev-re mutat) 1. Tesztelje a csatlakozóját a csatlakozók oldalon, vagy az alkalmazás fejlesztési módjában3. Ha a validációs tesztelés befejeződött, frissítse a gyártói csatlakozó hosztot
További információért lásd: [Hogyan futtathat egy csatlakozófunkciót több környezetben](/r230/docs/how-to-run-a-connector-function-in-multiple-environments)?
Alternatív megoldásként frissítheti az OPCH-t a fejlesztői példányon, majd magabiztosan frissítheti a termelési környezetet.
## További hivatkozások
### Naplóforgatások engedélyezése a Docker számára
A Docker naplóforgatásokat nem használó meglévő On-Premise Connector Hostok esetében 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!