Перейти к основному содержимому

Установка клиента Salt.Box

предупреждение

В дистрибутиве Salt.Box версии 0.0.1 используются компоненты SaltStack 3006.9 LTS.
Данный релиз SaltStack имеет долгосрочную поддержку.
Это означает, что релиз будет поддерживаться в течение более длительного времени, чем обычные версии.
Подразумевается, что в течение этого периода будут выходить обновления, включающие исправления безопасности и критические исправления ошибок, но не новые функции, которые могут нарушить совместимость.

Для обеспечения полной совместимости клиента Salt Minion используйте на управляемых устройствах клиент той же версии — 3006.9 LTS.

Установка в ОС Linux​

Установка пакета RPM​

  1. Для установки репозитория Salt Project выполните следующую команду:

    curl -fsSL https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.repo | sudo tee /etc/yum.repos.d/salt.repo
    примечание

    Из-за наличия в EPEL классических пакетов Salt возможна загрузка классических пакетов старых версий Salt вместо пакетов onedir.

    Во время разрешения зависимостей при выборе лучшего поставщика среди нескольких dnf учитывает приоритет репозитория каждого поставщика.
    Значение представляет собой целое число от 1 до 99, где 1 — наиболее предпочтительный репозиторий, а 99 — наименее предпочтительный.
    По умолчанию все репозитории имеют приоритет 80.

    EPEL рассматривал репозиторий Salt как 99. Чтобы решить эту проблему, Salt изменил свой уровень приоритета на 10 для RHEL 8 и 9.

  2. Чтобы очистить метаданные репозитория, выполните:

    sudo dnf clean expire-cache

  3. Установка пакета salt-minion:

    предупреждение

    STS-релизы не рекомендуются для продуктивной среды.
    Salt Project рекомендует развёртывать LTS-релизы в продуктивной среде.

    Установите пакет:

    sudo dnf install salt-minion

    Если вы хотите установить конкретный релиз salt-minion, укажите суффикс полной версии релиза Salt.
    Например:

    sudo dnf install salt-minion-3006.9

    Для закрепления версии пакета, когда необходимо исключить его обновление при выполнении dnf upgrade, может быть использована команда dnf versionlock.

    sudo dnf install 'dnf-command(versionlock)'
    sudo dnf versionlock add salt-minion

  4. Включите и запустите службу salt-minion:

    sudo systemctl enable salt-minion && sudo systemctl start salt-minion
    примечание

    При установке версии Salt onedir (3006 и более поздние) Salt устанавливает собственную локальную версию Python и зависимости, необходимые для основных функций Salt.

    После установки версии Salt onedir в Вашей системе будет присутствовать как глобальная версия Python на системном уровне, так и локальная версия Python, используемая Salt.
    Это изменение означает, что пути Salt onedir для Python отличаются, и Вам необходимо изменить способ установки сторонних зависимостей Python, которые Вы используете с Salt, включая ваши файлы состояния.
    Для получения дополнительной информации см. Установка зависимостей.

Установка пакета DEB​

  1. Для установки репозитория Salt Project выполните следующие команды:

    # Убедиться, что каталог keyrings существует
    mkdir -p /etc/apt/keyrings
    # Загрузить открытый ключ
    curl -fsSL https://packages.broadcom.com/artifactory/api/security/keypair/SaltProjectKey/public | sudo tee /etc/apt/keyrings/salt-archive-keyring.pgp
    # Создать целевую конфигурацию репозитория
    curl -fsSL https://github.com/saltstack/salt-install-guide/releases/latest/download/salt.sources | sudo tee /etc/apt/sources.list.d/salt.sources

  2. Для обновления метаданных выполните:

    sudo apt update

  3. Установка пакета salt-minion:

    предупреждение

    STS-релизы не рекомендуются для продуктивной среды.
    Salt Project рекомендует развёртывать LTS-релизы в продуктивной среде.

    Чтобы ограничить обновления мажорной версией Salt 3006 LTS, создайте файл /etc/apt/preferences.d/salt-pin-1001 с помощью следующей команды:

    echo 'Package: salt-*
    Pin: version 3006.*
    Pin-Priority: 1001' | sudo tee /etc/apt/preferences.d/salt-pin-1001

    Установите пакет:

    sudo apt-get install salt-minion

    Если вы хотите установить конкретную версию salt-minion, укажите суффикс полной версии релиза Salt.
    Например:

    sudo apt-get install salt-minion=3006.9
    предупреждение

    Конфликты зависимостей Salt

    Если Вы используете не последний релиз целевой мажорной версии, Вам может потребоваться установить другие пакеты salt в закрепленном виде.
    Например, чтобы установить salt-minion, потребуется установить salt-common той же версии:

    sudo apt-get install salt-minion=3006.9 salt-common=3006.9

  4. Включите и запустите службу salt-minion:

    sudo systemctl enable salt-minion && sudo systemctl start salt-minion
    примечание

    При установке версии Salt onedir (3006 и более поздние) Salt устанавливает собственную локальную версию Python и зависимости, необходимые для основных функций Salt.

    После установки версии Salt onedir в Вашей системе будет присутствовать как глобальная версия Python на системном уровне, так и локальная версия Python, используемая Salt.
    Это изменение означает, что пути Salt onedir для Python отличаются, и Вам необходимо изменить способ установки сторонних зависимостей Python, которые Вы используете с Salt, включая ваши файлы состояния.
    Для получения дополнительной информации см. Установка зависимостей.

