रिमोट कॉन्फ़िगरेशन टेंप्लेट और वर्शनिंग

Remote Config टेंप्लेट, JSON फ़ॉर्मैट में पैरामीटर और शर्तों के सेट होते हैं. इन्हें आपके Firebase प्रोजेक्ट के लिए बनाया जाता है. Remote Config, कॉन्फ़िगरेशन को टेंप्लेट में व्यवस्थित करता है. इन टेंप्लेट को बनाया, अपडेट, और रोल बैक किया जा सकता है. साथ ही, इनके वर्शन भी बनाए जा सकते हैं.

अपने आर्किटेक्चर के आधार पर, क्लाइंट टेंप्लेट, सर्वर टेंप्लेट या दोनों बनाए और मैनेज किए जा सकते हैं:

  • क्लाइंट टेंप्लेट: Apple, Android, Web, Flutter, Unity, और C++ प्लैटफ़ॉर्म पर क्लाइंट ऐप्लिकेशन के इंस्टेंस के लिए कॉन्फ़िगरेशन उपलब्ध कराएं. क्लाइंट टेंप्लेट, Google Analytics ऑडियंस, ऐप्लिकेशन के वर्शन, प्लैटफ़ॉर्म, डिवाइस की भाषा, देश, उपयोगकर्ता पर्सेंटाइल, और कस्टम सिग्नल के आधार पर शर्तों के साथ काम करते हैं.

  • सर्वर टेंप्लेट: Node.js, Python, Go, और Java के लिए Firebase Admin SDK का इस्तेमाल करके, Cloud Run, Cloud Functions for Firebase या कंटेनर वाले सर्वर जैसे बैकएंड एनवायरमेंट के लिए कॉन्फ़िगरेशन उपलब्ध कराएं. सर्वर टेंप्लेट, सर्वर के कस्टम सिग्नल और रैंडम पर्सेंटेज रोलआउट का इस्तेमाल करके, सर्वर-साइड पर पैरामीटर का आकलन करते हैं. इसमें इंतज़ार का समय करीब-करीब शून्य होता है.

क्लाइंट और सर्वर टेंप्लेट की तुलना करना

क्लाइंट और सर्वर टेंप्लेट, आपके Firebase प्रोजेक्ट में अलग-अलग मैनेज किए जाते हैं. क्लाइंट और सर्वर टेंप्लेट के बीच का अंतर समझने के लिए, यहां दी गई टेबल का इस्तेमाल करें:

सुविधा क्लाइंट टेंप्लेट सर्वर टेंप्लेट
टारगेट एनवायरमेंट क्लाइंट ऐप्लिकेशन (Apple, Android, Web, Flutter, Unity, C++) सर्वर एनवायरमेंट (Cloud Run, Cloud Functions for Firebase, GKE, बैकएंड सेवाएं)
इस्तेमाल किए जा सकने वाले एसडीके Firebase क्लाइंट SDK टूल Firebase Admin SDK (Node.js, Python, Go, Java)
मैनेजमेंट टूल Firebase कंसोल, Firebase सीएलआई, REST API, Firebase Admin SDK Firebase console
Console की जगह पैरामीटर और शर्तें पैरामीटर और शर्तें
टेंप्लेट के डिफ़ॉल्ट डाउनलोड इस्तेमाल किया जा सकता है (Android के लिए एक्सएमएल, iOS के लिए PLIST, वेब के लिए JSON) लागू नहीं (सर्वर कोड या बैकएंड में तय की गई डिफ़ॉल्ट वैल्यू)
ज़्यादा जानकारी वाली गाइड क्लाइंट टेंप्लेट मैनेज करना सर्वर टेंप्लेट मैनेज करना

टेंप्लेट का लाइफ़साइकल और वर्शनिंग

चाहे क्लाइंट टेंप्लेट का इस्तेमाल किया जाए या सर्वर टेंप्लेट का, Remote Config में पहले से मौजूद वर्शन कंट्रोल और लाइफ़साइकल मैनेजमेंट की सुविधा मिलती है:

