Vai al contenuto
Logo Aurabase
aurabase

Cron

Pianifica l'invocazione di una funzione Edge su un'espressione cron. Ogni esecuzione pianificata inserisce un lavoro nella stessa coda delle invocazioni asincrone, consumate dal pool di lavoratori, senza riprovare in caso di errore.

Spiegazione5 min lettoLivello intermedioRevisionato il 15 ago 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Un ulteriore trigger per le tue funzioni#

Il servizio aura-functions può richiamare una funzione Edge in base a una pianificazione, oltre alle invocazioni HTTP sincrone e ai processi asincroni accodati manualmente: vedere /docs/functions. Non esiste una funzione "cron" separata: qualsiasi funzione implementata può essere targetizzata da una pianificazione.

Informazioni

Cron pianifica Edge Functions (aura-functions), non lavori SQL nel database (pg_cron non è installato nell'immagine gestita Postgres). Per la manutenzione del database (viste materializzate, pulizie periodiche), pianifica una funzione Edge che si connette al database tramite @aurabase/aurabase-js o DATABASE_URL.

Cron accoda un lavoro, non esegue la funzione#

Un'esecuzione cron non avvia direttamente la funzione: crea un file lavoro nella coda (le stesse tabelle e lo stesso pool di nodi di lavoro di POST /v1/functions/:projectId/jobs), con un payload congelato al momento della creazione del cron. Il lavoro viene quindi consumato da un lavoratore come qualsiasi altro lavoro.

ciclo di una corsa programmatatext
TRIGGER   ────▶  lo scheduler in-process si attiva all'orario pianificato
ENQUEUE   ────▶  viene creato un lavoro (nome_funzione + payload cron)
WORKER    ────▶  il pool di lavoratori consuma il lavoro, invoca la funzione
FAILURE     ────▶  max_attempts=1 → morto (DLQ) immediatamente, nessun tentativo
SUCCESS    ────▶  last_run + next_run aggiornati sulla riga cron
Suggerimento

Quando il servizio viene riavviato, tutti i cron attivi di tutti i progetti forniti vengono ricaricati dal database e riprogrammati: l'elenco delle attività non viene mantenuto solo nella memoria.

Cosa fornisce lo scheduler#

  • Pianificatore in-process. tokio-cron-scheduler + cron crate nelle funzioni aura: nessun servizio esterno, pianificazione in memoria riprogrammata all'avvio.
  • Ogni esecuzione è un lavoro. Il cron non esegue nulla da solo: accoda un lavoro (come Functions.invoke in modalità asincrona), consumato dallo stesso pool di lavoratori.
  • Senza riprovare. Un job creato dal cron ha max_attempts=1: un fallimento lo commuta direttamente in DLQ (morto), a differenza dei classici job asincroni (3 tentativi per default).
  • Monitoraggio ultima_esecuzione/prossima_esecuzione. Ogni trigger contrassegna la data e l'ora di last_run e precalcola next_run dall'espressione memorizzata, visibile tramite listCronJobs().

Creare, elencare, eliminare#

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

const aura = createClient(url, serviceRoleKey)

// Espressione a 5 campi (min ora giorno mese dsem) — i secondi sono
// implicitamente 0. È accettata anche un'espressione a 6 campi (con secondi).
await aura.functions.createCronJob(
  'rollup-15min',      // nome, univoco per progetto
  '*/15 * * * *',      // pianificazione
  'rollup',             // funzione richiamata ad ogni esecuzione
  { payload: { minutes: 15 } },
)

const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
Suggerimento

Il nome di un cron è univoco per progetto e funge da identificatore per la cancellazione (DELETE /v1/functions/:projectId/cron/:nom) — non c'è alcun UUID da ricordare sul lato client.

Cosa non fa (ancora) cron#

Nessun comando CLI dedicato

A differenza dei segreti delle funzioni (aura secrets), oggi non esiste alcun comando aura functions cron: la gestione delle attività pianificate passa attraverso l'SDK o l'API REST, non attraverso la CLI.

Nessun tentativo automatico

Un lavoro dal cron fallisce direttamente in dead (DLQ) al primo tentativo — max_attempts vale 1, rispetto a 3 per impostazione predefinita per un classico lavoro asincrono. Una funzione richiamata da cron deve quindi gestire le proprie riproduzioni se si vuole garantire l'operazione sottostante, oppure è necessario monitorare il DLQ (GET /v1/functions/:projectId/jobs/dlq) e riprodurre manualmente.

Per andare oltre#