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

Назначение

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

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

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

Обзор

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

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

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

Соображения по поводу локального узла коннектора можно разделить на несколько категорий:

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

Сеть

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

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

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

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

| | | | | | | --- | --- | --- | --- | | | Tulip | Заказчик | | | Предоставление технических ресурсов по OPCH | X | | | | Хостинг и развертывание виртуальной машины | | X | | Мониторинг и обновление виртуальной машины | | X | | Генерация учетных данных OPCH | X | | | Развертывание OPCH | | X | | | Обновление OPCH | | X | | Мониторинг OPCH | | X | | | Устранение неполадок OPCH | X | X | X | X | X | X | X | X |.

В идеале клиент должен быть уверен в технологиях, которые он использует для развертывания 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
• Секрет машины

:::(Info) (ПРИМЕЧАНИЕ)Учетные данные On-Premise Connector Host не должны использоваться для создания более чем одного Connector Host - это приведет к проблемам с подключением для всех узлов, совместно использующих учетные данные.:::

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

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

:::(Warning) (ВНИМАНИЕ) Для наилучшей производительности версия инстанции Tulip и версия хоста локального коннектора должны совпадать. Не гарантируется совместимость хоста коннектора с версиями экземпляров (т.е. версия хоста коннектора LTS8 на экземпляре LTS7). :::

| Tag | LTS Version | Biweekly Version | | | --- | --- | --- | --- | | lts7 | LTS7 | r222 - r232 | | lts8 | LTS8 | r233 - 237 | | lts9 | LTS9 | r238+ | | prod | LTS9 | r238+ |.

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

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

• AWS:

  • Используйте веб-интерфейс и этот набор инструкций: https://aws.amazon.com/getting-started/hands-on/deploy-docker-containers/.
  • Azure:az container create \ -g <НАЗВАНИЕ ГРУППЫ РЕСУРСОВ В AZURE> \ --name <НАЗВАНИЕ КОНТЕЙНЕРА> \ --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' \ HTTP_PROXY='' \ HTTPS_PROXY=''* Linux VM:

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 HTTP_PROXY='' \ -e 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). Чтобы обновить услугу, следуйте приведенным ниже инструкциям:

:::(Info) (ПРИМЕЧАНИЕ)Процесс обновления для OPCH приведет к простою, пока капсула будет остановлена и воссоздана.:::

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 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 HTTP_PROXY='' \ -e 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. Убедитесь, что новый Docker-контейнер активен.

docker ps

Дополнительные ссылки

Включение ротации журнала для Docker

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

Вы нашли то, что искали?

Вы также можете зайти на community.tulip.co, чтобы задать свой вопрос или узнать, сталкивались ли другие с подобным вопросом!