> ## 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.

# Расписания

> Регулярный запуск плейбуков: дни недели, часовой пояс, пропуски, фиксированные цели и история.

Расписание создаёт задания Telepúrte в выбранное местное время ежедневно или по дням недели. Оно хранит конкретную версию плейбука и точный список нод. Изменение группы или появление новых серверов не расширяет существующее расписание автоматически.

## Создать из плейбука

1. В **Плейбуки и расписания** выберите проверенный сценарий и нажмите **Запустить**.
2. Выберите ноды, группы или метки и получите предпросмотр.
3. Сверьте версию, шаги и полный список целей.
4. На последнем шаге выберите **По расписанию**.
5. Укажите часовой пояс, час, минуту и дни недели.
6. Выберите, что делать с пропущенным временем, и сохраните.

Используйте IANA-имя часового пояса, например `Asia/Yekaterinburg`, либо `UTC`. Время относится к выбранному поясу, а не обязательно к часовому поясу сервера или браузера.

Хотя интерфейс может называть запуски cron-расписаниями, форма задаёт время и дни недели. Произвольное выражение из пяти полей в неё не вводится.

## Пример регулярной диагностики

Создайте плейбук с **Диагностикой хоста**, проверьте его вручную на выбранных нодах. Затем задайте 09:00, `Asia/Yekaterinburg`, понедельник–пятницу и **Пропустить** при пропуске.

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

## Изменяющие расписания

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

Для типизированных изменяющих действий — например, перезапуска сервиса или применения файла — сервер требует явного разрешения изменений и rollout с канарейкой. Расширенная настройка rollout выполняется через API предпросмотра; в текущем мастере этих полей нет. Если такой сценарий отклонён, это ограничение нельзя обойти повторным нажатием кнопки. Используйте корректный API-предпросмотр или ручной запуск.

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

## Пропуски и пересечения

| Политика / событие | Поведение |
| - | - |
| **Пропустить** | При опоздании более пяти минут момент отмечается пропущенным |
| **Выполнить один раз** | После простоя создаётся одно догоняющее задание, а не отдельное за каждый пропущенный день |
| Предыдущее задание ещё работает | Новый момент получает `skipped_overlap` |
| Цель или агент недоступны при проверке | Наступление завершается ошибкой без частичного задания |
| Версия плейбука изменилась | `recipe_changed`, расписание выключается |

В день перевода часов отсутствующее местное время пропускается, повторяющийся час не создаёт два обычных запуска за один календарный день.

## Окно обслуживания через API

API расписаний дополнительно поддерживает `maintenance_window` и конечный срок `ends_at`. Окно задаётся местным временем и должно содержать назначенный момент; конец раньше начала означает переход через полночь.

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

Эти параметры не следует искать в текущей базовой форме: они относятся к расширенной настройке API `/api/v1/schedules`.

## Пауза, возобновление и изменение

Откройте расписание из списка, посмотрите правило, цели и историю наступлений. Приостановка запрещает будущие запуски, но не останавливает уже созданное задание — его остановите отдельно.

Возобновление рассчитывает следующий будущий момент, не воспроизводя все пропуски периода паузы. Если плейбук изменён или архивирован, создайте новый предпросмотр и расписание для актуальной версии. Так же поступайте при изменении состава нод.

## Проверка

Проверьте часовой пояс, дни, следующий запуск, число нод и политику пропуска. После первого наступления откройте созданное задание и конечные результаты. Состояние «Активно» означает включённое правило, а не успешность последнего исполнения.

## Откат

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

Расширенные параметры, обозначенные как API, могут отсутствовать в текущей форме интерфейса.


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