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

Назначение

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

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

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

Обзор

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

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

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

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

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

Сеть

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

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

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

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

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

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

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

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

Развертывание On-Premise Connector Host

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

Если принято решение о развертывании локального решения, компания 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 для версий образов Connector Host. Ниже приведен список активно поддерживаемых тегов On-Premise Connector Host, которые можно использовать совместно с командами Docker run и pull.

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

| Tag | LTS Version | Biweekly Version | | | --- | --- | --- | | | lts7 | LTS7 | r222 - r232 | | lts8 | LTS8 | r233 - r237 | | lts9 | LTS9 | r238- r248 | | lts10 | LTS10 | r249+ | | prod | LTS10 | r249+ |.

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

В следующем разделе описано, как развернуть хост коннектора On-Premise в различных средах. 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' \ HTTP_PROXY=''`HTTPS_PROXY=''`* Linux VM:

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>

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

Компания 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:`7. Убедитесь, что новый Docker-контейнер активен.

docker ps

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

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

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

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

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