В рабочей области Подключаемые модули Master можно обновить подключаемый модуль Master, установленный на главном сервере Salt, чтобы его версия соответствовала версии SaltStack Config. Этот компонент поддерживается как в облачных, так и в локальных развертываниях. Кроме того, здесь можно загрузить последнюю версию подключаемого модуля Master.

В рабочей области Подключаемые модули Master содержатся сведения о состоянии подключаемого модуля, его версии, версии Salt, последнем обновлении JID и т. п. Последняя версия sseapiclient также доступна в рабочей области Подключаемые модули Master. Дополнительные сведения см. в разделе Использование API-интерфейса.

Подключаемый модуль Master позволяет главным серверам Salt обмениваться данными с SaltStack Config. Подключаемый модуль также содержит различные параметры, которые можно настраивать для повышения производительности. Дополнительные сведения см. в документе Параметры конфигурации подключаемого модуля Master.

RaaS хранит текущую и предыдущую версии подключаемого модуля Master. При подключении к RaaS главный сервер Salt проверяет, есть ли в RaaS версии подключаемого модуля, которых нет у него. Если в RaaS имеются такие версии, главный сервер Salt извлекает эти подключаемые модули из RaaS и кэширует их локально в /var/cache/salt/master/plugin_cache/.

При наличии новой версии SaltStack Config подключаемый модуль не обновляется автоматически. Процесс обновления необходимо инициировать вручную. Рекомендуется всегда обновлять подключаемый модуль, когда появляется новая версия.

Чтобы главный сервер Salt перезапускался после обновления подключаемого модуля, в процессе обновления подключаемого модуля Master используется модуль Salt service и состояние service.running. Модуль service зависит от init-диспетчера дистрибутива, такого как systemd.

Примечание:

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

Перед началом работы

Чтобы использовать рабочую область Подключаемые модули Master, необходимо выполнить следующие предварительные требования.

  • Установите подключаемый модуль Master на главный сервер Salt. Дополнительные сведения см. в разделе Установка и настройка подключаемого модуля Master.
  • Убедитесь, что ключ главного сервера Salt был принят в пользовательском интерфейсе SaltStack Config.
  • Убедитесь, что главный сервер Salt запущен от имени пользователя root. Если главный сервер Salt запущен не от имени пользователя root, обновление завершится сбоем.
  • Убедитесь, что на главном сервере Salt запущен Salt версии 3002.1 или более поздней. Если на главном сервере Salt установлена версия 3002 или более ранняя, для использования рабочей области Подключаемые модули Master потребуется обновить версию Salt. Дополнительные сведения см. в разделе Обновление Salt.
  • Убедитесь, что на главном сервере Salt запущен подключаемый модуль Master версии 8.11.2 или более поздней. Если на главном сервере Salt установлена версия 8.11.1 или более ранняя, для использования рабочей области Подключаемые модули Master потребуется вручную обновить подключаемый модуль. Дополнительные сведения см. в разделе Обновление подключаемого модуля Master через интерфейс командной строки.

Обновление подключаемого модуля Master

Версию подключаемого модуля Master можно обновить на одном или нескольких главных серверах Salt.

Примечание:

Версию подключаемого модуля Master можно обновить в рабочей области Подключаемые модули Master, только если он имеет состояние Требуется обновление. Если в состоянии подключаемого модуля указано, что на главном сервере Salt требуется вмешательство пользователя, войдите в учетную запись на главном сервере Salt, чтобы устранить проблему. Дополнительные сведения см. в Устранение неполадок при обновлении подключаемого модуля.

Чтобы обновить подключаемый модуль Master, выполните следующие действия.

  1. В SaltStack Config выберите Администрирование > Подключаемые модули Master.
  2. Выберите главный сервер Salt с состоянием подключаемого модуля Требуется обновление.
  3. Щелкните Обновить.
  4. Просмотрите сведения в диалоговом окне и убедитесь, что главный сервер Salt выбран правильно.
  5. Щелкните Обновить.
  6. Чтобы отслеживать ход обновления, щелкните Последнее обновление JID.
  7. Убедитесь, что в рабочей области Подключаемые модули Master состояние подключаемого модуля изменилось на Обновлено.

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

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

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

Обновление подключаемого модуля может завершиться сбоем по следующим причинам.
  • Проблемы с инфраструктурой
  • Проблемы с настройками виртуальных машин
  • Проблемы с подключением к главному серверу Salt

Чтобы определить причину сбоя обновления, выполните следующие действия.

  1. Проверьте Последнее обновление JID и просмотрите необработанные данные на наличие ошибок.
  2. Чтобы проверить состояние службы salt-master, выполните команду systemctl status salt-master.
  3. Чтобы запустить главный сервер Salt в режиме отладки, выполните команду salt-master -l debug.
  4. Загрузите подключаемый модуль Master из рабочей области Подключаемые модули Master и установите его вручную.