İçeriğe geç
Aurabase Logosu
aura tabanı

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.

Açıklama5 dk. okuSeviye orta düzey15 Ağu 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

İş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.

Bilgi

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.

planlanmış bir çalıştırmanın döngüsütext
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
İpucu

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#

app/cron.tstypescript
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')
İpucu

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

Özel CLI komutu yok

İş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.

Otomatik yeniden deneme yok

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#