Установка на Альт 10.4, 11.0:​

В ОС Альт 10.4 и ОС Альт 11.0 для обеспечения совместимости с компонентами SaltStack Master следует установить пакет salt-minion версии 3007.1.
В настоящее время в актуальных репозиториях платформ p10 и p11 размещены пакеты версии 3007.5; пакеты salt-minion версии 3007.1 и их зависимости доступны в архивах.

  1. Загрузите и установите пакет salt-minion версии 3007.1 и его зависимости.

    Для ОС Альт 10.4:

    wget https://ftp.altlinux.org/pub/distributions/archive/p10/date/2025/07/06/files/noarch/RPMS/salt-minion-3007.1-alt1.p10.1.noarch.rpm \
    https://ftp.altlinux.org/pub/distributions/archive/p10/date/2025/07/06/files/noarch/RPMS/python3-module-salt-3007.1-alt1.p10.1.noarch.rpm
    sudo rpm -Uvh --oldpackage ./salt-minion-3007.1-alt1.p10.1.noarch.rpm ./python3-module-salt-3007.1-alt1.p10.1.noarch.rpm

    или для ОС Альт 11.0:

    wget https://ftp.altlinux.org/pub/distributions/archive/p11/date/2025/06/18/files/noarch/RPMS/salt-minion-3007.1-alt2.noarch.rpm \
    https://ftp.altlinux.org/pub/distributions/archive/p11/date/2025/06/18/files/noarch/RPMS/python3-module-salt-3007.1-alt2.noarch.rpm
    sudo rpm -Uvh --oldpackage ./salt-minion-3007.1-alt2.noarch.rpm ./python3-module-salt-3007.1-alt2.noarch.rpm

  2. Включите и запустите службу salt-minion:

    sudo systemctl enable salt-minion && sudo systemctl start salt-minion

Установка на Astra Linux 1.7.7, 1.8.2:​

В операционных системах указанных версий будет установлен пакет salt-minion версии 3006.9 из официального репозитория.

sudo apt-get update
sudo apt-get install salt-minion

Настройка​

После установки salt-minion необходимо настроить его для связи с Master-сервером.
Для этого в файле /etc/salt/minion укажитеь адрес или имя хоста Salt Master:

master: <IP_ADDRESS> | <HOST>

После изменения файла конфигурации перезапустите службу salt-minion:

sudo systemctl restart salt-minion

Установка в ОС Windows​

Интерактивная установка​

  1. Загрузите файл установки клиента Salt Minion, соответствующий разрядности Вашей ОС,с сайта проекта Salt Project.

  2. Для установки клиента Salt.Box в интерактивном режиме запустите файл установки без указания параметров запуска.

  3. Нажмите Next > в стартовом окне инсталлятора Рис. 2.

    Стартовое окно инсталлятора службы salt-minion
    Рисунок 2. Стартовое окно инсталлятора службы salt-minion

  4. Нажмите I Agree в окне лицензионного соглашения Рис. 3.

    Окно лицензионного соглашения
    Рисунок 3. Окно лицензионного соглашения

  5. Укажите путь к папке инсталляции клиента Рис. 4.

    Окно выбора папки назначения
    Рисунок 4. Окно выбора папки назначения

  6. В окне установки параметров службы salt-minion в первом поле укажите выделенный IP-адрес сервера.
    Параметры Minion Name: hostname и Default config оставьте без изменений Рис. 5.
    Нажмите Install и дождитесь окончания установки клиента.

    Окно установки параметров службы salt-minion
    Рисунок 5. Окно установки параметров службы salt-minion

  7. Нажмите Finish в окне завершения установки Рис. 6.

    IОкно завершения установки
    Рисунок 6. Окно завершения установки

