> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Плейбуки и каталог действий

> Создание и версии сценариев, типизированные операции, запуск на нодах и связь с расписаниями.

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

В интерфейсе используется слово **плейбук**. В API этот ресурс называется `recipe`; `recipe_id` и `recipe_version` в результатах относятся к тому же сценарию.

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

| Действие | Параметры | Результат |
| - | - | - |
| Выполнить скрипт | Скрипт, набор переменных, входные файлы | Код завершения и ограниченный вывод |
| Диагностика хоста | Без параметров | CPU, uptime, память, корневой диск |
| Проверить service | Точный systemd-unit | Состояние загрузки и активности |
| Запустить / остановить / перезапустить service | Точный `.service` | Результат операции и состояние |
| Проверить / установить пакет | Точное имя пакета | Наличие, версия или результат установки |
| Проверить / создать системного пользователя | Имя пользователя | Состояние системной учётки |
| Проверить / применить конфигурационный файл | Файл каталога, абсолютный путь и режим | Совпадение, расхождение или результат записи |

Создание системного пользователя типизированным действием не является выдачей интерактивного SSH-доступа. Для персонального входа используйте [личные учётки](https://docs.axottle.com/ru/telepurte/users.md), для подрядчика — временный доступ.

## Создание

Откройте **Плейбуки и расписания**, запустите мастер создания. Можно начать со скрипта, набора действий либо взять существующий плейбук как основу. Укажите название, которое описывает результат, и поясните назначение.

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

Перед сохранением проверьте порядок и итог. Наличие сценария в каталоге ничего на серверах не запускает. Подготовка цели проверяется при отдельном запуске.

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

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

Материалы сохраняются как отдельные артефакты с именем, размером и контрольной суммой. Изменённое содержимое добавляйте новым артефактом и выбирайте в новой версии сценария. Так история не начинает ссылаться на незаметно изменившийся файл.

Подробный пример Bash/Ansible с переменными и файлами — в [руководстве скриптов](https://docs.axottle.com/ru/telepurte/scripts.md).

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

Создайте плейбук **Проверка тестового Nginx** из трёх шагов:

1. **Проверить service** — `nginx.service`.
2. **Запустить service** — тот же unit.
3. **Проверить service** — тот же unit.

На ноде должны быть установлены Nginx и агент, а запуск unit должен быть разрешён локальной политикой. Если сервис уже активен, действие запуска может завершиться без изменения. **Перезапустить** — другая операция: она действительно перезапускает сервис и не равна «обеспечить активное состояние».

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

## Запуск

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

До запуска проверяются права, состояние нод, агенты и поддержка каждого действия. Изменившаяся политика или версия может потребовать нового предпросмотра. Ошибка на этапе проверки ещё не означает, что действие было выполнено.

После подтверждения откройте [задание](https://docs.axottle.com/ru/telepurte/jobs.md). Список выполняющихся заданий и история находятся на том же экране; карточка показывает каждую ноду и каждый шаг.

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

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

Архивация убирает сценарий из новых запусков, сохраняя историю. Она не является отменой уже выполняемого задания.

## Проверка

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

## Откат

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

Возможности автоматизации зависят от версии и локальной политики агента.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.