फ़ंक्शन शेड्यूल करें

2nd gen 1st gen

अगर आपको फ़ंक्शन को तय किए गए समय पर चलाने के लिए शेड्यूल करना है, तो onSchedule हैंडलर का इस्तेमाल करके Pub/Sub विषय बनाएं. यह विषय, Cloud Scheduler का इस्तेमाल करके उस विषय पर इवेंट ट्रिगर करता है.

शुरू करने से पहले

इस समाधान का इस्तेमाल अपने Firebase प्रोजेक्ट में करने के लिए, आपका प्रोजेक्ट Blaze प्लान पर होना चाहिए. अगर आपका प्लान पहले से ही Blaze प्लान पर नहीं है, तो अपना प्लान अपग्रेड करें.

हालांकि, बिलिंग ज़रूरी है. लेकिन, आपको कुल लागत कम लग सकती है, क्योंकि हर Cloud Scheduler जॉब की लागत 0.10 डॉलर (USD) प्रति महीना है. साथ ही, हर Google खाते के लिए तीन जॉब की अनुमति है. इसके लिए, कोई शुल्क नहीं लिया जाता. अपने अनुमानित इस्तेमाल के आधार पर लागत का अनुमान जनरेट करने के लिए, Blaze प्राइसिंग कैलकुलेटर का इस्तेमाल करें.

आपके प्रोजेक्ट के लिए, Pub/Sub और Cloud Scheduler एपीआई चालू होने चाहिए. ये सुविधाएं, ज़्यादातर Firebase प्रोजेक्ट के लिए पहले से ही चालू होनी चाहिए. Google Cloud Console में जाकर, इनकी पुष्टि की जा सकती है.

अहम जानकारी: Cloud Scheduler का इस्तेमाल करने के लिए, यह ज़रूरी था कि आपके प्रोजेक्ट में Google App Engine ऐप्लिकेशन हो. इसे सेटअप करते समय, आपसे कोई जगह चुनने के लिए कहा गया था. यह जगह, आपके प्रोजेक्ट के लिए डिफ़ॉल्ट Google Cloud संसाधनों की जगह बन गई थी (Cloud Scheduler इनमें से एक संसाधन है). इस जगह का इस्तेमाल, आपके प्रोजेक्ट में मौजूद उन संसाधनों के लिए किया जाता है जो App Engine से जुड़े हैं. इनमें आपका डिफ़ॉल्ट Cloud Firestore डेटाबेस इंस्टेंस और आपका डिफ़ॉल्ट Cloud Storage बकेट शामिल है. खास तौर पर, नाम के फ़ॉर्मैट *.appspot.com के साथ.

हालांकि, अब Cloud Scheduler और हाल ही में उपलब्ध कराए गए डिफ़ॉल्ट Cloud Storage बकेट (नाम के फ़ॉर्मैट *.firebasestorage.app के साथ) App Engine पर निर्भर नहीं हैं. इसलिए, आपको इस जगह के बारे में सिर्फ़ तब सोचना होगा, जब पहली जनरेशन के शेड्यूल किए गए फ़ंक्शन और *.appspot.com बकेट का इस्तेमाल किया जा रहा हो.

शेड्यूल किया गया फ़ंक्शन लिखना

Cloud Functions for Firebase में, शेड्यूल करने का लॉजिक आपके फ़ंक्शन कोड में मौजूद होता है. इसे डिप्लॉय करने के लिए, किसी खास शर्त को पूरा करने की ज़रूरत नहीं होती. शेड्यूल किया गया फ़ंक्शन बनाने के लिए, functions.pubsub.schedule('your schedule').onRun((context)) का इस्तेमाल करें. उदाहरण के लिए, App Engine cron.yaml सिंटैक्स का इस्तेमाल करके, हर पांच मिनट में कोई फ़ंक्शन चलाने के लिए, कुछ ऐसा करें:

exports.scheduledFunction = functions.pubsub.schedule('every 5 minutes').onRun((context) => {
  console.log('This will be run every 5 minutes!');
  return null;
});

Cloud Scheduler, Unix Crontab और App Engine सिंटैक्स, दोनों के साथ काम करता है. उदाहरण के लिए, शेड्यूल किए गए फ़ंक्शन को चलाने के लिए, Crontab का इस्तेमाल करके कोई खास टाइमज़ोन चुनने के लिए, यह तरीका अपनाएं:

exports.scheduledFunctionCrontab = functions.pubsub.schedule('5 11 * * *')
  .timeZone('America/New_York') // Users can choose timezone - default is America/Los_Angeles
  .onRun((context) => {
  console.log('This will be run every day at 11:05 AM Eastern!');
  return null;
});

timeZone की वैल्यू, tz डेटाबेस में मौजूद किसी समय क्षेत्र का नाम होना चाहिए. इस्तेमाल की जा सकने वाली प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, Cloud Scheduler रेफ़रंस देखें.

अहम जानकारी: शेड्यूल करने के लॉजिक को डिज़ाइन करने के तरीके के आधार पर, कोई फ़ंक्शन कई बार ट्रिगर हो सकता है. ऐसा तब होता है, जब पिछला इंस्टेंस अब भी चल रहा हो और अगला इंस्टेंस शुरू हो जाए.

शेड्यूल किए गए फ़ंक्शन को डिप्लॉय करना

शेड्यूल किए गए फ़ंक्शन को डिप्लॉय करने पर, उससे जुड़ी शेड्यूलर जॉब और Pub/Sub विषय अपने-आप बन जाते हैं. Firebase CLI, विषय का नाम दिखाता है. साथ ही, Google Cloud Console में जाकर, जॉब और विषय को देखा जा सकता है. विषय का नाम इस तरह रखा जाता है:

firebase-scheduled-function_name-region

उदाहरण के लिए:

firebase-scheduled-scheduledFunctionCrontab-us-east1.

अहम जानकारी: पक्का करें कि आपने कंसोल में विषय या शेड्यूलर जॉब को मैन्युअल तरीके से न मिटाया हो या उसमें बदलाव न किया हो. ऐसा करने से, शेड्यूल किए गए फ़ंक्शन को लागू करने में गड़बड़ियां हो सकती हैं.