एसिंक्रोनस फ़ंक्शन को फिर से आज़माएं

इस दस्तावेज़ में बताया गया है कि फ़ेल होने पर फिर से कोशिश करने के लिए, एसिंक्रोनस (नॉन-एचटीटीपीएस) बैकग्राउंड फ़ंक्शन का अनुरोध कैसे किया जा सकता है.

इवेंट-ड्रिवन फ़ंक्शन पूरा न होने की वजह

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

आम तौर पर, फ़ंक्शन कोड में होने वाली गड़बड़ियों की वजह से, इवेंट-ड्रिवन फ़ंक्शन पूरा नहीं हो पाता. ऐसा इन वजहों से हो सकता है:

• फ़ंक्शन में कोई गड़बड़ी है और रनटाइम में कोई अपवाद दिखता है.
• फ़ंक्शन, सेवा के एंडपॉइंट तक नहीं पहुंच पा रहा है या ऐसा करने की कोशिश करते समय टाइम आउट हो रहा है.
• फ़ंक्शन जान-बूझकर कोई अपवाद दिखाता है. उदाहरण के लिए, जब कोई पैरामीटर पुष्टि करने में विफल होता है.
• Node.js फ़ंक्शन, अस्वीकार किए गए प्रॉमिस को दिखाता है या कॉलबैक में null वैल्यू के बजाय कोई दूसरी वैल्यू पास करता है.

ऊपर बताए गए किसी भी मामले में, फ़ंक्शन काम करना बंद कर देगा और गड़बड़ी का मैसेज दिखाएगा. मैसेज जनरेट करने वाले इवेंट ट्रिगर में, फिर से कोशिश करने की नीतियां होती हैं. इन्हें अपने फ़ंक्शन की ज़रूरतों के हिसाब से बनाया जा सकता है.

'फिर से कोशिश करें' फ़ंक्शन के बारे में जानकारी

Cloud Functions, इवेंट सोर्स से उत्सर्जित हर इवेंट के लिए, इवेंट-ड्रिवन फ़ंक्शन को कम से कम एक बार चलाता है. फिर से कोशिश करने की सुविधा को कॉन्फ़िगर करने का तरीका, इस बात पर निर्भर करता है कि आपने फ़ंक्शन को कैसे बनाया है:

• Google Cloud console या Cloud Run Admin API के ज़रिए बनाए गए फ़ंक्शन के लिए, आपको इवेंट ट्रिगर को अलग से बनाना और मैनेज करना होगा. ट्रिगर में, फिर से कोशिश करने के डिफ़ॉल्ट तरीके होते हैं. इन्हें अपने फ़ंक्शन की ज़रूरतों के हिसाब से बदला जा सकता है.
• Cloud Functions v2 API की मदद से बनाए गए फ़ंक्शन, ज़रूरी इवेंट ट्रिगर को अपने-आप बना देंगे. उदाहरण के लिए, Pub/Sub विषय या Eventarc ट्रिगर. डिफ़ॉल्ट रूप से, इन ट्रिगर के लिए फिर से कोशिश करने की सुविधा बंद रहती है. इसे Cloud Functions v2 API का इस्तेमाल करके फिर से चालू किया जा सकता है.

Cloud Run की मदद से बनाए गए इवेंट-ड्रिवन फ़ंक्शन

Google Cloud console या Cloud Run Admin API की मदद से बनाए गए फ़ंक्शन के लिए, आपको इवेंट ट्रिगर को अलग से बनाना और मैनेज करना होगा. हमारा सुझाव है कि आप हर तरह के ट्रिगर के डिफ़ॉल्ट व्यवहार की समीक्षा करें:

