Сервисы

scheduler

Триггеры Conveyor — cron-расписания и webhook-запуски процессов через очереди BullMQ.

scheduler запускает процессы по расписанию (cron) и по webhook-триггерам, складывая задачи в очереди BullMQ. Слушает TCP :3000.

На какие вопросы отвечает раздел: Кто запускает процессы по расписанию? Можно ли ограничить частоту cron? Что нужно для работы? Как переживается простой сервиса?

Цель

Инициировать Запуски процессов без участия человека: по времени (cron) или внешнему событию (webhook).

Задачи

  • регистрация cron-триггеров из определений процессов;
  • журнал слотов в PostgreSQL (scheduler_occurrence) с захватом и публикацией Запуска;
  • добор последнего пропущенного слота после простоя или окна бэкапа;
  • постановка Запусков в очередь;
  • обработка webhook-триггеров.

Требования

  • PostgreSQL (определения триггеров и журнал слотов);
  • Redis (BullMQ).

Ограничения

  • обязателен только при использовании cron/webhook-триггеров;
  • минимальный период cron ограничен настройкой (защита от слишком частых запусков);
  • при простое за один проход на триггер запускается только последний слот; более ранние помечаются как пропущенные с причиной.

Журнал слотов

ТаблицаНазначение
scheduler_occurrenceСлот cron: статус due / claimed / fired / skipped, стабильный run_id
scheduler_pauseОкно обслуживания (например бэкап перед миграцией)
scheduler_cursorОтметка «до какого момента сверка уже сделана»

Первый старт после появления таблиц ставит курсор на «сейчас»: история назад не стреляет. После окна бэкапа сервис закрывает открытую паузу и добирает последний слот.

Настройки и переменные окружения

ПеременнаяЗачемНа что влияетПо умолчанию
SCHEDULER_TCP_LISTENАдрес TCP-сервисаПорт/интерфейс scheduler0.0.0.0:3000
SCHEDULER_MIN_CRON_PERIOD_MINUTESМин. период cronНижняя граница частоты расписаний1
DATABASE_URLПодключение к PostgresТриггеры и журнал слотов—
REDIS_HOST / REDIS_PORTОчередиПостановка Запусковredis / 6379

Дальше