Cron
Planen Sie den Aufruf einer Edge-Funktion für einen Cron-Ausdruck. Bei jeder geplanten Ausführung wird ein Job in dieselbe Warteschlange wie die asynchronen Aufrufe gestellt und vom Worker-Pool verbraucht – ohne erneuten Versuch, falls ein Fehler auftritt.
Ein weiterer Auslöser für Ihre Funktionen#
Der Dienst aura-functions kann zusätzlich zu synchronen HTTP-Aufrufen und manuell in die Warteschlange gestellten asynchronen Jobs eine Edge-Funktion nach einem Zeitplan aufrufen – siehe /docs/functions. Es gibt keine separate „Cron“-Funktion: Jede bereitgestellte Funktion kann durch einen Zeitplan als Ziel ausgewählt werden.
Cron plant Edge Functions (aura-functions), keine datenbankinternen SQL-Jobs (pg_cron ist nicht im verwalteten Postgres-Image installiert). Planen Sie für die Datenbankwartung (materialisierte Ansichten, regelmäßige Bereinigungen) eine Edge-Funktion, die über @aurabase/aurabase-js oder DATABASE_URL eine Verbindung zu Ihrer Datenbank herstellt.
Cron stellt einen Job in die Warteschlange, führt die Funktion jedoch nicht aus#
Eine Cron-Ausführung startet die Funktion nicht direkt: Sie erstellt einen -Job in der Warteschlange (dieselben Tabellen und denselben Worker-Pool wie POST /v1/functions/:projectId/jobs), wobei die Nutzlast zum Zeitpunkt der Cron-Erstellung eingefroren ist. Der Job wird dann wie jeder andere Job von einem Arbeitnehmer verbraucht.
TRIGGER ────▶ Der In-Process-Planer wird zum geplanten Zeitpunkt ausgelöst
ENQUEUE ────▶ ein Job wird erstellt (Funktionsname + Cron-Payload)
WORKER ────▶ Der Worker-Pool verbraucht den Job und ruft die Funktion auf
FAILURE ────▶ max_attempts=1 → sofort tot (DLQ), kein erneuter Versuch
SUCCESS ────▶ last_run + next_run in der Cron-Zeile aktualisiert
Wenn der Dienst neu gestartet wird, werden alle aktiven Crons aller bereitgestellten Projekte neu aus der Datenbank geladen und neu geplant – die Aufgabenliste bleibt nicht nur im Speicher bestehen.
Was der Planer bereitstellt#
- In-Process-Planer. tokio-cron-scheduler + die Cron-Kiste in Aura-Funktionen: kein externer Dienst, In-Memory-Planung beim Start neu geplant.
- Jeder Lauf ist ein Job. Der Cron führt selbst nichts aus: Er stellt einen Job in die Warteschlange (wie „functions.invoke“ im asynchronen Modus), der von demselben Worker-Pool verbraucht wird.
- Ohne Wiederholung. Ein vom Cron erstellter Job hat max_attempts=1: Ein Fehler schaltet ihn direkt auf DLQ (tot), im Gegensatz zu klassischen asynchronen Jobs (standardmäßig 3 Versuche).
- Last_run/next_run-Verfolgung. Jeder Trigger versieht last_run mit einem Zeitstempel und berechnet next_run anhand des gespeicherten Ausdrucks vorab – sichtbar über listCronJobs().
Erstellen, auflisten, löschen#
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(url, serviceRoleKey)
// 5-Felder-Ausdruck (Min. Stunde, Tag, Monat, dsem) – Sekunden sind
// implizit 0. Ein 6-Felder-Ausdruck (mit Sekunden) wird ebenfalls akzeptiert.
await aura.functions.createCronJob(
'rollup-15min', // Name, eindeutig pro Projekt
'*/15 * * * *', // Planung
'rollup', // Funktion, die bei jedem Lauf aufgerufen wird
{ payload: { minutes: 15 } },
)
const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
Der Name eines Crons ist pro Projekt eindeutig und dient als Kennung zum Löschen (DELETE /v1/functions/:projectId/cron/:nom) – auf der Clientseite muss keine UUID gespeichert werden.
Was Cron (noch) nicht kann#
Im Gegensatz zu Funktionsgeheimnissen (aura secrets) gibt es heute keinen aura functions cron-Befehl: Die Verwaltung geplanter Aufgaben erfolgt über das SDK oder die REST-API, nicht über die CLI.
Ein Job vom Cron schlägt beim ersten Versuch direkt in dead (DLQ) fehl – max_attempts ist 1 wert, verglichen mit 3 standardmäßig für einen klassischen asynchronen Job. Eine durch Cron aufgerufene Funktion muss daher ihre eigenen Wiedergaben verarbeiten, wenn der zugrunde liegende Vorgang garantiert werden soll, oder Sie müssen die DLQ (GET /v1/functions/:projectId/jobs/dlq) überwachen und die Wiedergabe manuell durchführen.
Um weiter zu gehen#
- Edge Functions
Laufzeiten, Aufrufe, Jobs, DLQ, Geheimnisse – der Dienst, den der Cron auslöst.
- Tresor
Verschlüsselung von Geheimnissen, die in die von cron aufgerufene Funktion eingefügt werden.
- Datenbank
Postgres 18 Erweiterungen auf der Zulassungsliste, RLS und Migrationen.
- JavaScript-SDK
createCronJob, listCronJobs, deleteCronJob – die genaue Oberfläche des Clients.