• Eventarc फिर से कोशिश करने की नीति में, मैसेज को डिफ़ॉल्ट रूप से 24 घंटे तक सेव रखा जाता है. साथ ही, एक्सपोनेंशियल बैकऑफ़ में देरी भी होती है. इवेंट को फिर से भेजने के बारे में Eventarcदस्तावेज़ देखें.
• Pub/Sub डिफ़ॉल्ट रूप से, सभी सदस्यताओं के लिए तुरंत फिर से डिलीवरी की नीति का इस्तेमाल करता है. मैसेज भेजने में आने वाली समस्याओं को हल करने और अनुरोधों को फिर से भेजने के बारे में ज़्यादा जानने के लिए, Pub/Sub दस्तावेज़ देखें.

Cloud Functions v2 API की मदद से बनाए गए इवेंट-ड्रिवन फ़ंक्शन

Cloud Functions v2 API का इस्तेमाल करके बनाए गए फ़ंक्शन. उदाहरण के लिए, Cloud Functions gcloud CLI, REST API या Terraform का इस्तेमाल करने पर, आपकी ओर से इवेंट ट्रिगर बनाए और मैनेज किए जाएंगे. डिफ़ॉल्ट रूप से, अगर किसी फ़ंक्शन को कॉल करने पर गड़बड़ी का मैसेज मिलता है, तो फ़ंक्शन को फिर से कॉल नहीं किया जाता और इवेंट को ड्रॉप कर दिया जाता है. किसी इवेंट-ड्रिवन फ़ंक्शन पर फिर से कोशिश करने की सुविधा चालू करने पर, Cloud Functions उस फ़ंक्शन को तब तक फिर से आज़माता है, जब तक वह पूरी तरह से काम नहीं कर जाता या फिर से कोशिश करने की विंडो खत्म नहीं हो जाती.

चेतावनी: "कार्रवाई पूरी न होने पर फिर से कोशिश करें" सेट करने पर, आपके फ़ंक्शन को बार-बार तब तक दोहराया जाता है, जब तक वह पूरा नहीं हो जाता या फिर से कोशिश करने की तय अवधि खत्म नहीं हो जाती. यह अवधि कई दिन की हो सकती है. अगर गड़बड़ी किसी गड़बड़ी या किसी दूसरी तरह की हमेशा की गड़बड़ी की वजह से होती है, तो आपका फ़ंक्शन फिर से कोशिश करने वाले लूप में फंस सकता है. आपको इस सेटिंग का इस्तेमाल सिर्फ़ तब करना चाहिए, जब आपको अस्थायी गड़बड़ियों (जैसे, अविश्वसनीय एंडपॉइंट या बीच-बीच में टाइम आउट) का सामना करना पड़े. साथ ही, इस प्रॉपर्टी के सेट के बिना अपने कोड की जांच करने के बाद ही ऐसा करना चाहिए. अगर आपका फ़ंक्शन फिर से कोशिश करने वाले लूप में फंस जाता है, तो उसे फिर से डिप्लॉय करें या उसे मिटाएं, ताकि फ़ंक्शन का इस्तेमाल बंद किया जा सके.

जब किसी फ़ंक्शन के लिए फिर से कोशिश करने की सुविधा चालू नहीं होती है, जो डिफ़ॉल्ट रूप से होती है, तो फ़ंक्शन हमेशा यह रिपोर्ट करता है कि वह सही तरीके से लागू हुआ है. साथ ही, उसके लॉग में 200 OK रिस्पॉन्स कोड दिख सकते हैं. यह तब भी होता है, जब फ़ंक्शन में कोई गड़बड़ी होती है. जब आपके फ़ंक्शन में कोई गड़बड़ी आती है, तो यह साफ़ तौर पर बताने के लिए, गड़बड़ियों की सही तरीके से शिकायत करें.

फिर से कोशिश करने की सुविधा को चालू या बंद करना

अपने फ़ंक्शन कोड से, फिर से कोशिश करने की सुविधा कॉन्फ़िगर करना

