Aller au contenu
Logo Aurabase
aurabase

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.

Explication5 min de lectureNiveau intermédiaireRévisé le 15 août 2026

Cette page a été traduite automatiquement. La version anglaise fait foi.

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.

Informations

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.

cycle d’une échéancetext
É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
Astuce

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#

app/cron.tstypescript
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')
Astuce

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)#

Pas de commande CLI dédiée

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.

Pas de réessai automatique

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#