Документация: ПО Факел — разрабатываемая версия

Агент Salt

Обзор

Агент Salt (раздел service salt-minion) подключает маршрутизатор с ПО Факел к серверу централизованного управления Salt (master). Сервер Salt передает управляемым узлам задания и конфигурацию, а агент на маршрутизаторе их получает.

Для работы агента задайте сервер Salt командой master — имя узла или IP-адрес; можно задать несколько серверов. Маршрутизатор подключается к серверу под идентификатором id; если идентификатор не задан, используется имя узла маршрутизатора. Команда interval задает интервал в минутах, с которым агент обновляет данные Salt Mine — сведения об узле, которые агент передает серверу Salt (по умолчанию 60), команда source-interface — интерфейс, через который устанавливается соединение с сервером. Если интерфейса нет, проверка конфигурации завершается ошибкой.

Команда hash задает алгоритм хеширования, который используется при поиске файлов на сервере Salt (по умолчанию sha256). Для алгоритма sha1 при проверке конфигурации выводится предупреждение с рекомендацией перейти на sha256 или более стойкий алгоритм.

Команда master-key задает URL, по которому агент загружает подпись сервера Salt для проверки ответов при аутентификации. Подпись загружается при применении конфигурации, если она еще не сохранена на маршрутизаторе; для загрузки маршрутизатору нужен доступ к этому URL.

В текущей версии ПО Факел если агент еще ни разу не запускался, применение изменений с master-key завершается ошибкой (см. Ограничения).

Список команд

Режим «Конфигурирование»


service salt-minion hash <hash>

Описание:
Задает алгоритм хеширования, который используется при поиске файлов на сервере Salt.
Для алгоритма sha1 при проверке конфигурации выводится предупреждение с рекомендацией перейти на sha256 или более стойкий алгоритм.

Синтаксис:

  • set service salt-minion hash <hash>

  • delete service salt-minion hash <hash>

  • show service salt-minion hash

Аргументы:

  • <hash> — алгоритм хеширования. Возможные значения: md5, sha1, sha224, sha256, sha384, sha512. Значение по умолчанию: sha256.

Режим: «Конфигурирование».

service salt-minion id <id>

Описание:
Задает идентификатор, под которым маршрутизатор подключается к серверу Salt. Если параметр не задан, используется имя узла.

Синтаксис:

  • set service salt-minion id <id>

  • delete service salt-minion id <id>

  • show service salt-minion id

Аргументы:

  • <id> — идентификатор. Формат: строка.

Режим: «Конфигурирование».

service salt-minion interval <interval>

Описание:
Задает интервал в минутах, с которым агент обновляет данные Salt Mine — сведения об узле, которые агент передает серверу Salt.

Синтаксис:

  • set service salt-minion interval <interval>

  • delete service salt-minion interval <interval>

  • show service salt-minion interval

Аргументы:

  • <interval> — интервал в минутах. Формат: целое число. Диапазон значений: от 1 до 1440. Значение по умолчанию: 60.

Режим: «Конфигурирование».

service salt-minion master <master>

Описание:
Задает имя узла или IP-адрес сервера Salt (master). Агент подключается к серверу по TCP на порт 4506.

Синтаксис:

  • set service salt-minion master <master>

  • delete service salt-minion master <master>

  • show service salt-minion master

Аргументы:

  • <master> — адрес сервера Salt. Формат: IPv4-адрес (x.x.x.x), IPv6-адрес (h:h:h:h:h:h:h:h) или полное доменное имя. Можно задать несколько значений.

Режим: «Конфигурирование».

service salt-minion master-key <master-key>

Описание:
Задает URL с подписью сервера Salt для проверки ответов при аутентификации.

Синтаксис:

  • set service salt-minion master-key <master-key>

  • delete service salt-minion master-key <master-key>

  • show service salt-minion master-key

Аргументы:

  • <master-key> — URL. Формат: строка.

Режим: «Конфигурирование».

service salt-minion source-interface <source-interface>

Описание:
Задает интерфейс, через который устанавливается соединение с сервером Salt.

Синтаксис:

  • set service salt-minion source-interface <source-interface>

  • delete service salt-minion source-interface <source-interface>

  • show service salt-minion source-interface

Аргументы:

  • <source-interface> — имя интерфейса. Формат: строка.

Режим: «Конфигурирование».