Cloud Functions for Firebase का इस्तेमाल करके, किसी फ़ंक्शन के लिए कोड में फिर से कोशिश करने की सुविधा चालू की जा सकती है. functions.foo.onBar(myHandler); जैसे बैकग्राउंड फ़ंक्शन के लिए ऐसा करने के लिए, runWith का इस्तेमाल करें और गड़बड़ी की नीति कॉन्फ़िगर करें:

functions.runWith({failurePolicy: true}).foo.onBar(myHandler);

true को दिखाए गए तरीके से सेट करने पर, फ़ंक्शन को गड़बड़ी होने पर फिर से कोशिश करने के लिए कॉन्फ़िगर किया जाता है.

फिर से कोशिश करने की विंडो

दूसरे जनरेशन के फ़ंक्शन के लिए, फिर से कोशिश करने की यह विंडो 24 घंटे बाद खत्म हो जाती है. पहले जनरेशन के फ़ंक्शन के लिए, यह लिंक सात दिन के बाद काम नहीं करेगा. Cloud Functions, एक्सपोनेंशियल बैकऑफ़ की रणनीति का इस्तेमाल करके, नए बनाए गए इवेंट-ड्रिवन फ़ंक्शन को फिर से आज़माता है. इसमें बैकऑफ़ की अवधि 10 से 600 सेकंड के बीच बढ़ती है. यह नीति, नए फ़ंक्शन को पहली बार डिप्लॉय करने पर लागू होती है. यह उन मौजूदा फ़ंक्शन पर लागू नहीं होता जिन्हें इस रिलीज़ नोट में बताए गए बदलावों के लागू होने से पहले डिप्लॉय किया गया था. भले ही, आपने फ़ंक्शन को फिर से डिप्लॉय किया हो.

सबसे सही तरीके

इस सेक्शन में, फिर से कोशिश करने के सबसे सही तरीकों के बारे में बताया गया है.

कुछ समय के लिए होने वाली गड़बड़ियों को ठीक करने के लिए, फिर से कोशिश करें

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

बार-बार कोशिश करने के लूप से बचने के लिए, खत्म होने की शर्त सेट करें

दोबारा कोशिश करने की सुविधा का इस्तेमाल करते समय, अपने फ़ंक्शन को लगातार लूप होने से बचाने के लिए, यह सबसे सही तरीका है. ऐसा करने के लिए, फ़ंक्शन की प्रोसेसिंग शुरू होने से पहले, फ़ंक्शन के खत्म होने की शर्त को शामिल करें. ध्यान दें कि यह तरीका सिर्फ़ तब काम करता है, जब आपका फ़ंक्शन सही तरीके से शुरू हो और वह आखिरी शर्त का आकलन कर सके.

किसी तय समय से पहले के टाइमस्टैंप वाले इवेंट को हटाना, एक आसान और असरदार तरीका है. इससे, गड़बड़ियों के लगातार होने या उम्मीद से ज़्यादा समय तक होने पर, ज़रूरत से ज़्यादा बार ट्रिगर होने से बचा जा सकता है.

उदाहरण के लिए, यह कोड स्निपेट 10 सेकंड से पुराने सभी इवेंट को खारिज कर देता है:

const eventAgeMs = Date.now() - Date.parse(event.timestamp);
const eventMaxAgeMs = 10000;
if (eventAgeMs > eventMaxAgeMs) {
  console.log(`Dropping event ${event} with age[ms]: ${eventAgeMs}`);
  callback();
  return;
}

Promises के साथ catch का इस्तेमाल करना

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

यहां एक उदाहरण दिया गया है कि आपको क्या करना चाहिए:

return doFooAsync().catch((err) => {
    if (isFatal(err)) {
        console.error(`Fatal error ${err}`);
    }
    return Promise.reject(err);
});

इवेंट-ड्रिवन फ़ंक्शन को दोबारा कोशिश करने लायक बनाना