वर्शन बनाना और ट्रैक करना

पैरामीटर या शर्तों को अपडेट करने पर, Remote Config एक नया वर्शन वाला Remote Config टेंप्लेट बनाता है. साथ ही, पिछले टेंप्लेट को एक वर्शन के तौर पर सेव करता है. ज़रूरत पड़ने पर, इस वर्शन को वापस लाया जा सकता है या इस पर वापस जाया जा सकता है. वर्शन नंबर, Remote Config की ओर से सेव की गई शुरुआती वैल्यू से क्रम के हिसाब से बढ़ते हैं.

सभी टेंप्लेट में एक version फ़ील्ड होता है. इसमें उस वर्शन का मेटाडेटा होता है. जैसे:

  • versionNumber: टेंप्लेट का क्रम में चलने वाला वर्शन नंबर.
  • updateTime: टेंप्लेट पब्लिश किए जाने का टाइमस्टैंप.
  • updateUser: अपडेट करने वाले उपयोगकर्ता का ईमेल पता या पहचान.
  • updateOrigin: बदलाव कैसे किया गया (उदाहरण के लिए, CONSOLE, REST_API या ADMIN_SDK_NODE).
  • updateType: बदलाव किस तरह का है (उदाहरण के लिए, INCREMENTAL_UPDATE या FORCED_UPDATE).

वर्शन की सीमाएं और उन्हें सेव रखना

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

रोलबैक

किसी भी समय, टेंप्लेट के सेव किए गए किसी भी वर्शन पर वापस जाया जा सकता है. रोलबैक करने पर, Remote Config एक नया वर्शन बनाता है. इसका कॉन्टेंट, चुने गए पुराने वर्शन से मैच करता है. उदाहरण के लिए, वर्शन 10 से वर्शन 6 पर रोल बैक करने से, वर्शन 11 बनता है. इसमें वर्शन 6 का कॉन्फ़िगरेशन होता है.

इंपोर्ट और एक्सपोर्ट

अपने चालू टेंप्लेट को JSON फ़ाइल के तौर पर डाउनलोड किया जा सकता है. साथ ही, उसे उसी प्रोजेक्ट या किसी दूसरे प्रोजेक्ट में पब्लिश किया जा सकता है. इस सुविधा की मदद से:

  • टेंप्लेट की परिभाषाओं को सोर्स कंट्रोल (जैसे, Git) में सेव करें.
  • कॉन्फ़िगरेशन डिप्लॉयमेंट को सीआई/सीडी पाइपलाइन में इंटिग्रेट करें.
  • कॉन्फ़िगरेशन को अलग-अलग स्टेज पर प्रमोट करना. उदाहरण के लिए, डेवलपमेंट या स्टेजिंग प्रोजेक्ट से प्रोडक्शन पर.
  • कॉन्फ़िगरेशन को एक प्रोजेक्ट से दूसरे प्रोजेक्ट में माइग्रेट करना.

किसी A/B Testing एक्सपेरिमेंट में वैरिएंट के तौर पर बनाए गए पैरामीटर और पैरामीटर वैल्यू, एक्सपोर्ट किए गए टेंप्लेट में शामिल नहीं की जाती हैं.

टेंप्लेट के लिए डिफ़ॉल्ट सेटिंग

क्लाइंट ऐप्लिकेशन के लिए, पैरामीटर की डिफ़ॉल्ट वैल्यू वाली फ़ाइलें एक्सएमएल, PLIST या JSON फ़ॉर्मैट में डाउनलोड की जा सकती हैं. इससे उन्हें अपने ऐप्लिकेशन के साथ बंडल किया जा सकता है. इसके बारे में निर्देश पाने के लिए, Remote Config टेंप्लेट की डिफ़ॉल्ट वैल्यू डाउनलोड करें लेख पढ़ें.

अगले चरण