Сервисы
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-сервиса | Порт/интерфейс scheduler | 0.0.0.0:3000 |
SCHEDULER_MIN_CRON_PERIOD_MINUTES | Мин. период cron | Нижняя граница частоты расписаний | 1 |
DATABASE_URL | Подключение к Postgres | Триггеры и журнал слотов | — |
REDIS_HOST / REDIS_PORT | Очереди | Постановка Запусков | redis / 6379 |
Дальше
- Настройки процесса: триггеры (manual/webhook/cron/MCP).