Тип конфигурации «Установка агента»

Работа с конфигурациями типа «Установка агента» включает операции по созданию, редактированию и удалению конфигураций и их версий.

Создание конфигурации

Для создания конфигурации с типом «Установка агента»:

  1. На боковой панели главной страницы выберите Конфигурации.

  2. Нажмите на кнопку Создать конфигурацию и в выпадающем списке выберите Установка агента:

    configuration agent create menu
  3. На странице создания конфигурации заполните поля:

    • Название (обязательное поле) — имя конфигурации установки агента;

    • Описание — краткое описание конфигурации;

    • Теги для поиска — теги конфигураций;

      Выберите теги из списка доступных или создайте новые.
      Для создания нового тега:

      1. Введите наименование для нового тега. Например — «браузер».

      2. В выпадающем окне нажмите на Добавить «браузер».

    • Расположение — выберите в дереве папку, в которой должна располагаться конфигурация; при необходимости воспользуйтесь поиском — наберите не менее трех символов, содержащихся в наименовании искомой папки, в поле ввода.

  4. Нажмите на кнопку Создать.

Пример заполнения полей:

configuration agent create

Отображается страница с информацией о созданной конфигурации:

configuration agent view details

Далее необходимо добавить версию конфигурации и задать требуемые параметры.

Редактирование конфигурации

Для редактирования конфигурации установки агента:

  1. Выберите конфигурацию с типом «Установка агента».

  2. Нажмите правой кнопкой мыши на записи и выберите Редактировать или на панели быстрого просмотра в списке действий нажмите на Редактировать:

    configuration actions edit
  3. На странице редактирования внесите изменения в значения полей. При необходимости измените расположение конфигурации, выбрав папку в иерархии.

  4. Нажмите на кнопку Сохранить.

Удаление конфигурации

Для удаления конфигурации установки агента:

  1. Выберите конфигурацию с типом «Установка агента».

  2. Нажмите правой кнопкой мыши на записи и выберите Удалить или на панели быстрого просмотра в списке действий нажмите на Удалить:

    configuration actions delete
  3. Подтвердите удаление, нажав на кнопку Удалить.

Добавление версии конфигурации

Для добавления версии конфигурации установки агента:

  1. Выберите конфигурацию с типом «Установка агента».

  2. Дважды щелкните на записи, нажмите правой кнопкой мыши на записи и выберите Открыть или на панели быстрого просмотра в списке действий нажмите на Открыть:

    configuration actions open
  3. На странице с информацией о конфигурации в разделе Версии нажмите на + Добавить версию:

    configuration simple add version link
  4. На странице добавления версии конфигурации заполните поля:

    • Версия (обязательное поле) — версия конфигурации;

      Номер версии должен соответствовать желаемой версии SaltStack (рекомендуется 3006.7.4).

    • Скрипт (обязательное поле) — скрипт установки агента на устройство;

      В выпадающем списке администратор может выбрать как стандартный скрипт (входит в поставку продукта), так и создать новый скрипт.

    • Дата релиза (обязательное поле) — планируемая дата релиза добавляемой версии;

    • Особенности установки — описание особенностей установки версии;

    • флажок Актуальная версия — сделать версию актуальной (версией по умолчанию);

    • Импортировать конфигурацию — импортирование пользовательских конфигурационных параметров из файла в формате YAML.

      Файл в формате YAML должен содержать:

      • координаторы агента — список серверов управления (master), доступных агенту;

      • конфигурацию агента (подробнее см. в разделе «Конфигурация агента (minion)»).

      Пример файла:

      master:
      - master-1
      - master-2
      
      master_type: failover
      random_master: True
      master_alive_interval: 30
      master_failback: True
      master_failback_interval: 30
      verify_master_pubkey_sign: somekey
  5. Нажмите на кнопку Добавить.

Пример заполнения полей:

configuration agent add version

Версия конфигурации создана:

configuration agent version added

Редактирование версии конфигурации

Для редактирования версии конфигурации установки агента:

  1. Выберите конфигурацию с типом «Установка агента».

  2. Дважды щелкните на записи, нажмите правой кнопкой мыши на записи и выберите Открыть или на панели быстрого просмотра в списке действий нажмите на Открыть:

    configuration actions open
  3. В строке версии конфигурации нажмите на 3t vert и в выпадающем меню выберите Редактировать:

    configuration agent version actions menu edit
  4. Внесите изменения и нажмите на кнопку Сохранить.

Изменение актуальной версии конфигурации

Чтобы присвоить одной из версий конфигурации статус Актуальная версия (версия по умолчанию), выполните одно из следующих действий:

  • установите флажок Актуальная версия:

    • на странице создания версии;

    • на странице редактирования версии;

  • в строке версии конфигурации нажмите на 3t vert и выберите Сделать актуальной:

    configuration agent version actions menu make default

Удаление версии конфигурации

Для удаления версии конфигурации установки агента:

  1. Выберите конфигурацию с типом «Установка агента».

  2. Дважды щелкните на записи, нажмите правой кнопкой мыши на записи и выберите Открыть или на панели быстрого просмотра в списке действий нажмите на Открыть:

    configuration actions open
  3. В строке версии конфигурации нажмите на 3t vert и в выпадающем меню выберите Удалить:

    configuration agent version actions menu delete
  4. Подтвердите удаление, нажав на кнопку Удалить.

Перед удалением выполнятся проверка:

  • если версия конфигурации не применяется к коллекции, она удаляется; отображается сообщение об успешном удалении;

  • если версия конфигурации применяется к коллекции, отображается информационное сообщение, указывающее на причину невозможности удаления и требуемое действие.

Добавление скрипта

Для добавления нового скрипта:

  1. При добавлении новой версии конфигурации с типом «Установка агента» в поле Скрипт в выпадающем списке выберите Добавить новый скрипт:

    conf ag7
  2. На странице добавления скрипта заполните поля:

    conf ag8
    • Название (обязательное поле) — имя скрипта;

    • Описание — краткое описание скрипта;

    • Файл (обязательное поле) — файл скрипта.

  3. Нажмите на кнопку Добавить.