На этой странице
Видео: долгие процессы1:07
  1. Скачайте SDK

    Один файл без зависимостей: hangar.js или hangar.py (вкладка «Как писать»). Опишите процесс функцией с шагами step.run.

  2. Подключите приложение

    Workflows → «Подключить приложение»: сервис проекта с портом и путём (например, /workflows). Секрет приложения положите в WORKFLOW_SECRET.

  3. Обновите функции

    Кнопка «Обновить функции» спросит у приложения список процессов — они появятся на карточке.

  4. Запустите

    Кнопка «Запустить» или из кода: POST /v1/workflows/start/<приложение>/<функция> с ключом JOBS_KEY.

Hangar Workflows
Приложение orders: функции process-order и send-digest, запуски в работе, ждут, готово и ошибки за сутки.

Как это устроено#

Workflow — функция в вашем сервисе, объявленная через Hangar SDK (один файл для JavaScript/TypeScript или Python). Hangar хранит результат каждого шага: функция вызывается заново с готовыми результатами и выполняет только следующий шаг. Поэтому после падения, деплоя или перезапуска сервиса процесс продолжается, а не начинается заново.

Шаги#

step.run(имя, функция) — шаг выполняется один раз, при ошибке повторяется с паузой. step.sleep(имя, '1h') — пауза от секунд до месяцев. step.waitForEvent(имя, { event, match, timeout }) — ждёт событие, например подтверждение пользователя, до 30 дней. Побочные эффекты — только внутри step.run, у каждого шага своё имя.

Запуск процесса
Запуск orders/process-order: шаги create-order, payment (ожидание события), pack (сон) и send-receipt с результатами.

Подключение#

Добавьте эндпоинт в разделе Workflows («Подключить приложение»), положите выданный WORKFLOW_SECRET в переменные сервиса и нажмите «Обновить функции». Запуск — из панели или из кода: POST /v1/workflows/start/приложение/функция с ключом workspace; событие — POST /v1/workflows/events.

Контроль#

В панели видно каждый запуск и его шаги: результаты, ошибки, попытки, до какого времени спит или чего ждёт. Упавший запуск можно продолжить с упавшего шага, любой — отменить. История хранится 30 дней.

Терминал
curl -o hangar.js https://api.hangar.rest/sdk/workflows.js

wf.define('process-document', async ({ input, step }) => {
  const doc = await step.run('upload', () => upload(input.url))
  const ok = await step.waitForEvent('approval', { event: 'document.approved', match: doc.id, timeout: '3d' })
  await step.sleep('cool-down', '10m')
  return await step.run('send', () => send(doc, ok))
})

await hangar.start('docs', 'process-document', { url })
await hangar.event('document.approved', { match: docId })
Запуски
Запуски: готовые и ждущие событие order.paid.
События
События: order.paid разбудили ждущие запуски; справа — отправка события из панели.