Cron
Planifier l’invocation d’une Edge Function sur une expression cron. Chaque échéance enfile un job dans la même file que les invocations asynchrones, consommé par le pool de workers — sans réessai en cas d’échec.
Un déclencheur de plus pour vos fonctions#
Le service aura-functions peut invoquer une Edge Function selon une planification, en plus des invocations HTTP synchrones et des jobs asynchrones mis en file manuellement — voir /docs/functions. Il n'y a pas de fonction « cron » à part : n'importe quelle fonction déployée peut être ciblée par une planification.
Le cron planifie des Edge Functions (aura-functions), pas des tâches SQL internes (pg_cron n'est pas installé dans l'image Postgres managée). Pour vos tâches périodiques en base (rafraîchissement de vues matérialisées, purge), planifiez une Edge Function qui se connecte à votre base via @aurabase/aurabase-js ou DATABASE_URL.
Le cron enfile, il n’exécute pas#
Une échéance de cron ne lance pas la fonction directement : elle crée un job dans la file (les mêmes tables et le même pool de workers que POST /v1/functions/:projectId/jobs), avec un payload figé au moment de la création du cron. Le job est ensuite consommé par un worker comme n'importe quel autre job.
ÉCHÉANCE ────▶ le scheduler in-process déclenche à l’heure prévue
ENQUEUE ────▶ un job est créé (function_name + payload du cron)
WORKER ────▶ le pool de workers consomme le job, invoque la fonction
ÉCHEC ────▶ max_attempts=1 → dead (DLQ) immédiatement, pas de retry
SUCCÈS ────▶ last_run + next_run mis à jour sur la ligne cron
Au redémarrage du service, tous les crons actifs de tous les projets provisionnés sont rechargés depuis la base et replanifiés — la liste des tâches n'est pas persistée en mémoire seule.
Ce que le scheduler fournit#
- Scheduler in-process. tokio-cron-scheduler + la crate cron dans aura-functions : pas de service externe, planification en mémoire replanifiée au démarrage.
- Chaque échéance = un job. Le cron n'exécute rien lui-même : il enfile un job (comme functions.invoke en mode asynchrone), consommé par le même pool de workers.
- Sans réessai. Un job créé par le cron a max_attempts=1 : un échec le fait basculer directement en DLQ (dead), contrairement aux jobs asynchrones classiques (3 tentatives par défaut).
- Suivi last_run / next_run. Chaque déclenchement horodate last_run et pré-calcule next_run à partir de l’expression stockée — visible via listCronJobs().
Créer, lister, supprimer#
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(url, serviceRoleKey)
// 5-field expression (min hour day month dsem) — seconds are
// implicitly 0. A 6-field expression (with seconds) is also accepted.
await aura.functions.createCronJob(
'rollup-15min', // nom, unique par projet
'*/15 * * * *', // planification
'rollup', // fonction invoquée à chaque échéance
{ payload: { minutes: 15 } },
)
const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
Le nom d'un cron est unique par projet et sert d'identifiant pour la suppression (DELETE /v1/functions/:projectId/cron/:nom) — il n'y a pas d'UUID à retenir côté client.
Ce que le cron ne fait pas (encore)#
Contrairement aux secrets de fonctions (aura secrets), il n'existe aujourd'hui aucune commande aura functions cron : la gestion des tâches planifiées passe par le SDK ou l'API REST, pas par la CLI.
Un job issu du cron échoue directement en dead (DLQ) dès la première tentative — max_attempts vaut 1, contre 3 par défaut pour un job asynchrone classique. Une fonction invoquée par cron doit donc gérer elle-même ses propres reprises si l'opération sous-jacente doit être garantie, ou vous devez surveiller la DLQ (GET /v1/functions/:projectId/jobs/dlq) et rejouer manuellement.
Pour aller plus loin#
- Edge Functions
Runtimes, invocation, jobs, DLQ, secrets — le service que le cron déclenche.
- Vault
Chiffrement des secrets injectés dans la fonction invoquée par cron.
- Database
Extensions Postgres 18 autorisées, RLS et migrations.
- SDK JavaScript
createCronJob, listCronJobs, deleteCronJob — la surface exacte du client.