Крон
Запланируйте вызов пограничной функции в выражении cron. Каждый запланированный запуск помещает задание в ту же очередь, что и асинхронные вызовы, потребляемые пулом рабочих процессов, без повторных попыток в случае сбоя.
Еще один триггер для ваших функций#
Служба 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. Затем работа потребляется работником, как и любая другая работа.
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().
Создать, перечислить, удалить#
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 не делает (пока)#
В отличие от секретов функций (aura secrets), команды aura functions cron сегодня нет: управление запланированными задачами происходит через SDK или REST API, а не через CLI.
Задание cron завершается с ошибкой непосредственно в dead (DLQ) с первой попытки — max_attempts стоит 1 по сравнению с 3 по умолчанию для классического асинхронного задания. Поэтому функция, вызываемая cron, должна обрабатывать свои собственные повторы, если необходимо гарантировать базовую операцию, или вам необходимо отслеживать DLQ (GET /v1/functions/:projectId/jobs/dlq) и воспроизводить их вручную.
Чтобы пойти дальше#
- Edge Functions
Среды выполнения, вызовы, задания, DLQ, секреты — служба, которую запускает cron.
- Сейф
Шифрование секретов, введенных в функцию, вызываемую cron.
- База данных
Postgres 18 разрешенных расширений, RLS и миграции.
- JavaScript SDK
createCronJob, listCronJobs, deleteCronJob — точная поверхность клиента.