Установка с помощью групповых политик Microsoft Active Directory​

  1. В меню Пуск выберите пункт Administrative Tools -> Group Policy Management, либо выберите пункт Выполнить Рис. 7.

    Запуск оснастки управления групповой политикой
    Рисунок 7. Запуск оснастки управления групповой политикой

  2. В дереве объектов домена кликните правой кнопкой мыши на узле Объекты групповой политики, выберите пункт Создать Рис. 8.

    Создание объекта групповой политики
    Рисунок 8. Создание объекта групповой политики

  3. В диалоговом окне введите наименование нового объекта групповой политики и нажмите ОК.
    В данном примере объект групповой политики называется "Установка клиента" Рис. 9.

    Ввод наименования нового объекта групповой политики
    Рисунок 9. Ввод наименования нового объекта групповой политики

  4. В дереве объектов домена кликните правой кнопкой мыши на нужном организационном подразделении (OU) (в данном примере — "Тестовое подразделение"), выберите пункт Связать существующий объект групповой политики Рис. 10.

    Создание связи Organizational Unit с объектом групповой политики
    Рисунок 10. Создание связи Organizational Unit с объектом групповой политики

  5. В окне выбора объекта групповой политики выберите объект "Установка клиента".

    Выбор объекта групповой политики
    Рисунок 11. Выбор объекта групповой политики

  6. В списке объектов групповой политики домена кликните правой кнопкой мыши на объекте "Установка клиента", выберите пункт Изменить Рис. 12.

    Изменение объекта групповой политики
    Рисунок 12. Изменение объекта групповой политики

  7. В открывшемся окне редактора управления групповыми политиками в узле Конфигурация компьютера -> Конфигурация "Windows выберите пункт Сценарии Рис. 13.

  8. В окне со списком сценариев кликните правой кнопкой мыши на сценарии "Автозагрузка", выберите пункт Свойства Рис. 13.

    Изменение свойств сценария автозагрузки
    Рисунок 13. Изменение свойств сценария автозагрузки

  9. В открывшемся окне свойств сценария автозагрузки на вкладке Сценарии нажмите кнопку Показать файлы Рис. 14.

    Свойства сценария автозагрузки
    Рисунок 14. Свойства сценария автозагрузки

  10. В папку сценария автозагрузки, открывшуюся в проводнике Windows, скопируйте файл install.bat и .exe-файлы инсталляторов для ОС Windows 32- и 64-разрядной архитектуры Рис. 15.

    Копирование файлов в папку сценария автозагрузки
    Рисунок 15. Копирование файлов в папку сценария автозагрузки

  11. Закройте проводник и нажмите кнопку Добавить на вкладке Сценарии окна свойств сценария автозагрузки Рис. 14.

  12. Укажите имя install.bat и значение параметра — выделенный IP-адрес сервера — и нажмите ОК Рис. 16.

    Ввод параметров сценария автозагрузки
    Рисунок 16. Ввод параметров сценария автозагрузки

Переподключение миньона к другому Master-серверу​

предупреждение

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

В примере, приведённом ниже, показан вывод Windows-миньона в случае ошибки аутентификации.

2025-07-30 12:55:02,495 [salt.crypt       :1285][ERROR   ][5384] The master key has changed, the salt master could have been subverted, verify salt master's public key
2025-07-30 12:55:02,510 [salt.crypt       :903 ][CRITICAL][5384] The Salt Master server's public key did not authenticate!
The master may need to be updated if it is a version of Salt lower than 3006.10, or
If you are confident that you are connecting to a valid Salt Master, then remove the master public key and restart the Salt Minion.
The master public key can be found at:
C:\ProgramData\Salt Project\Salt\conf\pki\minion\minion_master.pub

Для решения проблемы выполните следующие действия:

На Windows-миньоне:
  1. Остановите службу salt-minion: 
    net stop salt-minion
  2. Удалите файл с публичным ключом Master-сервера: 
    del C:\ProgramData\SaltProject\conf\pki\minion_master.pub
  3. Запустите службу salt-minion: 
    net start salt-minion
На Linux-миньоне:
  1. Остановите службу salt-minion: 
    sudo systemctl stop salt-minion
  2. Удалите файл с публичным ключом Master-сервера: 
    rm -v /etc/salt/pki/minion/minion_master.pub
  3. Запустите службу salt-minion: 
    sudo systemctl start salt-minion

Убедитесь, что миньон теперь может выполнять команды от мастера.
Это можно сделать, выполнив команду вида salt-call test.version.

Подробное описание процедуры взаимной аутентификации сервера и миньона смотрите в разделе:
Безопасность / Шифрование клиент-серверных соединений.