Координатор маршрутизации сообщений

Общие сведения о координаторе маршрутизации сообщений

Координатор маршрутизации сообщений отвечает за маршрутизацию сообщений в разные очереди. Координатор маршрутизации сообщений назначается в настройках клиента RabbitMQ для Шлюза Termidesk Connect. Настройка клиента RabbitMQ позволяет регистрировать Шлюз на одной Ферме или Агрегаторе Termidesk (Termidesk VDI).

Настройка клиента RabbitMQ выполняется одним из способов:

Настройка клиента RabbitMQ осуществляется через объект gw (см. подраздел Объект gw).

Настройка клиента RabbitMQ из CLI

Для настройки клиента RabbitMQ используются команды:

  • указание URL-адреса для подключения к серверу RabbitMQ:

set gw rabbitmq url <URL-адрес>

  • указание имени пользователя для подключения к серверу RabbitMQ:

set gw rabbitmq user <имя>

Так же имя пользователя может быть получено из Хранилища секретов. Пример значения параметра:

  • kv://secret/rabbit#username – для kv версии 1;

  • kv://secret/data/rabbit#username – для kv версии 2.

  • указание пароля пользователя для подключения к серверу RabbitMQ:

set gw rabbitmq pass <пароль>

Так же пароль пользователя может быть получен из Хранилища секретов. Пример значения параметра:

  • kv://secret/rabbit#password – для kv версии 1;

  • kv://secret/data/rabbit#password – для kv версии 2.

  • указание существующего IP-Фонда для взаимодействия с RabbitMQ:

set gw rabbitmq ipset-id <IP-Фонд>

  • указание времени (в секундах) ожидания ответа от сервера RabbitMQ (значение от 1 до 60, по умолчанию – 10):

set gw rabbitmq timeout <время>

  • указание интервала (в секундах) обновления регистрационной информации (URL и другие данные) Шлюза (значение от 10 до 100000, по умолчанию – 60):

set gw rabbitmq refreshtime <интервал>

  • указание существующего Клиентского SSL-Профиля (по умолчанию – backend-default):

set gw rabbitmq ssl-profile-id <SSL-Профиль>

  • указание координатора маршрутизации сообщений, определенного в RabbitMQ:

set gw rabbitmq exchange <координатор>

  • указание ключа маршрутизации RabbitMQ, используемого для маршрутизации задачи в очереди:

set gw rabbitmq routingkey <ключ_маршрутизации>

  • указание способа передачи данных (по умолчанию – false):

set gw rabbitmq single <false/true>

Возможные значения:

  • true – передача данных до первого подтверждения;

  • false – передача данных по циклу (бесконечно).

  • применение заданных настроек:

commit

  • сохранение настроек:

write

Настройка клиента RabbitMQ из WUI

Для отображения настроек клиента RabbitMQ следует перейти «Настройки – Termidesk Шлюз – Координатор».

Для настройки клиента RabbitMQ следует активировать «Координатор» и заполнить данные, перечисленные в столбце «Параметр» следующей таблицы (см. таблицу Основные параметры настройки клиента RabbitMQ).

Таблица 1. Основные параметры настройки клиента RabbitMQ
Параметр Описание

«URL»

URL-адрес для подключения к серверу RabbitMQ

«Пользователь»

Имя пользователя для подключения к серверу RabbitMQ.

Так же имя пользователя может быть получено из Хранилища секретов. Пример значения параметра:

  • «kv://secret/rabbit#username» – для kv версии 1;

  • «kv://secret/data/rabbit#username» – для kv версии 2

«Пароль»

Пароль пользователя для подключения к серверу RabbitMQ.

Так же пароль пользователя может быть получен из Хранилища секретов. Пример значения параметра:

  • «kv://secret/rabbit#password» – для kv версии 1;

  • «kv://secret/data/rabbit#password» – для kv версии 2

«Фонд IP»

Выбор IP-Фонда для взаимодействия с RabbitMQ

«Timeout»

Время (в секундах) ожидания ответа от сервера RabbitMQ.

Возможные значения: от 1 до 60.

Значение по умолчанию: «10»

«Интервал ожидания»

Интервал (в секундах) обновления регистрационной информации (URL и другие данные) Шлюза.

