Перейти к основному содержанию
Плейбук — сохранённый сценарий из одного или нескольких последовательных шагов. Он описывает, что выполнить; цели выбираются при запуске. Один сценарий можно проверить на тестовой машине, затем применить к другой группе, сохранив версию и результаты каждого запуска. В интерфейсе используется слово плейбук. В API этот ресурс называется recipe; recipe_id и recipe_version в результатах относятся к тому же сценарию.

Что можно включить

Создание системного пользователя типизированным действием не является выдачей интерактивного SSH-доступа. Для персонального входа используйте личные учётки, для подрядчика — временный доступ.

Создание

Откройте Плейбуки и расписания, запустите мастер создания. Можно начать со скрипта, набора действий либо взять существующий плейбук как основу. Укажите название, которое описывает результат, и поясните назначение. Добавьте шаги в нужном порядке, до 64 в одном сценарии. Для каждого выберите действие и заполните его параметры. Для скрипта укажите сохранённый Bash/Ansible-файл; для конфигурации — утверждённый файл и точный путь; для systemd — полный unit, например nginx.service. Перед сохранением проверьте порядок и итог. Наличие сценария в каталоге ничего на серверах не запускает. Подготовка цели проверяется при отдельном запуске.

Каталог файлов, скриптов и переменных

На том же экране хранится каталог материалов для сценариев. Скрипт, обычный файл и набор переменных — разные типы. Скрипт исполняется, входные файлы доступны ему во временном каталоге, переменные передаются в окружение процесса. Материалы сохраняются как отдельные артефакты с именем, размером и контрольной суммой. Изменённое содержимое добавляйте новым артефактом и выбирайте в новой версии сценария. Так история не начинает ссылаться на незаметно изменившийся файл. Подробный пример Bash/Ansible с переменными и файлами — в руководстве скриптов.

Пример: проверить и запустить сервис

Создайте плейбук Проверка тестового Nginx из трёх шагов:
  1. Проверить service — nginx.service.
  2. Запустить service — тот же unit.
  3. Проверить service — тот же unit.
На ноде должны быть установлены Nginx и агент, а запуск unit должен быть разрешён локальной политикой. Если сервис уже активен, действие запуска может завершиться без изменения. Перезапустить — другая операция: она действительно перезапускает сервис и не равна «обеспечить активное состояние». Успех предыдущего шага открывает следующий на этой ноде. Ошибка не должна маскироваться продолжением сценария: проверьте результат шага и фактическое состояние перед новым запуском.

Запуск

Нажмите Запустить, выберите ноды, группы или метки. Предпросмотр фиксирует текущую версию, шаги и точный список целей. Сверьте имена машин, действия и параметры, затем выберите Выполнить сейчас или По расписанию. До запуска проверяются права, состояние нод, агенты и поддержка каждого действия. Изменившаяся политика или версия может потребовать нового предпросмотра. Ошибка на этапе проверки ещё не означает, что действие было выполнено. После подтверждения откройте задание. Список выполняющихся заданий и история находятся на том же экране; карточка показывает каждую ноду и каждый шаг.

Версии и архив

Кнопка Новая версия создаёт следующую версию того же сценария. Уже созданное задание сохраняет свои шаги. Расписание привязано к версии: изменение или архивация плейбука может остановить его дальнейшие запуски с recipe_changed. Перепроверьте цели и создайте расписание для новой версии. Архивация убирает сценарий из новых запусков, сохраняя историю. Она не является отменой уже выполняемого задания.

Проверка

Начните с одной тестовой ноды. Проверьте результат каждого шага и фактическое состояние сервиса или файла. После этого выберите рабочие цели и ещё раз сверяйте сводку: проверка на тестовой машине не переносит её права и зависимости на весь парк.

Откат

Остановите оставшуюся работу через карточку задания и приостановите расписания. Создайте отдельный обратный сценарий либо восстановите состояние вручную. Версия плейбука — история определения, а не снимок файловой системы: автоматического общего отката всех шагов нет. Возможности автоматизации зависят от версии и локальной политики агента.