Перейти к основному содержимому
Открыть Markdown

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

Автоматизация связывает повторяющееся расписание или проверенный входящий вебхук с действием в одной песочнице 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 — управление и схемы запусков.