Naar de inhoud springen
Aurabase-logo
aurabasis

Cron

Plan de aanroep van een Edge-functie op een cron-expressie. Bij elke geplande uitvoering wordt een taak in dezelfde wachtrij geplaatst als de asynchrone aanroepen, die worden verbruikt door de pool van werkers, zonder dat er opnieuw wordt geprobeerd in geval van een mislukking.

Uitleg5 min lezenNiveau tussenproductHerzien op 15 aug 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Nog een trigger voor uw functies#

De aura-functions service kan volgens een schema een Edge-functie aanroepen, naast synchrone HTTP-aanroepen en handmatig in de wachtrij geplaatste asynchrone taken - zie /docs/functions. Er is geen aparte “cron”-functie: elke geïmplementeerde functie kan het doelwit zijn van een planning.

Info

Cron plant Edge Functions (aura-functions), geen SQL-taken in de database (pg_cron is niet geïnstalleerd in de beheerde Postgres-image). Voor databaseonderhoud (gematerialiseerde weergaven, periodieke opschoningen) kunt u een Edge-functie plannen die verbinding maakt met uw database via @aurabase/aurabase-js of DATABASE_URL.

Cron plaatst een taak in de wachtrij, maar voert de functie niet uit#

Een cron-run start de functie niet rechtstreeks: er wordt een -taak in de wachtrij gemaakt (dezelfde tabellen en dezelfde werknemerspool als POST /v1/functions/:projectId/jobs), waarbij de payload bevroren is op het moment dat de cron wordt gemaakt. De baan wordt vervolgens door een werknemer geconsumeerd, net als elke andere baan.

cyclus van een geplande runtext
TRIGGER   ────▶  de in-procesplanner wordt op het geplande tijdstip geactiveerd
ENQUEUE   ────▶  er wordt een taak aangemaakt (function_name + cron payload)
WORKER    ────▶  de werknemerspool verbruikt de taak en roept de functie aan
FAILURE     ────▶  max_attempts=1 → dood (DLQ) onmiddellijk, geen nieuwe poging
SUCCESS    ────▶  last_run + next_run bijgewerkt op cron-regel
Tip

Wanneer de service opnieuw wordt gestart, worden alle actieve crons van alle ingerichte projecten opnieuw uit de database geladen en opnieuw gepland. De takenlijst blijft niet alleen in het geheugen bewaard.

Wat de planner biedt#

  • Planner tijdens het proces. tokio-cron-scheduler + de cron-krat in aura-functies: geen externe service, planning in het geheugen opnieuw gepland bij het opstarten.
  • Elke run is een taak. De cron voert zelf niets uit: hij zet een taak in de wachtrij (zoals functies.invoke in de asynchrone modus), die door dezelfde pool van werkers wordt verbruikt.
  • Zonder nieuwe poging. Een taak die door de cron is gemaakt, heeft max_attempts=1: bij een fout wordt deze direct naar DLQ (dood) geschakeld, in tegenstelling tot klassieke asynchrone taken (standaard 3 pogingen).
  • Laatste_run/volgende_run bijhouden. Elke trigger geeft last_run een tijdstempel en berekent next_run vooraf op basis van de opgeslagen expressie - zichtbaar via listCronJobs().

Maken, vermelden, verwijderen#

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

const aura = createClient(url, serviceRoleKey)

// Expressie met 5 velden (min uur dag maand dsem) — seconden zijn
// impliciet 0. Een expressie met 6 velden (met seconden) wordt ook geaccepteerd.
await aura.functions.createCronJob(
  'rollup-15min',      // naam, uniek per project
  '*/15 * * * *',      // plannen
  'rollup',             // functie die bij elke run wordt aangeroepen
  { payload: { minutes: 15 } },
)

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

De naam van een cron is uniek per project en dient als identificatie voor verwijdering (DELETE /v1/functions/:projectId/cron/:nom) — er is geen UUID om te onthouden aan de clientzijde.

Wat cron (nog) niet doet#

Geen speciale CLI-opdracht

In tegenstelling tot functiegeheimen (aura secrets), is er tegenwoordig geen aura functions cron-opdracht: het beheer van geplande taken verloopt via de SDK of de REST API, niet via de CLI.

Geen automatische nieuwe poging

Een taak van de cron mislukt direct in dead (DLQ) bij de eerste poging — max_attempts is 1 waard, vergeleken met standaard 3 voor een klassieke asynchrone taak. Een door cron aangeroepen functie moet daarom zijn eigen herhalingen afhandelen als de onderliggende werking gegarandeerd moet worden, of u moet de DLQ (GET /v1/functions/:projectId/jobs/dlq) controleren en handmatig opnieuw afspelen.

Om verder te gaan#