# Автоматизации

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

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

## Из чего состоит автоматизация[​](#what-an-automation-contains "Прямая ссылка на Из чего состоит автоматизация")

Каждая автоматизация объединяет один триггер с одним действием:

|                            | Действие *Выполнить команду*                          | Действие *HTTP POST*                                                     |
| -------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------ |
| Триггер *Расписание cron*  | Запускает команду по расписанию                       | Отправляет `POST` с пустым телом в сервис внутри песочницы по расписанию |
| Триггер *Входящий webhook* | Передает проверенное тело запроса команде через stdin | Пересылает проверенное тело запроса в HTTP-сервис внутри песочницы       |

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

Определение также содержит:

* опциональную целевую песочницу в том же аккаунте;
* настройки триггера — расписания или проверки вебхука;
* команду с аргументами или HTTP-порт и путь;
* политики повторов, конкурентности, переноса заголовков и хранения содержимого запроса;
* состояние включения и видимость в аккаунте.

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

## Ментальная модель[​](#mental-model "Прямая ссылка на Ментальная модель")

```
cron schedule ─────┐
                   ├──► Automation ──► queued run ──► wake sandbox
verified webhook ──┘                         │              │
                                             │              ├── run command
                    frozen snapshot ◄────────┘              └── POST service
                                             │
                                             └──► succeeded или failed
```

Автоматизация — редактируемое определение. Каждое принятое событие создает отдельный запуск с замороженным снимком целевой песочницы и действия. Последующие изменения автоматизации, смена ее привязки, ее выключение или удаление целевой песочницы не перенаправляют уже `queued` запуск.

Очередь запусков одновременно служит историей. Запуски проходят состояния `queued`, `running` и терминальное состояние `succeeded` или `failed`. Окно *Детали запуска* может содержать попытки, ошибки, код выхода команды и сохраненный вывод, HTTP-статус и тело ответа, а также сохраненное содержимое запроса вебхука.

## Триггеры[​](#triggers "Прямая ссылка на Триггеры")

### Cron[​](#cron "Прямая ссылка на Cron")

Триггер *Расписание cron* использует выражение из пяти полей без секунд и таймзону IANA. Just Run вычисляет следующее будущее срабатывание и сохраняет его в UTC. Когда отключенное расписание включается снова, оно продолжает со следующего будущего срабатывания, не создавая запуски за пропущенные интервалы.

Одновременно активным может быть только один cron-запуск одной автоматизации. Срабатывание по расписанию, пересекающееся с уже `queued` или `running` cron-запуском, пропускается. У cron-запуска одна попытка; следующее срабатывание расписания создает новый запуск, а не повтор.

### Вебхук[​](#webhook "Прямая ссылка на Вебхук")

Триггер *Входящий webhook* принимает запросы через стабильный публичный URL:

```
POST /v1/automations/hooks/<slug>
```

Эндпоинт не использует вход или API-токен Just Run. Он проверяет точное тело запроса по схеме выбранного провайдера:

* GitHub и произвольный HMAC используют HMAC-SHA256;
* GitLab использует заголовок секретного токена;
* Telegram использует заголовок секретного токена;
* Mattermost использует общий токен формы.

После проверки и исключения дублей эндпоинт возвращает HTTP `202` и ставит работу в очередь, не ожидая пробуждения песочницы. Повторная доставка от провайдера подтверждается как повтор и не создает еще один запуск.

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

## Действия и целевая песочница[​](#actions-and-target-compute "Прямая ссылка на Действия и целевая песочница")

Действие *Выполнить команду* выполняет команду с аргументами в целевой песочнице. Тело запроса вебхука становится stdin; Just Run также добавляет метаданные запуска через переменные окружения `JUSTRUN_*`. После завершения команды автоматизация может перевести песочницу в гибернацию, остановить ее либо оставить активной.

Действие *HTTP POST* отправляет `POST` на настроенные порт и путь внутри целевой песочницы. Оно пересылает только настроенные заголовки запроса и добавляет внутренние идентификаторы автоматизации и запуска. Ответ `2xx` означает успех; остальные ответы обрабатываются согласно политике обработки сбоев и политике повторов запуска.

Целевая песочница должна принадлежать активному аккаунту. Запуск может использовать активную песочницу или разбудить песочницу в гибернации либо остановленную песочницу. Пробуждение, загрузка, команда и задержка HTTP происходят уже после принятия триггера.

Коды выхода команды

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

## Запуски, повторные попытки и порядок[​](#runs-retries-and-ordering "Прямая ссылка на Запуски, повторные попытки и порядок")

