Задачи и политики
Задача — это сценарий, управляющий применением состояния (SLS) на одном или нескольких клиентах.
Для создания задач в SALT.BOX используются шаблоны конфигураций.
Подробную информацию о подключении источников, управлении содержимым и создании шаблонов см. раздел онлайн-документации: Шаблоны конфигураций
Политика — режим выполнения задачи, предназначенный не для немедленного выполнения действий, а для задания правил и ограничений, в рамках созданных и запущенных задач.
При создании политики:
- Задача описывается как правило (политика), а не как разовое действие;
- Пользователь не выбирает конкретных клиентов напрямую, а работает с разрешёнными коллекциями.
Создание задачи
В процессе создания задачи пользователь SALT.BOX выполняет следующие шаги:
- Выбирает адресатов задачи.
- Выбирает шаблон задачи и вводит общие параметры задачи.
- Вводит параметры, определённые в шаблоне задачи.
- Просматривает параметры на вкладке Обзор и подтверждает создание задачи.
- Запускает и контролирует выполнение задачи со страницы Карточка задачи.
Выбор адресатов задачи
Создание задач в SALT.BOX осуществляется со страницы клиентов (переход на эту страницу осуществляется через пункт Клиенты в главном меню).
В SALT.BOX действует алгоритм, по которому при создании задачи определяются целевые клиенты (т.е. клиенты, на которых будет выполняться задача):
-
Все клиенты текущей активной (выбранной пользователем из числа доступных ему) коллекции
(этот вариант применяется по умолчанию).
-
Все клиенты, отобранные фильтром, применённым к исходной коллекции.
-
клиенты, выбранные пользователем из результата применения фильтра к исходной коллекции.
На Рис. 1 показан пример, в котором пользователем из коллекции root collection выбрана группа клиентов (отмечены пользователем флажками).
 |
|---|
Нажмите кнопку Создать задачу Рис. 1.
Выбор шаблона и ввод общих параметров задачи
В открывшемся диалоговом окне Выберите шаблон задачи (которое позволяет найти и выбрать необходимый сценарий автоматизации) Рис. 2 из блоков с раскрывающимися списками выберите нужный шаблон (например Установка и удаление программного обеспечения) Рис. 2 [1].
 |
|---|
Если список шаблонов пуст, синхронизируйте шаблоны, как указано в разделе Шаблоны конфигураций.
Для быстрого перехода на страницу Шаблоны конфигураций предусмотрена кнопка Шаблоны конфигураций Рис. 2 [2].
В результате откроется диалоговое окно Настройка задачи Рис. 3.
Ввод параметров, определённых в шаблоне задачи
Состав параметров, определённых в шаблоне, зависит от соответствующего ему файла SLS.
На Рис. 3 показан пример набора параметров, определённых в выбранном пользователем шаблоне Установка и удаление программного обеспечения (Base - Software - Packages).
На вкладке Настройки в поле Package введите название пакета, который хранится на сервере или в репозиториях ОС клиентов Рис. 3.
Если необходимо обновить уже установленный пакет на ОС клиента (клиентов) в поле Update the package repository database (optional) следует выбрать параметр True (по умолчанию указано False).
Если необходимо сохранить текущие параметры и значения по умолчанию для шаблона, выберите соответствующий чек-бокс Рис. 3.
 |
|---|
В поле аргументов вводится только название пакета. Например: Package: htop Рис. 3.
Обязательные поля отмечены знаком *
При массовом использовании задач есть функция Расширенные настройки, которая позволяет распределять нагрузку при выполнении множества задач на определённом промежутке времени.
Для этого на вкладке Настройки необходимо активировать кнопку Расширенные настройки Рис. 4 [1].
В таблице 1 приведено описание общих параметров задачи.
 |
|---|
Таблица 1. Перечень общих параметров задачи
| Параметр | Описание |
|---|---|
| Размер пакета | Размер «окна» выполнения (максимальное количество одновременно выполняемых задач). Значение 0 — без ограничений |
| Параллельные задачи | Максимальное количество одновременно выполняемых задач |
| Максимум попыток | Количество попыток выполнения задачи в случае неудачного завершения |
| Задержка повтора (с) | Задержка в секундах перед повторной попыткой |
Нажать кнопку Далее к обзору Рис. 4 [2].
В результате в диалоговом окне Настройка задачи откроется вкладка Обзор Рис. 5.
 |
|---|
Вкладка Обзор Рис. 5 предназначена для предварительного просмотра и проверки параметров задачи перед её запуском.
Вкладка Обзор позволяет пользователю:
- увидеть сводную информацию по создаваемой задаче;
- проверить корректность выбранных параметров;
- убедиться, что задача будет выполнена на указанных клиентах и с заданными настройками;
- избежать ошибок перед запуском задачи.
Подтверждение создания задачи
После ввода параметров нажмите кнопку Создать задачу Рис. 5.
Будет создана задача, откроется страница карточки задачи Рис. 6.
Первоначальный статус новой задачи — “created” (Создана).
В случае, если запускаемая задача применяется к большому множеству клиентов (например, к большой коллекции), будет выведено окно уведомления для подтверждения запуска задачи.
Карточка задачи
 |
|---|
Карточка задачи состоит из следующих основных блоков и элементов интерфейса:
-
блок с кнопками управления, кнопкой Параметры задачи, кнопкой Открыть команды и атрибутами задачи Рис. 6 [1]
Таблица 2. Перечень атрибутов задачиперечень атрибутов задачи приведён в таблице 2
Атрибут Описание Тип Тип задачи Статус Статус задачи Создана Время создания задачи Пользователь Имя пользователя, создавший задачу -
блок выполнения задачи Рис. 6 [2]
- вкладка
Всена вкладке отображается список всех адресатов (клиентов, на которые планируется или уже запущена задача)
- вкладка
Ожидаетна вкладке отображается список адресатов (клиентов), находящихся в режиме ожидания
- вкладка
В процессена вкладке отображается список адресатов (клиентов), находящихся в процессе выполнения
- вкладка
С ошибкойна вкладке отображается список адресатов (клиентов) с ошибками выполнения
- вкладка
Успешнона вкладке отображается список адресатов (клиентов) с успешно выполненными задачами
- вкладка
-
таблица Карточки задачи Рис. 6 [3]
Таблица 3. Перечень полей таблицы Карточки задачиперечень полей таблицы Карточки задачи приведён в таблице 3
Имя поля Значение ID клиента Идентификатор задачи Контроллер Наименование контроллера Статус Статус клиента Количество запусков Количество проделанных запусков задачи Запущена Период запуска задачи Завершена Период завершения задачи
Для просмотра списка всех задач, выполненных на клиентах текущей отображаемой коллекции, выберите вкладку Задачи, расположенную в верхней левой части страницы коллекции клиентов.
Вид таблицы задач показан на Рис. 7.
 |
|---|
Операции запуска и перезапуска задачи, статусы выполнения задачи подробно рассмотрены в разделе Выполнение задач и политик на примере политики.
Создание политики
В процессе создания политики пользователь SALT.BOX выполняет следующие шаги:
- Выбирает коллекции клиентов.
- Выбирает шаблон политики и вводит общие параметры политики.
- Вводит параметры, определённые в шаблоне политики.
- Просматривает параметры на вкладке Обзор и подтверждает создание политики.
- Запускает и контролирует выполнение политики со страницы Карточка задачи (политики).
Выбор коллекции клиентов
Создание политики в SALT.BOX осуществляется со страницы клиентов.
В главном меню системы выберите пункт Клиенты Рис. 8.