Przejdź do treści
Logo Aurabase
aurabaza

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.

Objaśnienie5 min przeczytanePoziom mediatorZmieniono 15 sie 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

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.

Informacje

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.

cykl zaplanowanego biegutext
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
Wskazówka

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#

app/cron.tstypescript
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')
Wskazówka

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

Brak dedykowanego polecenia CLI

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.

Brak automatycznego ponawiania

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#