इवेंट-ड्रिवन फ़ंक्शन, दोबारा आज़माए जा सकते हैं. हालांकि, इन फ़ंक्शन को एक बार आज़माने पर ही नतीजा मिलना चाहिए. इस तरह के फ़ंक्शन को आइडेंटिटेम होने के लिए, यहां कुछ सामान्य दिशा-निर्देश दिए गए हैं:

• कई बाहरी एपीआई (जैसे, Stripe) आपको पैरामीटर के तौर पर, एक जैसी जानकारी देने वाली कुंजी की वैल्यू देने की सुविधा देते हैं. अगर किसी ऐसे एपीआई का इस्तेमाल किया जा रहा है, तो आपको इवेंट आईडी को डुप्लीकेट डेटा को रोकने वाली कुंजी के तौर पर इस्तेमाल करना चाहिए.
• एक बार डिलीवरी करने की सुविधा के साथ, एक ही काम दोबारा करने की सुविधा अच्छी तरह से काम करती है. ऐसा इसलिए, क्योंकि इससे फिर से कोशिश करने में कोई खतरा नहीं होता. इसलिए, भरोसेमंद कोड लिखने के लिए सबसे सही तरीका यह है कि आप दोबारा कोशिश करने की सुविधा के साथ, एक ही काम दो बार न होने की सुविधा को जोड़ें.
• पक्का करें कि आपका कोड, इंटरनल तौर पर एक जैसा हो. उदाहरण के लिए:
  • पक्का करें कि नतीजे में बदलाव किए बिना, एक से ज़्यादा बार म्यूटेशन हो सकते हैं.
  • स्टेटस में बदलाव करने से पहले, किसी लेन-देन में डेटाबेस की स्थिति के बारे में क्वेरी करें.
  • पक्का करें कि सभी साइड इफ़ेक्ट, खुद ही आइडेंटिकेट करने वाले हों.
• कोड से अलग, फ़ंक्शन के बाहर लेन-देन की जांच लागू करें. उदाहरण के लिए, किसी इवेंट आईडी को पहले से प्रोसेस किया जा चुका है, इस जानकारी को रिकॉर्ड करने के लिए, किसी जगह पर स्टेटस को सेव करें.
• डुप्लीकेट फ़ंक्शन कॉल को बाहरी तरीके से मैनेज करना. उदाहरण के लिए, एक अलग क्लीन अप प्रोसेस बनाएं, जो डुप्लीकेट फ़ंक्शन कॉल के बाद क्लीन अप करती हो.

फिर से कोशिश करने की नीति कॉन्फ़िगर करना

अपने फ़ंक्शन की ज़रूरतों के आधार पर, हो सकता है कि आप फिर से कोशिश करने की नीति को सीधे तौर पर कॉन्फ़िगर करना चाहें. इससे, इनमें से किसी भी कॉम्बिनेशन को सेट अप किया जा सकता है:

• फिर से कोशिश करने की समयसीमा को 7 दिन से कम करके, 10 मिनट कर दिया गया है.
• एक्सपोनेंशियल बैकऑफ़ फिर से कोशिश करने की रणनीति के लिए, बैकऑफ़ का कम से कम और ज़्यादा से ज़्यादा समय बदलें.
• फिर से कोशिश करने की रणनीति को तुरंत कोशिश करने के लिए बदलें.
• डेड-लेटर विषय कॉन्फ़िगर करें.
• डिलीवरी की कोशिशों की ज़्यादा से ज़्यादा और कम से कम संख्या सेट करें.

फिर से कोशिश करने की नीति कॉन्फ़िगर करने के लिए:

1. एचटीटीपी फ़ंक्शन लिखें.
2. Pub/Sub सदस्यता बनाने के लिए, Pub/Sub एपीआई का इस्तेमाल करें. साथ ही, फ़ंक्शन के यूआरएल को टारगेट के तौर पर बताएं.

Pub/Sub को सीधे कॉन्फ़िगर करने के बारे में ज़्यादा जानने के लिए, Pub/Sub के काम न करने की समस्या को हल करने के बारे में दस्तावेज़ देखें.