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

Назначение

Узнайте, как использовать хосты коннекторов 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.

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

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

| | | | | | | --- | --- | --- | | | Tulip | Заказчик | | Предоставление технических ресурсов по OPCH | X | | | | Хостинг и развертывание виртуальных машин | | X | | Мониторинг и обновление виртуальных машин | | X | | Генерация учетных данных OPCH | X | | | Развертывание OPCH | | X | | | Обновление OPCH | | X | | Мониторинг OPCH | | X | | | Устранение неполадок OPCH | 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 для версий образов 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 - r261 | | lts11 | LTS11 | r262 - r274 | | lts12 | LTS12 | r275+ |

:::(Warning) (Утрата тега Prod) Исторически сложилось так, что тег prod мог использоваться для указания на самую последнюю версию OPCH. Это было отменено. В дальнейшем тег prod будет указывать на LTS11.3 OPCH.
:::

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

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

• AWS:

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

:::(Warning) (До LTS12 OPCH) До LTS12 переменные окружения CONNECTORS_HTTPS_PROXY и CONNECTORS_HTTP_PROXY должны быть заменены на HTTPS_PROXY и HTTP_PROXY соответственно :::

• 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) До LTS12 переменные окружения CONNECTORS_HTTPS_PROXY и CONNECTORS_HTTP_PROXY должны быть заменены на HTTPS_PROXY и 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>

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

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, используя сохраненный набор учетных данных.

:::(Warning) (Pre-LTS12 OPCH) До LTS12 переменные окружения CONNECTORS_HTTPS_PROXY и CONNECTORS_HTTP_PROXY должны быть заменены на HTTPS_PROXY и 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. Убедитесь, что новый Docker-контейнер активен.

`` docker ps ``

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

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

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

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

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