क्रॉन
क्रॉन एक्सप्रेशन पर एज फ़ंक्शन के आह्वान को शेड्यूल करें। प्रत्येक निर्धारित रन एक कार्य को एसिंक्रोनस इनवोकेशन के समान कतार में रखता है, जिसका उपभोग श्रमिकों के पूल द्वारा किया जाता है - विफलता के मामले में पुनः प्रयास किए बिना।
आपके कार्यों के लिए एक और ट्रिगर#
aura-functions सेवा सिंक्रोनस HTTP इनवोकेशन और मैन्युअल रूप से कतारबद्ध एसिंक्रोनस नौकरियों के अलावा, एक शेड्यूल पर एज फ़ंक्शन को लागू कर सकती है - /docs/functions देखें। कोई अलग "क्रॉन" फ़ंक्शन नहीं है: किसी भी तैनात फ़ंक्शन को शेड्यूल द्वारा लक्षित किया जा सकता है।
क्रॉन शेड्यूल Edge Functions (aura-functions), इन-डेटाबेस SQL जॉब नहीं (pg_cron प्रबंधित Postgres छवि में स्थापित नहीं है)। डेटाबेस रखरखाव (भौतिक दृश्य, आवधिक सफाई) के लिए, एक एज फ़ंक्शन शेड्यूल करें जो @aurabase/aurabase-js या DATABASE_URL के माध्यम से आपके डेटाबेस से जुड़ता है।
क्रॉन एक कार्य को कतारबद्ध करता है, यह फ़ंक्शन नहीं चलाता है#
क्रॉन रन सीधे फ़ंक्शन लॉन्च नहीं करता है: यह कतार में एक जॉब बनाता है (समान टेबल और POST /v1/functions/:projectId/jobs के समान वर्कर पूल), क्रॉन निर्माण के समय पेलोड जमे हुए के साथ। फिर यह काम किसी भी अन्य काम की तरह एक श्रमिक द्वारा उपभोग किया जाता है।
TRIGGER ────▶ इन-प्रोसेस शेड्यूलर निर्धारित समय पर ट्रिगर होता है
ENQUEUE ────▶ एक नौकरी बनाई गई है (फ़ंक्शन_नाम + क्रॉन पेलोड)
WORKER ────▶ वर्कर पूल कार्य का उपभोग करता है, फ़ंक्शन को आमंत्रित करता है
FAILURE ────▶ max_attempts=1 → मृत (DLQ) तुरंत, कोई पुनः प्रयास नहीं
SUCCESS ────▶ क्रॉन लाइन पर लास्ट_रन + नेक्स्ट_रन अपडेट किया गया
जब सेवा को पुनरारंभ किया जाता है, तो सभी प्रावधानित परियोजनाओं के सभी सक्रिय क्रोन को डेटाबेस से पुनः लोड किया जाता है और पुनर्निर्धारित किया जाता है - कार्य सूची केवल मेमोरी में बनी नहीं रहती है।
शेड्यूलर क्या प्रदान करता है#
- इन-प्रोसेस शेड्यूलर। टोकियो-क्रॉन-शेड्यूलर + ऑरा-फंक्शंस में क्रॉन क्रेट: कोई बाहरी सेवा नहीं, स्टार्टअप पर इन-मेमोरी शेड्यूलिंग को पुनर्निर्धारित किया गया।
- प्रत्येक रन एक कार्य है। क्रॉन स्वयं कुछ भी निष्पादित नहीं करता है: यह एक कार्य को कतारबद्ध करता है (जैसे एसिंक्रोनस मोड में function.invoke), श्रमिकों के एक ही पूल द्वारा उपभोग किया जाता है।
- पुनः प्रयास किए बिना। क्रॉन द्वारा बनाई गई नौकरी में max_attempts=1 होता है: एक विफलता इसे क्लासिक एसिंक्रोनस नौकरियों (डिफ़ॉल्ट रूप से 3 प्रयास) के विपरीत, सीधे DLQ (मृत) में बदल देती है।
- Last_run/next_run ट्रैकिंग। प्रत्येक ट्रिगर टाइमस्टैम्प Last_run पर मुहर लगाता है और संग्रहित अभिव्यक्ति से Next_run की पूर्व-गणना करता है - जो listCronJobs() के माध्यम से दिखाई देता है।
बनाएं, सूचीबद्ध करें, हटाएं#
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(url, serviceRoleKey)
// 5-फ़ील्ड अभिव्यक्ति (न्यूनतम घंटा दिन महीना डीएसईएम) - सेकंड हैं
// परोक्ष रूप से 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')
क्रॉन का नाम प्रति प्रोजेक्ट अद्वितीय है और हटाने के लिए पहचानकर्ता के रूप में कार्य करता है (DELETE /v1/functions/:projectId/cron/:nom) - क्लाइंट पक्ष पर याद रखने के लिए कोई यूयूआईडी नहीं है।
क्रॉन क्या नहीं करता (अभी तक)#
फ़ंक्शन रहस्यों (aura secrets) के विपरीत, आज कोई aura functions cron कमांड नहीं है: निर्धारित कार्यों का प्रबंधन SDK या REST API के माध्यम से होता है, CLI के माध्यम से नहीं।
क्रॉन से एक नौकरी पहले प्रयास में सीधे dead (DLQ) में विफल हो जाती है - max_attempts का मूल्य 1 है, जबकि क्लासिक एसिंक्रोनस नौकरी के लिए डिफ़ॉल्ट रूप से 3 है। यदि अंतर्निहित ऑपरेशन की गारंटी दी जानी है, तो क्रॉन-आह्वान फ़ंक्शन को अपने स्वयं के रीप्ले को संभालना होगा, या आपको डीएलक्यू (GET /v1/functions/:projectId/jobs/dlq) की निगरानी करनी होगी और मैन्युअल रूप से रीप्ले करना होगा।
आगे जाने के लिए#
- Edge Functions
रनटाइम्स, इनवोकेशन, जॉब्स, डीएलक्यू, सीक्रेट्स - वह सेवा जो क्रॉन ट्रिगर करती है।
- मेहराब
क्रॉन द्वारा लागू किए गए फ़ंक्शन में रहस्यों का एन्क्रिप्शन इंजेक्ट किया गया।
- डेटाबेस
Postgres 18 अनुमत सूचीबद्ध एक्सटेंशन, RLS और माइग्रेशन।
- जावास्क्रिप्ट एसडीके
createCronJob, listCronJobs, deleteCronJob - क्लाइंट की सटीक सतह।