Подключение агента к шлюзу

Чтобы подключить агент к шлюзу:

При необходимости подключитесь к пространству сателлита.
Если требуется TLS-соединение, создайте секрет.
Создайте и настройте шлюз.
Подключите агент к шлюзу.

Все агенты в системе должны быть подключены к кластеру либо с использованием протокола TLS, либо без него. В ситуациях, когда для одной части шлюзов настроено TLS-соединение, а для другой — нет, корректное подключение агентов к кластеру не гарантируется.
Если агент ранее уже был подключен к одной инсталляции системы (к одному менеджеру агентов), то для его подключения к другой инсталляции (к другому менеджеру) его необходимо удалить с хоста и установить и настроить заново.

Подключение к пространству сателлита

Для подключения агентов к системе используются шлюзы. Шлюзы могут располагаться как в основном экземпляре системы, так и в сателлитах.

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

Управление сателлитом осуществляется за счет запускаемых в нем сервисов через веб-интерфейс основного экземпляра системы. Чтобы подключиться к сателлиту, необходимо создать подключение к его пространству. Для этого:

Войдите в веб-интерфейс основного экземпляра системы.
Перейдите в раздел Настройки → Пространства и сервисы → Пространства.
Нажмите на кнопку Создать (). Отобразится окно создания подключения.
Введите идентификатор пространства сателлита в поле ID.
Введите название подключения. Название может быть любым.
В поле IP или домен введите IP-адрес или доменное имя (FQDN) одного из узлов кластера, в котором развернут сателлит.
В поле Порт введите номер TCP-порта, указанного при установке сателлита.
При необходимости введите описание подключения к пространству.
Нажмите на кнопку Создать. Система создаст подключение к пространству и отобразит соответствующее уведомление. Подключение отобразится в списке раздела Настройки → Пространства и сервисы → Пространства.

У созданного подключения отобразится статус Подключается. По завершении подключения статус изменится на Активен.

Время на инициализацию подключения зависит загруженности кластеров и каналов связи и может достигать 5—10 минут.

Создание секрета

Если между агентом и шлюзом требуется защищенное соединение, необходимо создать секрет с заранее подготовленным TLS-сертификатом.

Для этого создайте секрет со следующими параметрами:

Выберите тип Контейнер PKCS.
Задайте настройки секрета выбранного типа:
1. Загрузите файл сертификата и файл приватного ключа, подготовленные на этапе Добавление TLS-сертификата на агенте.
2. Оставьте поле Пароль для приватного ключа пустым.
  
  Система не поддерживает использование приватных ключей с паролем для TLS-соединения.

Создание и настройка шлюза

Чтобы настроить TLS-соединение со шлюзом:

Создайте шлюз. При создании задайте следующие параметры:
1. Выберите пространство, к которому необходимо подключиться:
  - Если необходимо настроить шлюз в сателлите, выберите пространство, созданное на шаге Подключение к пространству сателлита.
  - Если необходимо настроить шлюз в основном экземпляре системы, выберите Центральное пространство.
2. Укажите IP- или FQDN-адрес для подключения к шлюзу.
  
  Если требуется TLS-соединение, адрес шлюза должен совпадать с адресом, указанным в файле TLS-сертификата.
3. Укажите порт для подключения к шлюзу. Допустимые значения: 30000—32767.
  
  Порт должен быть уникальным в рамках инсталляции системы.
4. Если требуется TLS-соединение, установите переключатель Включить TLS в активное положение и выберите секрет, созданный на шаге Создание секрета.
5. Задайте прочие настройки шлюза в соответствии с вашими требованиями.
Запустите шлюз. Шлюз станет доступен для подключения агентов.

Подключение агента

Чтобы подключить агент к шлюзу:

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

Windows

macOS

rm -rf "<nats_path>"

Используйте командную оболочку PowerShell:

Remove-Item -Path "<nats_path>" -Recurse

rm -rf "<nats_path>"
Здесь:
- <nats_path> — путь к папке nats на хосте.

Настройте сетевой доступ к шлюзу по необходимому порту. Для этого задайте настройки подключения к шлюзу в параметре leafnodes в секции nats_server файла конфигурации rpoint.conf.

Особенности задания параметра leafnodes

Для каждого шлюза без TLS-соединения в поле url указывается URL-адрес в формате nats://<addr>:<port>.

Для каждого шлюза с TLS-соединением адрес указывается в формате tls://<addr>:<port>.

Здесь:

<addr> — адрес подключения к шлюзу.
<port> — порт подключения к шлюзу.

Например:

"leafnodes": {
  "remotes": [
    {
      "url": "tls://worker01.rpoint.local:32000"
    }
  ]
}

При необходимости вы можете пропустить данный шаг и указать настройки подключения к шлюзу на этапе запуска агента с помощью параметра --gateway-url.

Запустите агент.

Если настройка была выполнена корректно, агент появится в разделе Агенты → Агенты веб-интерфейса системы.

Была ли полезна эта страница?