Panoramica degli host di connettori on-premise

Scopo

Imparare a sfruttare gli Host Connector On-Premise per le proprie integrazioni.

Prerequisiti

Per conoscere i Connector Host in Tulip, leggete prima questo articolo

Panoramica

Questo articolo vuole essere un punto di riferimento per i Connector Host On-Premise (OPCH) in Tulip. Il Connector Host è un servizio utilizzato per facilitare le connessioni da Tulip a servizi web esterni, database e server OPC UA. Tutte le istanze di Tulip hanno un Cloud Connector Host per impostazione predefinita.

Ci sono diverse considerazioni da fare per determinare se un Connector Host On-Premise è l'architettura corretta.

Considerazioni chiave per l'host connettore On-Premise

Le considerazioni per un Host Connector On-Premise possono essere suddivise in alcune categorie:

1. Rete2. Gestione dell'infrastruttura3. Prestazioni

Rete

La motivazione più comune per l'implementazione di un Host Connector On-Premise è il vantaggio che offre per la connessione a sistemi ospitati all'interno di una rete locale. Con l'offerta on-premise, tutte le connessioni da Tulip ai sistemi esterni partono dalla rete locale. Tutte le connessioni dalla vostra rete sono in uscita verso Tulip tramite un WebSocket sicuro.

Ciò contrasta con i Cloud Connector Host, che richiedono un accesso in entrata ai servizi. In genere si tratta di una decisione IT per consentire connessioni WebSocket sicure in entrata dal cloud di Tulip al servizio, spesso utilizzando regole di port forwarding sul router/firewall WAN.

Gestione dell'infrastruttura

Per implementare un Host Connector On-Premise, ci sono diversi componenti dell'infrastruttura di cui il cliente è responsabile. Di seguito è riportata una matrice di ruoli e responsabilità di base:

Il cliente dovrà idealmente essere a proprio agio con le tecnologie utilizzate per distribuire il Connector Host, nonché con l'uso di tecnologie come Docker per la gestione dei container.

Prestazioni

Come raccomandazione per le migliori pratiche, Tulip consiglia di utilizzare anche un Host connettore in sede quando si collega un server OPC UA. Anche se è possibile utilizzare la soluzione cloud, la richiesta di larghezza di banda sulla rete può essere elevata con l'aumentare del numero di tag OPC UA sottoscritti.

Distribuzione di un host connettore locale

Standard tecnici

Quando si decide di implementare una soluzione on-premise, Tulip raccomanda un percorso self-service utilizzando un'immagine Docker distribuita. Il modo più semplice per farlo è utilizzare una macchina virtuale con una distribuzione di Linux (preferibilmente Ubuntu).

Tulip consiglia inoltre di ospitare un solo On-Premise Connector Host per macchina virtuale per evitare un singolo punto di guasto per i siti.

Requisiti della macchina virtuale:

• RAM - 4 GB
• ROM - 8-16 GB di disco
• CPU - 2 core
• Versione Docker - 20.10+

Per quanto riguarda i requisiti di rete, l'Host Connector On-Premise ha i seguenti requisiti:

• Un indirizzo IP
• Risoluzione DNS per
• Accesso in uscita sulla porta 443 a Tulip (IP elencati qui)
• Accesso in uscita al repository Docker qui
• Accesso in uscita a tutti i sistemi esterni rilevanti con le relative porte

Esaminare l'elenco completo dei requisiti di rete qui

Richiesta di credenziali

Contattare il Supporto Tulip(support@tulip.co) per richiedere le credenziali del Connettore Host On-Premise utilizzando il seguente modello, compilando tutti i dettagli racchiusi tra parentesi:

``Ciao,

Questa è una richiesta di creazione di un nuovo Host Connector On-Premise.

