Перейти к содержимому
Логотип Аурабаза
аурабаза

Крон

Запланируйте вызов пограничной функции в выражении cron. Каждый запланированный запуск помещает задание в ту же очередь, что и асинхронные вызовы, потребляемые пулом рабочих процессов, без повторных попыток в случае сбоя.

Пояснение5 мин читатьУровень среднийПересмотрено 15 авг. 2026 г.

Эта страница была переведена автоматически. Английская версия является авторитетной.

Еще один триггер для ваших функций#

Служба aura-functions может вызывать пограничную функцию по расписанию в дополнение к синхронным вызовам HTTP и асинхронным заданиям, поставленным вручную в очередь — см. /docs/functions. Отдельной функции «cron» не существует: любая развернутая функция может быть назначена по расписанию.

Информация

Cron планирует Edge Functions (aura-functions), а не задания SQL в базе данных (pg_cron не установлен в управляемом образе Postgres). Для обслуживания базы данных (материализованные представления, периодическая очистка) запланируйте пограничную функцию, которая подключается к вашей базе данных через @aurabase/aurabase-js или DATABASE_URL.

Cron ставит задание в очередь, но не запускает функцию#

Запуск cron не запускает функцию напрямую: он создает работа в очереди (те же таблицы и тот же рабочий пул, что и POST /v1/functions/:projectId/jobs), с полезной нагрузкой, замороженной во время создания cron. Затем работа потребляется работником, как и любая другая работа.

цикл планового запускаtext
TRIGGER   ────▶  внутрипроцессный планировщик срабатывает в запланированное время
ENQUEUE   ────▶  создается задание (имя_функции + полезная нагрузка cron)
WORKER    ────▶  рабочий пул потребляет задание и вызывает функцию
FAILURE     ────▶  max_attempts=1 → неактивен (DLQ) немедленно, без повторной попытки
SUCCESS    ────▶  Last_run + next_run обновляется в строке cron
Совет

При перезапуске службы все активные cron всех подготовленных проектов перезагружаются из базы данных и перепланируются — список задач сохраняется не только в памяти.

Что дает планировщик#

  • Внутрипроцессный планировщик. tokio-cron-scheduler + ящик cron в функциях aura: нет внешней службы, планирование в памяти перепланируется при запуске.
  • Каждый запуск — это задание. Cron ничего не выполняет сам: он ставит в очередь задание (например, function.invoke в асинхронном режиме), используемое тем же пулом воркеров.
  • Без повтора. Задание, созданное cron, имеет max_attempts=1: в случае сбоя оно сразу переключается на DLQ (неактивное), в отличие от классических асинхронных заданий (по умолчанию 3 попытки).
  • Отслеживание последнего_запуска/следующего_запуска. Каждый триггер отмечает метку времени последнего_запуска и предварительно рассчитывает следующий_запуск на основе сохраненного выражения, видимого через listCronJobs().

Создать, перечислить, удалить#

app/cron.tstypescript
import { createClient } from '@aurabase/aurabase-js'

const aura = createClient(url, serviceRoleKey)

// Выражение из 5 полей (мин час день месяц dsem) — секунды
// неявно 0. Также допускается выражение из 6 полей (с секундами).
await aura.functions.createCronJob(
  'rollup-15min',      // имя, уникальное для каждого проекта
  '*/15 * * * *',      // планирование
  'rollup',             // функция, вызываемая при каждом запуске
  { payload: { minutes: 15 } },
)

const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
Совет

Имя cron уникально для каждого проекта и служит идентификатором для удаления (DELETE /v1/functions/:projectId/cron/:nom) — на стороне клиента нет UUID, который нужно запомнить.

Чего cron не делает (пока)#

Нет специальной команды CLI

В отличие от секретов функций (aura secrets), команды aura functions cron сегодня нет: управление запланированными задачами происходит через SDK или REST API, а не через CLI.

Нет автоматической повторной попытки

Задание cron завершается с ошибкой непосредственно в dead (DLQ) с первой попытки — max_attempts стоит 1 по сравнению с 3 по умолчанию для классического асинхронного задания. Поэтому функция, вызываемая cron, должна обрабатывать свои собственные повторы, если необходимо гарантировать базовую операцию, или вам необходимо отслеживать DLQ (GET /v1/functions/:projectId/jobs/dlq) и воспроизводить их вручную.

Чтобы пойти дальше#