शेड्यूल किए गए फ़ंक्शन (पहली जनरेशन)

ध्यान दें: इस पेज पर पहली जनरेशन की जिस सुविधा के बारे में बताया गया है वह Cloud Functions (दूसरी जनरेशन) में भी उपलब्ध है. इसमें बेहतर सुविधाएं और परफ़ॉर्मेंस मिलती है. दूसरी जनरेशन के बारे में ज़्यादा जानने के लिए, वर्शन की तुलना देखें. इस सुविधा के लिए, दूसरी जनरेशन के गाइड पर सीधे जाने के लिए, देखें फ़ंक्शन शेड्यूल करना.

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

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

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

आपके प्रोजेक्ट के लिए, 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 सिंटैक्स का इस्तेमाल करके, हर पांच मिनट में कोई फ़ंक्शन चलाने के लिए, यह तरीका अपनाएं:App Engine

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 सिंटैक्स के साथ काम करता हैCloud Scheduler. उदाहरण के लिए, 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.

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