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 on-premise 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, inserendo 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

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 dei tag dell'host del connettore attivamente supportati che possono essere utilizzati insieme ai comandi Docker run e pull.

Distribuzione

La seguente sezione 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:

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

• 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=''

• 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>

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:

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.

``docker ps```