Cron
Bir cron ifadesinde Edge İşlevinin çağrılmasını zamanlayın. Her zamanlanmış çalıştırma, bir işi, başarısızlık durumunda yeniden denemeye gerek kalmadan, çalışan havuzu tarafından tüketilen eşzamansız çağrılarla aynı kuyruğa koyar.
İşlevleriniz için bir tetikleyici daha#
aura-functions hizmeti, eşzamanlı HTTP çağrılarına ve manuel olarak kuyruğa alınan eşzamansız işlere ek olarak, bir zamanlamaya göre bir Uç İşlevi çağırabilir; bkz. /docs/functions. Ayrı bir "cron" işlevi yoktur: dağıtılan herhangi bir işlev bir zamanlama tarafından hedeflenebilir.
Cron, veritabanı içi SQL işlerini değil (pg_cron yönetilen Postgres görüntüsüne yüklü değil) Edge Functions (aura-functions) planları. Veritabanı bakımı için (gerçekleştirilmiş görünümler, periyodik temizlemeler), veritabanınıza @aurabase/aurabase-js veya DATABASE_URL aracılığıyla bağlanan bir Uç İşlevi planlayın.
Cron bir işi kuyruğa alır, işlevi çalıştırmaz#
Bir cron çalıştırması işlevi doğrudan başlatmaz: cron oluşturma sırasında donmuş bir yük ile kuyrukta bir işi oluşturur (POST /v1/functions/:projectId/jobs ile aynı tablolar ve aynı çalışan havuzu). Daha sonra iş, diğer işler gibi bir işçi tarafından tüketilir.
TRIGGER ────▶ süreç içi zamanlayıcı planlanan zamanda tetiklenir
ENQUEUE ────▶ bir iş yaratıldı (işlev_adı + cron yükü)
WORKER ────▶ çalışan havuzu işi tüketir, işlevi çağırır
FAILURE ────▶ max_attempts=1 → anında öldü (DLQ), yeniden deneme yok
SUCCESS ────▶ Last_run + next_run cron satırında güncellendi
Hizmet yeniden başlatıldığında, sağlanan tüm projelerin tüm etkin cron'ları veritabanından yeniden yüklenir ve yeniden planlanır; görev listesi yalnızca bellekte kalıcı olmaz.
Zamanlayıcının sağladığı şeyler#
- İşlem içi zamanlayıcı. tokio-cron-scheduler + aura işlevlerinde cron sandığı: harici hizmet yok, bellek içi zamanlama başlangıçta yeniden planlandı.
- Her çalıştırma bir iştir. Cron hiçbir şeyi kendi başına yürütmez: aynı çalışan havuzu tarafından tüketilen bir işi (eşzamansız modda Function.invoke gibi) kuyruğa alır.
- Yeniden denemeden. Cron tarafından oluşturulan bir iş max_attempts=1 değerine sahiptir: klasik eşzamansız işlerin aksine (varsayılan olarak 3 deneme), bir hata onu doğrudan DLQ'ya (ölü) geçirir.
- Son_çalışma/sonraki_çalışma takibi. Her tetikleyici, last_run zaman damgasını kaydeder ve saklanan ifadeden next_run'u önceden hesaplar — listCronJobs() yoluyla görülebilir.
Oluşturun, listeleyin, silin#
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(url, serviceRoleKey)
// 5 alanlı ifade (min saat gün ay dsem) — saniyeler
// örtülü olarak 0. 6 alanlı bir ifade (saniyelerle birlikte) de kabul edilir.
await aura.functions.createCronJob(
'rollup-15min', // ad, proje başına benzersiz
'*/15 * * * *', // planlama
'rollup', // her çalıştırmada çağrılan işlev
{ payload: { minutes: 15 } },
)
const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
Bir cronun adı proje başına benzersizdir ve silinmek üzere bir tanımlayıcı görevi görür (DELETE /v1/functions/:projectId/cron/:nom) — istemci tarafında hatırlanacak bir UUID yoktur.
Cron'un yapmadığı şey (henüz)#
İşlev gizli dizilerinin (aura secrets) aksine, bugün aura functions cron komutu yoktur: zamanlanmış görevlerin yönetimi CLI aracılığıyla değil, SDK veya REST API aracılığıyla gerçekleştirilir.
Cron'dan gelen bir iş ilk denemede doğrudan dead (DLQ) içinde başarısız olur — max_attempts değeri 1 değerindedir, klasik eşzamansız bir iş için varsayılan olarak 3'tür. Bu nedenle, temeldeki işlemin garanti edilmesi isteniyorsa, cron tarafından çağrılan bir işlevin kendi tekrarlarını yönetmesi gerekir veya DLQ'yu (GET /v1/functions/:projectId/jobs/dlq) izlemeniz ve manuel olarak tekrar oynatmanız gerekir.
Daha ileri gitmek için#
- Edge Functions
Çalışma zamanları, çağrı, işler, DLQ, sırlar — cronun tetiklediği hizmet.
- Kasa
Cron tarafından çağrılan işleve enjekte edilen sırların şifrelenmesi.
- Veritabanı
Postgres İzin verilenler listesindeki 18 uzantı, RLS ve taşıma işlemleri.
- JavaScript SDK'sı
createCronJob, listCronJobs, deleteCronJob — istemcinin tam yüzeyi.