Обзор локальных узлов коннекторов

Назначение

Узнайте, как использовать хосты коннекторов On-Premise для своих интеграций.

Предварительные условия

Чтобы узнать о хостах коннекторов в Tulip, сначала ознакомьтесь с этой статьей

Обзор

Эта статья предназначена для ознакомления с хостами коннекторов On-Premise Connector Hosts (OPCH) в Tulip. Хост коннектора - это служба, используемая для облегчения подключения Tulip к внешним веб-службам, базам данных и серверам OPC UA. Все экземпляры Tulip по умолчанию имеют Cloud Connector Host.

Есть несколько соображений, которые необходимо учитывать при определении того, подходит ли локальный хост коннектора для данной архитектуры.

Ключевые соображения для локального узла коннектора

Соображения, касающиеся хоста On-Premise Connector Host, можно разделить на несколько категорий:

1. Сетевое взаимодействие2. Управление инфраструктурой3. Производительность

Сеть

Наиболее распространенным основанием для развертывания локального узла коннектора являются преимущества, которые он дает при подключении к системам, расположенным в локальной сети. При использовании локального предложения все соединения Tulip с внешними системами начинаются в вашей локальной сети. Все соединения из вашей сети отправляются в Tulip через безопасный WebSocket.

Это отличается от хостов облачных коннекторов, которые требуют входящего доступа к сервисам. Как правило, это решение ИТ-специалистов о разрешении входящих безопасных соединений WebSocket из облака Tulip к сервису, часто с использованием правил переадресации портов на маршрутизаторе/брандмауэре WAN.

Управление инфраструктурой

Для развертывания локального узла коннектора существует несколько компонентов инфраструктуры, за которые отвечает клиент. Ниже приведена матрица основных ролей и обязанностей:

В идеале клиент должен владеть технологиями, которые он использует для развертывания Connector Host, а также использовать такие технологии, как Docker, для управления контейнерами.

Производительность

В качестве рекомендации по передовому опыту Tulip рекомендует также использовать локальный Connector Host при подключении сервера OPC UA. Хотя можно использовать облачное решение, при увеличении количества подписанных тегов OPC UA может возникнуть большая потребность в пропускной способности сети.

Развертывание локального узла коннектора

Технические стандарты

Если принято решение о развертывании локального решения, Tulip рекомендует использовать маршрут самообслуживания с помощью распределенного образа Docker. Самым простым способом добиться этого будет использование виртуальной машины с дистрибутивом Linux (предпочтительнее Ubuntu).

Tulip также рекомендует размещать только один хост On-Premise Connector Host на одной виртуальной машине, чтобы избежать единой точки отказа для сайтов.

Требования к виртуальной машине:

• ОЗУ - 4 ГБ
• ПЗУ - диск объемом 8-16 ГБ
• Центральный процессор - 2 ядра
• Версия Docker - 20.10+

Что касается сетевых требований, то для хоста On-Premise Connector Host необходимо следующее:

• IP-адрес
• Разрешение DNS
• Исходящий доступ по порту 443 к Tulip (IP-адреса указаны здесь)
• Исходящий доступ к репозиторию Docker здесь
• Исходящий доступ ко всем соответствующим внешним системам с портами

Ознакомьтесь с полным списком сетевых требований здесь

Запрос учетных данных

Свяжитесь со службой поддержки Tulip(support@tulip.co), чтобы запросить учетные данные хоста On-Premise Connector Host, используя следующий шаблон, заполнив все детали, заключенные в скобки:

``Здравствуйте,

Это запрос на создание нового узла On-Premise Connector Host.

Экземпляр Tulip:
OPCH имя: ---CH``.

Tulip создаст и передаст учетные данные через безопасную ссылку с временным паролем. Данные должны быть переданы во внутреннее хранилище учетных данных и включать следующее:

• Фабрика
• UUID
• Секрет машины

Доступные версии (теги) хоста локального коннектора

Tulip использует теги образов Docker для версий образов Connector Host. Ниже приведен список активно поддерживаемых тегов On-Premise Connector Host, которые можно использовать в сочетании с командами Docker run и pull.

Развертывание

В следующем разделе описано, как развернуть хост On-Premise Connector Host в различных средах. AWS и Azure предлагают контейнерные службы, способные запускать образ Docker.

• AWS:

  • Используйте веб-интерфейс и этот набор инструкций: https://aws.amazon.com/getting-started/hands-on/deploy-docker-containers/

• Azure:

az container create \ -g <NAME OF THE RESOURCE GROUP IN AZURE> \ --name <NAME FOR THE CONTAINER> \ --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://<Ваш САЙТ>.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>

Обновление хоста локального коннектора

Tulip выпускает обновления для хоста On-Premise Connector Host в соответствии с нашим графиком долгосрочной поддержки (LTS). Чтобы обновить службу, следуйте приведенным ниже инструкциям:

1. Получите последнюю версию Docker-образа хоста On-Premise Connector Host.

docker pull bckca2dh98.execute-api.us-east-1.amazonaws.com/public/connector-host:<TAG>2. Выполните следующую команду, чтобы получить идентификатор контейнера Docker.

docker ps3. Если у вас есть доступ к TULIP_FACTORY, TULIP_UUID и TULIP_MACHINE_SECRET, перейдите к шагу 4. Если нет, выполните следующую команду и сохраните вывод этой команды в безопасном месте.

docker exec <container-id> env4. Остановите существующий контейнер Docker.

docker stop <container-id>5. Удалите существующий контейнер Docker.

docker rm <container-id>6. Запустите стандартную команду Docker run, используя сохраненный набор учетных данных.

``docker ps``.