Cron
Zaplanuj wywołanie funkcji krawędziowej w wyrażeniu cron. Każde zaplanowane uruchomienie umieszcza zadanie w tej samej kolejce, co wywołania asynchroniczne, wykorzystywane przez pulę procesów roboczych — bez konieczności ponawiania prób w przypadku niepowodzenia.
Jeszcze jeden wyzwalacz dla twoich funkcji#
Usługa aura-functions może wywoływać funkcję brzegową zgodnie z harmonogramem, oprócz synchronicznych wywołań HTTP i ręcznie umieszczanych w kolejce zadań asynchronicznych — zobacz /docs/functions. Nie ma osobnej funkcji „cron”: każda wdrożona funkcja może być objęta harmonogramem.
Harmonogramy Cron Edge Functions (aura-functions), a nie zadania SQL w bazie danych (pg_cron nie jest zainstalowany w zarządzanym obrazie Postgres). W celu konserwacji bazy danych (widoki zmaterializowane, okresowe czyszczenie) zaplanuj funkcję Edge, która łączy się z bazą danych za pośrednictwem @aurabase/aurabase-js lub DATABASE_URL.
Cron kolejkuje zadanie, ale nie uruchamia funkcji#
Uruchomienie cron nie uruchamia tej funkcji bezpośrednio: tworzy plik stanowisko w kolejce (te same tabele i ta sama pula procesów roboczych co POST /v1/functions/:projectId/jobs), z ładunkiem zablokowanym w momencie tworzenia cron. Praca jest następnie konsumowana przez pracownika, jak każda inna praca.
TRIGGER ────▶ program planujący w procesie uruchamia się w zaplanowanym czasie
ENQUEUE ────▶ tworzone jest zadanie (nazwa_funkcji + ładunek cron)
WORKER ────▶ pula procesów roboczych zużywa zadanie, wywołuje funkcję
FAILURE ────▶ max_attempts=1 → natychmiast martwy (DLQ), bez ponawiania próby
SUCCESS ────▶ last_run + next_run zaktualizowane w linii cron
Po ponownym uruchomieniu usługi wszystkie aktywne crony wszystkich udostępnionych projektów zostaną ponownie załadowane z bazy danych i przełożony harmonogram — lista zadań nie zostanie utrwalona wyłącznie w pamięci.
Co zapewnia harmonogram#
- Harmonogram w procesie. tokio-cron-scheduler + skrzynka cron w funkcjach aury: brak usług zewnętrznych, harmonogram w pamięci przesunięty podczas uruchamiania.
- Każde uruchomienie jest zadaniem. Cron sam niczego nie wykonuje: umieszcza w kolejce zadanie (np.function.invoke w trybie asynchronicznym), wykorzystywane przez tę samą pulę procesów roboczych.
- Bez ponownej próby. Zadanie utworzone przez cron ma max_attempts=1: awaria przełącza je bezpośrednio do DLQ (martwe), w przeciwieństwie do klasycznych zadań asynchronicznych (domyślnie 3 próby).
- Śledzenie ostatniego/następnego_biegu. Każdy wyzwalacz oznacza znacznik czasu last_run i wstępnie oblicza next_run na podstawie zapisanego wyrażenia — widoczne poprzez listCronJobs().
Twórz, wymieniaj, usuwaj#
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(url, serviceRoleKey)
// Wyrażenie 5-polowe (min. godzina, dzień, miesiąc dsem) — sekundy
// domyślnie 0. Akceptowane jest również wyrażenie składające się z 6 pól (z sekundami).
await aura.functions.createCronJob(
'rollup-15min', // nazwa, unikalna dla każdego projektu
'*/15 * * * *', // planowanie
'rollup', // funkcja wywoływana przy każdym uruchomieniu
{ payload: { minutes: 15 } },
)
const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
Nazwa crona jest unikalna dla każdego projektu i służy jako identyfikator do usunięcia (DELETE /v1/functions/:projectId/cron/:nom) — po stronie klienta nie ma identyfikatora UUID do zapamiętania.
Czego cron nie robi (jeszcze)#
W przeciwieństwie do sekretów funkcji (aura secrets), obecnie nie ma komendy aura functions cron: zarządzanie zaplanowanymi zadaniami odbywa się za pośrednictwem pakietu SDK lub interfejsu API REST, a nie interfejsu CLI.
Zadanie z cron kończy się niepowodzeniem bezpośrednio w dead (DLQ) przy pierwszej próbie — max_attempts jest warte 1 w porównaniu do domyślnej wartości 3 w przypadku klasycznego zadania asynchronicznego. Funkcja wywoływana przez cron musi zatem obsługiwać własne powtórki, jeśli ma być zagwarantowana podstawowa operacja, lub musisz monitorować DLQ (GET /v1/functions/:projectId/jobs/dlq) i odtwarzać ręcznie.
Aby pójść dalej#
- Edge Functions
Środowisko wykonawcze, wywołanie, zadania, DLQ, sekrety — usługa uruchamiana przez cron.
- Sklepienie
Szyfrowanie sekretów wstrzykiwanych do funkcji wywoływanej przez cron.
- Baza danych
Postgres 18 rozszerzeń z listy dozwolonych, RLS i migracje.
- SDK JavaScriptu
createCronJob, listCronJobs, DeleteCronJob — dokładna powierzchnia klienta.