Возможные значения: от 10 до 100000.

Значение по умолчанию: «60»

«TLS Профиль»

Выбор Клиентского SSL-Профиля

«Exchange»

Координатор маршрутизации сообщений, определенный в RabbitMQ. Отвечает за маршрутизацию сообщений в разные очереди

«Ключ»

Ключ маршрутизации RabbitMQ, используемый для маршрутизации задачи в очереди

Значение по умолчанию: «termidesk_appnode»

«Single»

Настройка способа передачи данных.

При активации параметра данные будут передаваться до первого подтверждения, при отключении параметра данные будут передаваться по циклу (бесконечно)

Для применения параметров следует нажать экранную кнопку [Применить].

Объект gw

Доступные команды объекта gw приведены в таблице (см. таблицу Доступные команды объекта gw).

Таблица 2. Доступные команды объекта gw
Команда Описание

Создание Шлюза

set gw server <имя>

Имя Шлюза

Настройка Шлюза

set gw server <имя> checktoken <значение>

Настройка взаимодействия с компонентом «Универсальный диспетчер» Termidesk.

Для параметра checktoken могут быть указаны следующие параметры:

  • ipset-id – IP-Фонд, используемый для взаимодействия с компонентом «Универсальный диспетчер» Termidesk;

  • ssl-profile-id – Клиентский SSL-Профиль (по умолчанию – backend-default);

  • url – URL, поддерживаемый компонентом «Универсальный диспетчер» Termidesk с ролью «Портал пользователя» для обслуживания API-запросов по валидации подключений, запрашиваемых через Шлюз

    Следует использовать актуальные значения версий API для соответствующей версии компонента «Универсальный диспетчер» Termidesk.

set gw server <имя> description <значение>

Комментарий для сервера

set gw server <имя> rabbitmq <значение>

Настройка клиента RabbitMQ.

Для параметра rabbitmq могут быть указаны следующие параметры:

  • exchange – координатор маршрутизации сообщений, определенный в RabbitMQ. Отвечает за маршрутизацию сообщений в разные очереди;

  • ipset-id – IP-Фонд для взаимодействия с RabbitMQ;

  • pass – пароль пользователя для подключения к серверу RabbitMQ;

  • refreshtime – интервал (в секундах) обновления регистрационной информации (URL и другие данные) Шлюза (значение от 10 до 100000, по умолчанию – 60);

  • routingkey – ключ маршрутизации RabbitMQ, используемый для маршрутизации задачи в очереди (по умолчанию – termidesk_appnode);

  • single – способ передачи данных (по умолчанию – false). Возможные значения:

    • true – передача данных до первого подтверждения;

    • false – передача данных по циклу (бесконечно);

  • ssl-profile-id – Клиентский SSL-Профиль (по умолчанию – backend-default);

  • timeout – время (в секундах) ожидания ответа от сервера RabbitMQ (значение от 1 до 60, по умолчанию – 10);

  • url – URL-адрес для подключения к серверу RabbitMQ;

  • user – имя пользователя для подключения к серверу RabbitMQ

set gw server <имя> ssl-profile-id <значение>

Серверный SSL-Профиль

set gw server <имя> tcp-downstream <значение>

Настройка переподключения Шлюза к рабочим местам Termidesk.

Для параметра tcp-downstream могут быть указаны следующие параметры:

  • ipset-id – IP-Фонд для взаимодействия с рабочим местом Termidesk;

  • reconnect – количество разрешенных переподключений сессии пользователя (значение от 0 до 10, по умолчанию – 0);

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

    • для RDP нужно использовать ненулевое значение, поскольку некоторые функции (например, перенаправление USB в гостевую ОС рабочего места по протоколу RDP) могут требовать переподключения;

    • для TERA и SPICE нужно использовать значение по умолчанию (0).

  • ssl-profile-id – Клиентский SSL-Профиль (по умолчанию – backend-default)

set gw server <имя> tera-udp <значение>

Настройка поддержки протокола UDP для протокола TERA на Шлюзе.