Istanza Tulip:
OPCH nome: ---CH```

Tulip creerà e condividerà le credenziali attraverso un collegamento sicuro e temporaneo alla password. I dettagli devono essere trasferiti a un archivio di credenziali gestito internamente e includere quanto segue:

• Fabbrica
• UUID
• Segreto della macchina

:::(Info) (NOTA**) Le credenziali dell'Host Connector On-Premise non devono essere utilizzate per creare più di un Host Connector: ciò comporterebbe problemi di connettività per tutti gli host che condividono le credenziali:**

Versioni disponibili dell'host del connettore in sede (tag)

Tulip utilizza i tag dell'immagine Docker per versionare le immagini dell'host del connettore. Di seguito è riportato un elenco di tag per l'host del connettore supportati attivamente che possono essere utilizzati insieme ai comandi Docker run e pull.

:::(Warning) (ATTENZIONE) Per ottenere prestazioni ottimali, la versione dell'istanza Tulip e la versione dell'host del connettore locale devono corrispondere. Non è garantita la compatibilità dell'host del connettore con le versioni dell'istanza (ad esempio, una versione host del connettore LTS8 su un'istanza LTS7):

:::(Warning) (Deprecazione del tag prod) Storicamente, il tag prod poteva essere usato per indicare la versione più recente di OPCH. Questo è stato deprecato. In futuro, il tag prod punterà a OPCH LTS11.3. :::

Distribuzione

La sezione seguente illustra come distribuire un Host Connector On-Premise in diversi ambienti. AWS e Azure offrono entrambi servizi di container in grado di eseguire l'immagine Docker.

• AWS:

  • Usare l'interfaccia web e questo set di istruzioni: https://aws.amazon.com/getting-started/hands-on/deploy-docker-containers/

:::(Warning) (OPCH precedente alla LTS12) Prima della LTS12, le variabili d'ambiente CONNECTORS_HTTPS_PROXY e CONNECTORS_HTTP_PROXY devono essere sostituite rispettivamente con HTTPS_PROXY e HTTP_PROXY::

• Azure:

az container create \ -g <NOME DEL GRUPPO DI RISORSE IN AZURE> \ --name <NOME DEL CONTENITORE> \ --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=''

• VM Linux: :::(Warning) (Pre-LTS12 OPCH)Prima della LTS12, le variabili d'ambiente CONNECTORS_HTTPS_PROXY e CONNECTORS_HTTP_PROXY devono essere sostituite rispettivamente con HTTPS_PROXY e HTTP_PROXY::

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>

Aggiornamento di un host del connettore On-Premise

Tulip rilascia gli aggiornamenti del Connector Host On-Premise in base al programma di rilascio del supporto a lungo termine (LTS). Per aggiornare il servizio, seguire le istruzioni riportate di seguito:

:::(Info) (NOTA**) Il processo di aggiornamento per un OPCH comporterà un tempo di inattività durante l'arresto e la ricreazione del pod:**

1. Ottenere l'ultima versione dell'immagine Docker di On-Premise Connector Host.

docker pull bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>2. Eseguire il comando seguente per ottenere l'ID del contenitore Docker.

docker ps3. Se si ha accesso ai dati TULIP_FACTORY, TULIP_UUID e TULIP_MACHINE_SECRET, passare al punto 4. In caso contrario, eseguire il comando seguente e memorizzare l'output del comando in un luogo sicuro.

docker exec <container-id> env4. Fermare il contenitore Docker esistente.

docker stop <container-id>5. Rimuovere il contenitore Docker esistente.

docker rm <container-id>6. Eseguire il comando standard Docker run sfruttando l'insieme delle credenziali memorizzate.

:::(Warning) (OPCH precedente alla LTS12)Prima della LTS12, le variabili d'ambiente CONNECTORS_HTTPS_PROXY e CONNECTORS_HTTP_PROXY devono essere sostituite rispettivamente con HTTPS_PROXY e HTTP_PROXY:: 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. Confermare che il nuovo contenitore Docker è attivo.

``docker ps```

Riferimenti aggiuntivi

Abilitazione delle rotazioni dei registri per Docker

Per gli host On-Premise Connector esistenti che non utilizzano le rotazioni dei registri di Docker, seguire le istruzioni documentate qui per garantire che lo spazio su disco sia mantenuto correttamente.

Avete trovato quello che cercavate?

Potete anche andare su community.tulip.co per porre la vostra domanda o vedere se altri hanno affrontato una questione simile!