Запуски по вебхуку могут повторять неудачную инфраструктурную операцию, HTTP-доставку с ответом не `2xx` или ненулевой результат команды, если для него включен повтор. Лимит попыток и интервал между повторами ограничиваются конфигурацией автоматизации и инсталляции. Cron-запуски не повторяются.

Конкурентность может работать в режимах:

* `parallel` — независимые запуски могут выполняться одновременно;
* `serial` — запуски выполняются по порядку для всей автоматизации;
* `partitioned` — в текущей реализации порядок поддерживается независимо по диалогам Telegram.

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

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

## Поведение приостановки и удаления[​](#pause-and-delete-behavior "Прямая ссылка на Поведение приостановки и удаления")

Выключение автоматизации сохраняет ее определение и историю. Оно предотвращает новые срабатывания cron и отклоняет новые запросы вебхука. Уже `queued` или `running` запуски не отменяются, а *Запустить сейчас* остается явной операцией управления.

Для cron выключение очищает `next_run_at`, а включение вычисляет следующее будущее срабатывание. Удаление автоматизации уничтожает ее историю запусков, но не целевую песочницу.

## Точки входа и доступ[​](#entry-points-and-access "Прямая ссылка на Точки входа и доступ")

| Способ                          | Для чего использовать                                                                                |
| ------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Веб-интерфейс → *Автоматизации* | Создание, привязка, изменение, приостановка, запуск, просмотр истории, повторная доставка и удаление |
| REST `/v1/automations`          | Полное управление и операции с запусками                                                             |
| MCP управления платформой       | Список и просмотр автоматизаций из MCP-клиента                                                       |
| Публичный URL вебхука           | Доставка внешнего аутентифицированного события                                                       |

Автоматизации принадлежат активному личному аккаунту или аккаунту организации. Участник организации может создать личную автоматизацию (по умолчанию) или явно выбрать видимость `org`. Личную автоматизацию и историю ее запусков видят только автор и пользователи с ролью *Владелец* или *Администратор* организации. Общую автоматизацию и ее историю видят все участники, но менять и запускать ее могут только автор и пользователи с ролью *Владелец* или *Администратор*. Ответ API содержит `permissions.mutate` для текущего пользователя. Целевая песочница должна принадлежать тому же аккаунту, а автор должен иметь право изменять ее. Общую автоматизацию нельзя привязать к личной песочнице: история запусков доступна всей организации. Действительный публичный вебхук по-прежнему может запустить личную автоматизацию по ее URL.

Если автор уходит из организации, следующий запуск из очереди блокируется до обращения к песочнице и выключает автоматизацию. Пользователь с ролью *Владелец* или *Администратор* может выключить ее раньше. Для продолжения действующий участник создает новую автоматизацию с доступной ему целью. У новой автоматизации по вебхуку будут новые URL и секрет верификатора: отправителя нужно перенастроить. Старая история запусков остается у старой автоматизации до ее удаления; владелец не передается.

Выполнение запусков зависит от инсталляции. Когда автоматизации отключены в конфигурации инсталляции, планировщик cron и обработчик запусков автоматизаций не обрабатывают работу, а запросы публичного вебхука возвращают HTTP `503`. Существующие определения могут оставаться видимыми через способы управления.

## Подробнее об автоматизациях[​](#explore-automations "Прямая ссылка на Подробнее об автоматизациях")

* [Триггеры](/automations/triggers) — расписания cron, таймзоны, вебхуки и верификаторы провайдеров.
* [Действия](/automations/actions) — выполнение команды, HTTP-доставка, входные данные, вывод и состояние песочницы после запуска.
* [Безопасность вебхука](/automations/webhook-security) — подписи, токены, исключение дублей, переносимые заголовки и хранение содержимого запроса.
* [Конкурентность и порядок](/automations/concurrency-and-ordering) — доставка параллельно, последовательно и по ключу.
* [Повторные попытки и доставка](/automations/retries-and-delivery) — правила успеха, попытки, интервал между повторами и повторная доставка.
* [Запуски и история](/automations/runs-and-history) — состояния запусков, сохраненные результаты, ручные запуски и хранение.
* [Диагностика](/automations/troubleshooting) — разбор отклоненных событий, сбоев пробуждения, команд и HTTP-ответов.
* [Лимиты](/automations/limits) — границы для аккаунта, содержимого запроса, выполнения, вывода и хранения.
* [Справочник API вебхуков](/api-reference/webhooks.md) — точные контракты проверки и подтверждения.
* [Справочник REST API](/api-reference/rest.md) — управление и схемы запусков.