Для параметра tera-udp могут быть указаны следующие параметры:

  • src ip – IP-адрес источника, т.е. адрес, с которого Шлюз устанавливает UDP-соединение с рабочим местом Termidesk;

    Для параметра src ip значение 0.0.0.0 указывает на использование всех IP-адресов.

  • src port – порт источника (по умолчанию – 0);

  • src vrf – VRF источника (по умолчанию – default);

  • vip ip – IP-адрес Виртуального Сервера для TERA;

    Параметр vip ip может принимать любое значение, т.е. IP-адрес может отличаться от IP-адреса Шлюза или может быть таким же. Указывается IP-адрес именно Виртуального Сервера, если Шлюз скрывается за Виртуальным Сервером.

  • vip port – порт Виртуального Сервера для TERA (по умолчанию – 443);

  • vrf – VRF для TERA (по умолчанию – default)

set gw server <имя> vip <значение>

Настройка Виртуального Сервера.

Для параметра vip могут быть указаны следующие параметры:

  • ip – IP-адрес Виртуального Сервера;

  • port – порт Виртуального Сервера

set gw server <имя> vrf <значение>

Имя VRF (по умолчанию – default)

set gw server <имя> websocket <значение>

Настройка подключения к компоненту «Клиент» Termidesk.

Для параметра websocket могут быть указаны следующие параметры:

  • pingtimeout – время ожидания (в секундах) соединения (значение от 0 до 100000, по умолчанию – 30)

Настройка клиента RabbitMQ

set gw rabbitmq exchange <значение>

Координатор маршрутизации сообщений, определенный в RabbitMQ. Отвечает за маршрутизацию сообщений в разные очереди

set gw rabbitmq ipset-id <значение>

IP-Фонд для взаимодействия с RabbitMQ

set gw rabbitmq pass <значение>

Пароль пользователя для подключения к серверу RabbitMQ.

Так же пароль пользователя может быть получен из Хранилища секретов

set gw rabbitmq refreshtime <значение>

Интервал (в секундах) обновления регистрационной информации (URL и другие данные) Шлюза (значение от 10 до 100000, по умолчанию – 60)

set gw rabbitmq routingkey <значение>

Ключ маршрутизации RabbitMQ, используемый для маршрутизации задачи в очереди (по умолчанию – termidesk_appnode)

set gw rabbitmq single <значение>

Способ передачи данных (по умолчанию – false).

Возможные значения:

  • true – передача данных до первого подтверждения;

  • false – передача данных по циклу (бесконечно)

set gw rabbitmq ssl-profile-id <значение>

Клиентский SSL-Профиль (по умолчанию – backend-default)

set gw rabbitmq timeout <значение>

Время (в секундах) ожидания ответа от сервера RabbitMQ (значение от 1 до 60, по умолчанию – 10)

set gw rabbitmq url <значение>

URL-адрес для подключения к серверу RabbitMQ

set gw rabbitmq user <значение>

Имя пользователя для подключения к серверу RabbitMQ.

Так же имя пользователя может быть получено из Хранилища секретов

Настройка управляющего сервера Шлюза

set gw mgt listen <значение>

Настройка прослушивания входящих подключений.

Для параметра listen могут быть указаны следующие параметры:

  • ip – IP-адрес прослушивания входящих подключений;

  • port – порт прослушивания входящих подключений

set gw mgt metrics <значение>

Настройка получения метрик Шлюза.

Для параметра metrics могут быть указаны следующие параметры:

  • path – путь для получения метрик Шлюза (по умолчанию – /api/health/metrics);

  • token – токен доступа для получения метрик Шлюза (так же токен может быть получен из Хранилища секретов)

    Для интеграции с Termidesk значение может быть получено из параметра METRICS_ACCESS_KEY, определенного в конфигурационном файле /etc/opt/termidesk-vdi/termidesk.conf узла компонента «Универсальный диспетчер» Termidesk.

set gw mgt path <значение>

Путь для получения статистики Шлюза (по умолчанию – /api/health)

set gw mgt ssl-profile-id <значение>

Серверный SSL-Профиль

set gw mgt token <значение>

Токен доступа для получения статистики Шлюза.

Для интеграции с Termidesk значение может быть получено из параметра HEALTH_CHECK_ACCESS_KEY, определенного в конфигурационном файле /etc/opt/termidesk-vdi/termidesk.conf узла компонента «Универсальный диспетчер» Termidesk.

Так же токен может быть получен из Хранилища секретов