Creatio administration

Способы развертывания сервиса Exchange Listener

Для разворачивания сервиса предпочтительным способом является использование оркестратора Kubernetes и пакетного менеджера Helm. Подробнее >>>

Для более быстрого развертывания в среде разработки можно использовать Docker. Подробнее >>>

Развертывание сервиса синхронизации с использованием Kubernetes

Для развертывания сервиса выполните следующие шаги:

1.Предварительно настройте целевое окружение:

a.Кластер Kubernetes. Подробно о том, как настроить и администрировать кластер, читайте на сайте документации Kubernetes.

b.Пакетный менеджер Helm. Установка пакетного менеджера подробно описана на сайте документации Helm.

2.Установите Redis. Установка Redis с использованием Helm детально описана на сайте GitHub.

Пример команды для установки Redis:

helm install --namespace <namespace name> --set usePassword=false --set=slave.persistence.enabled=false --set master.persistence.enabled=false --set cluster.enabled=false --name <redis_deployment_name> stable/redis

3.Установите модуль Exchange Listener. Для установки модуля скачайте helm-пакет. Доступные параметры helm-пакета описаны в таблице ”Доступные параметры helm-пакета Exchange Listener”.

Важно

Для более новых версий Kubernetes укажите версию API, добавив параметр:

--set apiVersion=apps/v1

Пример команды для установки Exchange Listener с использованием адреса и относительного пути сервиса:

helm install --set env.host=<redis_host> --set ApiUrl=<kubernetes_url> --set ingress.path=<listener_path> --set apiVersion=apps/v1 --namespace <namespace name> --name exchangelistener </path/to/helm/exchangelistener.tgz>

Адрес сервиса Exchange Listener: <kubernetes_url>/<listener_path>.

Чтобы проверить доступность, сделайте запрос по адресу: <kubernetes_url>/<listener_path>/api/listeners/status (Рис. 1). 

Пример команды для установки Exchange Listener с использованием Node IP и адреса порта:

helm install --set env.host==<redis_host> --set service.type=<node_IP> --set service.nodePort=<node_port> --set apiVersion=apps/v1 --namespace <namespace name> --name exchangelistener </path/to/helm/exchangelistener.tgz>

Адрес сервиса Exchange Listener — <node_IP:node_port>.

Чтобы проверить доступность, сделайте запрос по адресу: <node_IP:node_port>/api/listeners/status (Рис. 1).

Рис. 1— Пример ответа сервиса Exchange Listener

chapter_exchange_listener_answer.png 

Доступные параметры helm-пакета Exchange Listener

Параметр

Описание параметра

Значение по умолчанию

replicaCount

Количество StatefulSet-обработчиков. Подробнее о количестве обработчиков и системных требованиях читайте в статье “Системные требования к серверам (on-site)”.

2

service.type

Тип сервиса. Детально типы сервисов Kubernetes описаны в  документации Kubernetes.

ClusterIP

service.nodePort

Если параметр service.type равен NodePort, то в этом параметре указывается внешний порт сервиса.

Детально тип NodePort описан в документации Kubernetes.

 

env.host

Адрес хоста Redis.

 

env.port

Порт хоста Redis.

6379

env.base

Номер базы данных Redis.

0

ingress.enabled

Использование переопределения адресов при помощи ingress.

true

ApiUrl

Адрес сервиса при ingress.enabled=true.

 

ingress.path

Относительный путь сервиса.

 

log4Net.level

Уровень логирования по умолчанию.

Info

Развертывание сервиса синхронизации в Docker

Для настройки сервиса необходим сервер (физический или виртуальный компьютер) с установленной ОС Linux или Windows.

Важно

Данный способ рекомендуется к установке только для dev-среды. Для продуктивных сред настоятельно рекомендуется установка с использованием оркестратора Kubernetes и пакетного менеджера Helm. Подробнее читайте в блоке “Развертывание сервиса синхронизации с использованием Kubernetes”.

Для развертывания сервиса выполните следующие шаги:

1.Предварительно настройте целевое окружение:

a.Платформа контейнеризации Docker. Подробно о том, как установить и настроить платформу, описано на сайте документации Docker.

b.СУБД Redis. Redis Server устанавливается при помощи установочного файла для ОС Windows или при помощи инструкции для ОС Linux.

2.Установите и запустите модуль Exchange Listener. Для этого необходимо скачать и развернуть образ Docker-контейнера.

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

# Проброс портов
docker run -p <localhost_port>:80
# Настройка сервера DNS, при необходимости можно указывать несколько адресов DNS
-d --dns=<dns_ip1> --dns=<dns_ip2> --dns-search=<dns_domain>
--env ExchangeListenerRedisHost=<redis_host>
--env ExchangeListenerRedisDatabase=<redis_database_number>
--env PodName=<service_name> --name <service_name>
# Актуальный образ ExchangeListener в Docker Hub
bpmonline/exchangelistener:
bpmonline/exchangelistener:0.5.0

В этом примере:

<localhost_port> — порт локального сервера;

<redis_host> — адрес redis-сервера;

<redis_database_number> — номер БД redis-сервера;

<service_name> — название сервиса (задается вручную).

Чтобы проверить доступность развернутого Docker-контейнера, выполните команду:

docker ps -a -–filter "name=<service_name>"

Адрес сервиса Exchange Listener — localhost:<localhost_port>.

Чтобы проверить доступность, сделайте запрос по адресу: <localhost:<localhost_port>/api/listeners/status (Рис. 1).

Смотрите далее

Настройка сервиса Exchange Listener на стороне Creatio

Был ли данный материал полезен?

Как можно улучшить эту статью?