Автоматизации
Автоматизация связывает повторяющееся расписание или проверенный входящий вебхук с действием в одной песочнице Just Run. Используйте автоматизации для заданий по расписанию, обработчиков событий, ботов и интеграций, которым нужно будить песочницу только при появлении работы.
Автоматизации работают асинхронно. Триггер создает запуск, обработчик запусков автоматизаций при необходимости находит и будит целевую песочницу, а запуск сохраняет вывод или результат доставки.
Из чего состоит автоматизация
Каждая автоматизация объединяет один триггер с одним действием:
| Действие Выполнить команду | Действие HTTP POST | |
|---|---|---|
| Триггер Расписание cron | Запускает команду по расписанию | Отправляет POST с пустым телом в сервис внутри песочницы по расписанию |
| Триггер Входящий webhook | Передает проверенное тело запроса команде через stdin | Пересылает проверенное тело запроса в HTTP-сервис внутри песочницы |
Поддерживаются все четыре комбинации. Типы триггера и действия фиксируются после создания; если нужно изменить любой тип, создайте другую автоматизацию.
Определение также содержит:
- опциональную целевую песочницу в том же аккаунте;
- настройки триггера — расписания или проверки вебхука;
- команду с аргументами или HTTP-порт и путь;
- политики повторов, конкурентности, переноса заголовков и хранения содержимого запроса;
- состояние включения и видимость в аккаунте.
Автоматизацию без привязки можно сохранить, но она не сможет принять вебхук или запускаться вручную, пока не будет подключена целевая песочница.
Ментальная модель
cron schedule ─────┐
├──► Automation ──► queued run ──► wake sandbox
verified webhook ──┘ │ │
│ ├── run command
frozen snapshot ◄────────┘ └── POST service
│
└──► succeeded или failed
Автоматизация — редактируемое определение. Каждое принятое событие создает
отдельный запуск с замороженным снимком целевой песочницы и действия. Последующие
изменения автоматизации, смена ее привязки, ее выключение или удаление целевой песочницы не
перенаправляют уже queued запуск.
Очередь запусков одновременно служит историей. Запуски проходят состояния
queued, running и терминальное состояние succeeded или failed. Окно Детали запуска может
содержать попытки, ошибки, код выхода команды и сохраненный вывод, HTTP-статус и тело
ответа, а также сохраненное содержимое запроса вебхука.
Триггеры
Cron
Триггер Расписание cron использует выражение из пяти полей без секунд и таймзону IANA. Just Run вычисляет следующее будущее срабатывание и сохраняет его в UTC. Когда отключенное расписание включается снова, оно продолжает со следующего будущего срабатывания, не создавая запуски за пропущенные интервалы.
Одновременно активным может быть только один cron-запуск одной автоматизации.
Срабатывание по расписанию, пересекающееся с уже queued или running
cron-запуском, пропускается. У cron-запуска одна попытка; следующее
срабатывание расписания создает новый запуск, а не повтор.
Вебхук
Триггер Входящий webhook принимает запросы через стабильный публичный URL:
POST /v1/automations/hooks/<slug>
Эндпоинт не использует вход или API-токен Just Run. Он проверяет точное тело запроса по схеме выбранного провайдера:
- GitHub и произвольный HMAC используют HMAC-SHA256;
- GitLab использует заголовок секретного токена;
- Telegram использует заголовок секретного токена;
- Mattermost использует общий токен формы.
После проверки и исключения дублей эндпоинт возвращает HTTP 202 и ставит
работу в очередь, не ожидая пробуждения песочницы. Повторная доставка от провайдера
подтверждается как повтор и не создает еще один запуск.
Для автоматизаций по вебхуку нужна конфигурация инсталляции для шифрования секретов. Общий секрет хранится зашифрованным, не возвращается после создания или ротации и представлен только маскированным значением последних четырех символов.
Действия и целевая песочница
Действие Выполнить команду выполняет команду с аргументами в целевой песочнице. Тело запроса
вебхука становится stdin; Just Run также добавляет метаданные запуска через
переменные окружения JUSTRUN_*. После завершения команды автоматизация может
перевести песочницу в гибернацию, остановить ее либо оставить активной.
Действие HTTP POST отправляет POST на настроенные порт и путь внутри целевой
песочницы. Оно пересылает только настроенные заголовки запроса и добавляет
внутренние идентификаторы автоматизации и запуска. Ответ 2xx означает успех;
остальные ответы обрабатываются согласно политике обработки сбоев и политике повторов
запуска.
Целевая песочница должна принадлежать активному аккаунту. Запуск может использовать активную песочницу или разбудить песочницу в гибернации либо остановленную песочницу. Пробуждение, загрузка, команда и задержка HTTP происходят уже после принятия триггера.
По умолчанию завершившаяся команда считается успешной даже с ненулевым кодом выхода. В форме автоматизации с действием Выполнить команду выберите для параметра При ненулевом выходе значение Повтор, если ненулевой код должен следовать обычной политике повторов или политике обработки сбоев.
Запуски, повторные попытки и порядок
Запуски по вебхуку могут повторять неудачную инфраструктурную операцию, HTTP-доставку
с ответом не 2xx или ненулевой результат команды, если для него включен повтор. Лимит попыток и
интервал между повторами ограничиваются конфигурацией автоматизации и инсталляции. Cron-запуски
не повторяются.
Конкурентность может работать в режимах:
parallel— независимые запуски могут выполняться одновременно;serial— запуски выполняются по порядку для всей автоматизации;partitioned— в текущей реализации порядок поддерживается независимо по диалогам Telegram.
Используйте Запустить сейчас в списке автоматизаций, чтобы поставить в очередь внеплановую проверку или ручной запуск. Повторить доставку в истории запусков создает новый запуск из замороженного снимка прошлого запуска; исходная запись истории не меняется.
Сырое тело запроса вебхука и выбранные заголовки доступны только в течение срока хранения содержимого запроса, заданного в автоматизации, после чего очищаются. Записи запусков целиком и сохраненный вывод подчиняются лимитам хранения и размера, зависящим от инсталляции.
Поведение приостановки и удаления
Выключение автоматизации сохраняет ее определение и историю. Оно предотвращает новые
срабатывания cron и отклоняет новые запросы вебхука. Уже queued или running запуски
не отменяются, а Запустить сейчас остается явной операцией управления.
Для cron выключение очищает next_run_at, а включение вычисляет следующее будущее
срабатывание. Удаление автоматизации уничтожает ее историю запусков, но не
целевую песочницу.
Точки входа и доступ
| Способ | Для чего использовать |
|---|---|
| Веб-интерфейс → Автоматизации | Создание, привязка, изменение, приостановка, запуск, просмотр истории, повторная доставка и удаление |
REST /v1/automations | Полное управление и операции с запусками |
| MCP управления платформой | Список и просмотр автоматизаций из MCP-клиента |
| Публичный URL вебхука | Доставка внешнего аутентифицированного события |
Автоматизации принадлежат активному личному аккаунту или аккаунту организации.
Участник организации может создать личную автоматизацию (по умолчанию) или
явно выбрать видимость org. Личную автоматизацию и историю ее запусков
видят только автор и пользователи с ролью Владелец или Администратор
организации. Общую автоматизацию и ее историю видят все участники, но менять и
запускать ее могут только автор и пользователи с ролью Владелец или
Администратор. Ответ API содержит permissions.mutate для текущего
пользователя. Целевая песочница должна принадлежать тому же аккаунту, а автор
должен иметь право изменять ее. Общую автоматизацию нельзя привязать к личной
песочнице: история запусков доступна всей организации. Действительный публичный
вебхук по-прежнему может запустить личную автоматизацию по ее URL.
Если автор уходит из организации, следующий запуск из очереди блокируется до обращения к песочнице и выключает автоматизацию. Пользователь с ролью Владелец или Администратор может выключить ее раньше. Для продолжения действующий участник создает новую автоматизацию с доступной ему целью. У новой автоматизации по вебхуку будут новые URL и секрет верификатора: отправителя нужно перенастроить. Старая история запусков остается у старой автоматизации до ее удаления; владелец не передается.
Выполнение запусков зависит от инсталляции. Когда автоматизации отключены в
конфигурации инсталляции, планировщик cron и обработчик запусков автоматизаций не обрабатывают работу,
а запросы публичного вебхука возвращают HTTP 503. Существующие определения
могут оставаться видимыми через способы управления.
Подробнее об автоматизациях
- Триггеры — расписания cron, таймзоны, вебхуки и верификаторы провайдеров.
- Действия — выполнение команды, HTTP-доставка, входные данные, вывод и состояние песочницы после запуска.
- Безопасность вебхука — подписи, токены, исключение дублей, переносимые заголовки и хранение содержимого запроса.
- Конкурентность и порядок — доставка параллельно, последовательно и по ключу.
- Повторные попытки и доставка — правила успеха, попытки, интервал между повторами и повторная доставка.
- Запуски и история — состояния запусков, сохраненные результаты, ручные запуски и хранение.
- Диагностика — разбор отклоненных событий, сбоев пробуждения, команд и HTTP-ответов.
- Лимиты — границы для аккаунта, содержимого запроса, выполнения, вывода и хранения.
- Справочник API вебхуков — точные контракты проверки и подтверждения.
- Справочник REST API — управление и схемы запусков.