كرون
جدولة استدعاء وظيفة Edge في تعبير cron. يضع كل تشغيل مجدول مهمة في قائمة الانتظار نفسها مثل الاستدعاءات غير المتزامنة، التي يستهلكها مجموعة العمال - دون إعادة المحاولة في حالة الفشل.
مشغل آخر لوظائفك#
يمكن لخدمة aura-functions استدعاء وظيفة Edge وفقًا لجدول زمني، بالإضافة إلى استدعاءات HTTP المتزامنة والوظائف غير المتزامنة الموضوعة في قائمة الانتظار يدويًا - راجع /docs/functions. لا توجد وظيفة "كرون" منفصلة: يمكن استهداف أي وظيفة منشورة من خلال جدول زمني.
يقوم Cron بجدولة Edge Functions (aura-functions)، وليس مهام SQL داخل قاعدة البيانات ( لم يتم تثبيت pg_cron في صورة Postgres المُدارة). لصيانة قاعدة البيانات (طرق العرض المادية، وعمليات التنظيف الدورية)، قم بجدولة وظيفة Edge التي تتصل بقاعدة البيانات الخاصة بك عبر @aurabase/aurabase-js أو DATABASE_URL.
يقوم Cron بإدراج مهمة، ولا يقوم بتشغيل الوظيفة#
لا يؤدي تشغيل cron إلى تشغيل الوظيفة مباشرة: بل يقوم بإنشاء ملف وظيفة في قائمة الانتظار (نفس الجداول ونفس تجمع العمال مثل POST /v1/functions/:projectId/jobs)، مع حمولة مجمدة في وقت إنشاء cron. ثم يستهلك العامل الوظيفة مثل أي وظيفة أخرى.
TRIGGER ────▶ يتم تشغيل المجدول قيد التشغيل في الوقت المحدد
ENQUEUE ────▶ تم إنشاء الوظيفة (اسم_الوظيفة + حمولة cron)
WORKER ────▶ يستهلك تجمع العمال الوظيفة ويستدعي الوظيفة
FAILURE ────▶ max_attempts=1 → ميت (DLQ) على الفور، بدون إعادة المحاولة
SUCCESS ────▶ تم تحديث last_run + next_run على خط cron
عند إعادة تشغيل الخدمة، تتم إعادة تحميل جميع عمليات crons النشطة لجميع المشاريع المتوفرة من قاعدة البيانات وإعادة جدولتها - ولا يتم الاحتفاظ بقائمة المهام في الذاكرة وحدها.
ما يقدمه المجدول#
- جدولة قيد التشغيل. tokio-cron-scheduler + صندوق cron في وظائف الهالة: لا توجد خدمة خارجية، تتم إعادة جدولة الجدولة في الذاكرة عند بدء التشغيل.
- كل جولة هي مهمة. لا ينفذ cron أي شيء بنفسه: فهو يضع مهمة (مثل وظائف. استدعاء في الوضع غير المتزامن)، يستهلكها نفس مجموعة العمال.
- بدون إعادة المحاولة. تحتوي المهمة التي تم إنشاؤها بواسطة cron على max_attempts=1: يؤدي الفشل إلى تحويلها مباشرة إلى DLQ (ميت)، على عكس المهام الكلاسيكية غير المتزامنة (3 محاولات افتراضيًا).
- تتبع Last_run/next_run. لكل طوابع زمنية للتشغيل last_run ويقوم بحساب next_run مسبقًا من التعبير المخزن - مرئي عبر listCronJobs().
إنشاء، قائمة، حذف#
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(url, serviceRoleKey)
// تعبير 5 حقول (دقيقة، ساعة، يوم، شهر، dsem) — ثانية
// ضمنيًا 0. يتم أيضًا قبول تعبير مكون من 6 حقول (بالثواني).
await aura.functions.createCronJob(
'rollup-15min', // اسم فريد لكل مشروع
'*/15 * * * *', // التخطيط
'rollup', // يتم استدعاء الوظيفة عند كل تشغيل
{ payload: { minutes: 15 } },
)
const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
اسم cron فريد لكل مشروع ويعمل كمعرف للحذف (DELETE /v1/functions/:projectId/cron/:nom) - لا يوجد UUID يجب تذكره من جانب العميل.
ما لا يفعله كرون (حتى الآن)#
على عكس أسرار الوظائف (aura secrets)، لا يوجد أمر aura functions cron اليوم: تتم إدارة المهام المجدولة من خلال SDK أو REST API، وليس من خلال CLI.
تفشل مهمة من cron مباشرة في dead (DLQ) في المحاولة الأولى - max_attempts تساوي 1، مقارنة بـ 3 افتراضيًا لمهمة كلاسيكية غير متزامنة. وبالتالي، يجب على الوظيفة التي تم استدعاءها cron أن تتعامل مع عمليات إعادة التشغيل الخاصة بها إذا كانت العملية الأساسية مضمونة، أو يجب عليك مراقبة DLQ (GET /v1/functions/:projectId/jobs/dlq) وإعادة التشغيل يدويًا.
للذهاب أبعد من ذلك#
- Edge Functions
أوقات التشغيل، والاستدعاء، والوظائف، وDLQ، والأسرار - الخدمة التي يطلقها cron.
- قبو
تشفير الأسرار التي يتم إدخالها في الوظيفة التي يستدعيها cron.
- قاعدة البيانات
Postgres 18 ملحقًا مدرجًا في القائمة المسموح بها، RLS وعمليات الترحيل.
- جافا سكريبت SDK
createCronJob، وlistCronJobs، وdeleteCronJob — السطح الدقيق للعميل.