Cloud Functions की जगहें

Cloud Functions एक क्षेत्रीय सुविधा है. इसका मतलब है कि आपके फ़ंक्शन को चलाने वाला इन्फ़्रास्ट्रक्चर, कुछ खास क्षेत्रों में मौजूद है. साथ ही, इसे Google मैनेज करता है, ताकि यह उन क्षेत्रों के सभी ज़ोन में उपलब्ध रहे.

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

डिफ़ॉल्ट रूप से, Firebase CLI आपके प्रोजेक्ट के कॉन्फ़िगरेशन के आधार पर, किसी क्षेत्र में फ़ंक्शन डिप्लॉय करता है. इवेंट ट्रिगर होने पर काम करने वाले फ़ंक्शन के लिए, आम तौर पर इसे ट्रिगर करने वाले डेटा सोर्स के क्षेत्र (जैसे, Cloud Firestore डेटाबेस या Cloud Storage बकेट) में डिप्लॉय किया जाता है. साथ ही, फ़ॉलबैक के तौर पर इसे us-central1 में डिप्लॉय किया जाता है.

डिप्लॉय करने के बाद, Firebase कंसोल में जाकर या firebase functions:list चलाकर, क्षेत्र की पुष्टि की जा सकती है. अगर आपको किसी फ़ंक्शन को किसी दूसरे देश/इलाके में चलाना है, तो उसका देश/इलाका बदला जा सकता है.

इन देशों और इलाकों में मान्य है

इस सेक्शन में दी गई सूचियों में, energy_savings_leaf आइकॉन से पता चलता है कि इस इलाके के लिए बिजली का उत्पादन, कम कार्बन उत्सर्जन के साथ किया जाता है. ज़्यादा जानकारी के लिए, Google Cloud क्षेत्रों के लिए कार्बन का उत्सर्जन न करने वाली ऊर्जा लेख पढ़ें.

टियर 1 की कीमत

Cloud Functions इन देशों/इलाकों में टियर 1 की कीमत पर उपलब्ध है:

टियर 2 की कीमत

Cloud Functions इन देशों/इलाकों में टीयर 2 की कीमत पर उपलब्ध है:

किसी प्रोजेक्ट के किसी क्षेत्र में मौजूद फ़ंक्शन के नाम यूनीक होने चाहिए. हालांकि, अलग-अलग क्षेत्रों या अलग-अलग प्रोजेक्ट में मौजूद फ़ंक्शन के नाम एक जैसे हो सकते हैं.

किसी क्षेत्र की जानकारी देने के सबसे सही तरीके

डिफ़ॉल्ट रूप से, Firebase CLI आपके प्रोजेक्ट के कॉन्फ़िगरेशन के आधार पर, किसी क्षेत्र में फ़ंक्शन डिप्लॉय करता है. इवेंट ट्रिगर होने पर काम करने वाले फ़ंक्शन के लिए, आम तौर पर इसे ट्रिगर करने वाले डेटा सोर्स के क्षेत्र (जैसे, Cloud Firestore डेटाबेस या Cloud Storage बकेट) में डिप्लॉय किया जाता है. इसके अलावा, फ़ॉलबैक के तौर पर इसे us-central1 में डिप्लॉय किया जाता है.

हमारा सुझाव है कि आप Firebase के डिफ़ॉल्ट सेटिंग पर भरोसा करने के बजाय, खास क्षेत्रों को सेट करें. ऐसा इसलिए, क्योंकि समय के साथ-साथ डिफ़ॉल्ट सेटिंग में बदलाव हो सकता है. रीजन सेट करते समय, हर ट्रिगर टाइप के लिए इस सेक्शन में दिए गए सुझावों का पालन करें

किसी फ़ंक्शन के चलने की जगह सेट करने के लिए, फ़ंक्शन की परिभाषा में region पैरामीटर को इस तरह सेट करें:

exports.firestoreAsia = onDocumentCreated(
  {
    document: "my-collection/{docId}",
    region: "asia-northeast1",
  },
  (event) => {},
);

# Before
@firestore_fn.on_document_created("my-collection/{docId}")
def firestore_trigger(event):
    pass

# After
@firestore_fn.on_document_created("my-collection/{docId}",
                                  region="asia-northeast1")
def firestore_trigger_asia(event):
    pass

region में कॉमा लगाकर अलग किए गए क्षेत्र की कई स्ट्रिंग पास करके, एक से ज़्यादा क्षेत्र तय किए जा सकते हैं. यह भी ध्यान दें कि बैकग्राउंड ट्रिगर के कई टाइप के लिए क्षेत्र तय करते समय, आपको क्षेत्र के साथ-साथ सही इवेंट फ़िल्टर भी तय करना होगा. ऊपर दिए गए उदाहरण में, Cloud Firestore document इवेंट को ट्रिगर करता है. Cloud Storage ट्रिगर के लिए, इवेंट फ़िल्टर bucket हो सकता है. Pub/Sub ट्रिगर के लिए, यह topic होगा. इसी तरह, अन्य ट्रिगर के लिए भी इवेंट फ़िल्टर अलग-अलग होंगे.

प्रोडक्शन ट्रैफ़िक को मैनेज करने वाले फ़ंक्शन के लिए क्षेत्र बदलने के बारे में ज़्यादा जानने के लिए, किसी फ़ंक्शन का क्षेत्र बदलना लेख पढ़ें.

एचटीटीपी और क्लाइंट-कॉल किए जा सकने वाले फ़ंक्शन

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

कॉल किए जा सकने वाले फ़ंक्शन के लिए, क्लाइंट-साइड पर जगह की जानकारी चुनने की सुविधा

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

क्लाइंट पर क्षेत्र सेट करने के लिए, शुरुआत में ही मनचाहा क्षेत्र तय करें:

lazy var functions = Functions.functions(region:"europe-west1")

@property(strong, nonatomic) FIRFunctions *functions;
// ...
self.functions = [FIRFunctions functionsWithRegion:@"europe-west1"];

var functions = firebase.app().functions('europe-west1');

private FirebaseFunctions mFunctions;
// ...
mFunctions = FirebaseFunctions.getInstance("europe-west1");

firebase::functions::Functions* functions;
// ...
functions = firebase::functions::Functions::GetInstance("europe-west1");

firebase.Functions.FirebaseFunctions functions;

functions = Firebase.Functions.FirebaseFunctions.GetInstance("europe-west1");

बैकग्राउंड फ़ंक्शन

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

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

इवेंट ट्रिगर टाइप के हिसाब से, सबसे सही क्षेत्र के सुझाव अलग-अलग होते हैं:

Cloud Firestore और Cloud Storage जगहों के आधार पर क्षेत्र चुनना

ऐसा हो सकता है कि फ़ंक्शन के लिए उपलब्ध क्षेत्र, आपके Cloud Firestore डेटाबेस और Cloud Storage बकेट के लिए उपलब्ध क्षेत्रों से पूरी तरह मेल न खाएं.

ध्यान दें कि अगर आपका फ़ंक्शन और संसाधन (डेटाबेस इंस्टेंस या Cloud Storage बकेट) अलग-अलग जगहों पर हैं, तो आपको ज़्यादा इंतज़ार करना पड़ सकता है. साथ ही, बिलिंग की लागत भी बढ़ सकती है.

यहां उन देशों/इलाकों की सूची दी गई है जहां Cloud Firestore और Cloud Storage की सुविधाएं उपलब्ध हैं. यह सूची उन मामलों के लिए है जहां एक ही देश/इलाके में दोनों सुविधाएं उपलब्ध नहीं हैं: