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


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

इस सेक्शन में, सर्वर टेंप्लेट के बारे में बताया गया है. क्लाइंट के हिसाब से बनाए गए टेंप्लेट के बारे में जानने के लिए, क्लाइंट टेंप्लेट पर क्लिक करें.

टेंप्लेट में बदलाव करने और उसे मैनेज करने के लिए, Firebase कंसोल का इस्तेमाल किया जा सकता है. टेंप्लेट का कॉन्टेंट देखने के लिए, DevOps और यूज़र ऐक्टिविटी > Remote Config पर जाएं. यह कॉन्टेंट, ग्राफ़िकल फ़ॉर्मैट में पैरामीटर पेज और शर्तें पेज पर दिखता है.

यहां सर्वर टेंप्लेट फ़ाइल का एक उदाहरण दिया गया है:

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    },
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

Firebase कंसोल में जाकर, वर्शन मैनेजमेंट से जुड़े ये टास्क पूरे किए जा सकते हैं (DevOps और यूज़र ऐक्टिविटी > रिमोट कॉन्फ़िगरेशन पर जाएं):

  • सेव किए गए सभी टेंप्लेट वर्शन की सूची बनाना
  • किसी खास वर्शन को वापस लाना
  • किसी क्लाइंट के वर्शन को रोल बैक करना
  • बदलाव का इतिहास पेज से Remote Config टेंप्लेट मिटाएं.

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

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

Firebase कंसोल में, DevOps और जुड़ाव > रिमोट कॉन्फ़िगरेशन > बदलाव का इतिहास पेज पर जाकर, ज़रूरत के मुताबिक Remote Config टेंप्लेट मिटाए जा सकते हैं.

Remote Config टेंप्लेट के वर्शन मैनेज करना

इस सेक्शन में, Remote Config टेंप्लेट के वर्शन मैनेज करने का तरीका बताया गया है.

Remote Config टेंप्लेट के सेव किए गए सभी वर्शन की सूची बनाना

Remote Config टेंप्लेट के सेव किए गए सभी वर्शन की सूची वापस पाई जा सकती है. ऐसा करने के लिए:

  1. Firebase कंसोल में, DevOps और जुड़ाव > रिमोट कॉन्फ़िगरेशन > पैरामीटर पेज पर जाएं.

  2. सबसे ऊपर दाईं ओर मौजूद, "घड़ी" आइकॉन को चुनें.

    इससे बदलाव का इतिहास पेज खुलता है. इस पेज पर, सेव किए गए सभी टेंप्लेट वर्शन दाईं ओर मौजूद सूची वाले मेन्यू में दिखते हैं.

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

Remote Config टेंप्लेट का कोई खास वर्शन वापस पाना

Remote Config टेंप्लेट के सेव किए गए किसी भी वर्शन को वापस लाया जा सकता है. सेव किए गए टेंप्लेट वर्शन को वापस पाने का तरीका यहां बताया गया है:

  1. Firebase कंसोल में, DevOps और जुड़ाव > रिमोट कॉन्फ़िगरेशन > बदलाव का इतिहास पेज पर जाएं.

  2. डिफ़ॉल्ट रूप से, पेज पर मौजूदा ऐक्टिव टेंप्लेट दिखता है. कोई दूसरा वर्शन देखने के लिए, दाईं ओर मौजूद 'जानकारी' पैनल से उसे चुनें.

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

Remote Config टेंप्लेट के सेव किए गए किसी खास वर्शन पर रोल बैक करें

टेंप्लेट के सेव किए गए किसी भी वर्शन पर वापस जाया जा सकता है. टेम्प्लेट को रोल बैक करने का तरीका यहां बताया गया है:

  1. Firebase कंसोल में, DevOps और जुड़ाव > रिमोट कॉन्फ़िगरेशन > बदलाव का इतिहास पेज पर जाएं.

  2. पेज पर सबसे ऊपर दाईं ओर मौजूद, विकल्प बटन ढूंढें. यह बटन, टेंप्लेट के उन पिछले वर्शन के लिए होता है जिन्हें वापस लाया जा सकता है.

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

ध्यान दें कि रोलबैक करने पर, नंबर वाला नया वर्शन बन जाता है. उदाहरण के लिए, वर्शन 10 से वर्शन 6 पर वापस जाने पर, वर्शन 6 की एक नई कॉपी बन जाती है. यह ओरिजनल कॉपी से सिर्फ़ इस मामले में अलग होती है कि इसका वर्शन नंबर 11 होता है. ओरिजनल वर्शन 6 अब भी सेव रहेगा. हालांकि, ऐसा तब तक होगा, जब तक इसकी समयसीमा खत्म नहीं हो जाती. साथ ही, वर्शन 11 ऐक्टिव टेंप्लेट बन जाएगा.

Remote Config टेंप्लेट मिटाना

Firebase कंसोल का इस्तेमाल करके, Remote Config टेंप्लेट मिटाए जा सकते हैं. टेंप्लेट मिटाने का तरीका यहां दिया गया है:

  1. Firebase कंसोल में, DevOps और जुड़ाव > रिमोट कॉन्फ़िगरेशन > पैरामीटर पेज पर जाएं.

  2. बदलाव का इतिहास पर क्लिक करें.

  3. उस टेंप्लेट पर टॉगल करें जिसे आपको मिटाना है. इसके बाद, ज़्यादा पर क्लिक करें. फिर, मिटाएं को चुनें.

  4. मिटाने की पुष्टि करने के लिए, मिटाएं पर क्लिक करें.

Remote Config टेंप्लेट डाउनलोड और पब्लिश करना

Remote Config टेंप्लेट डाउनलोड और पब्लिश करें, ताकि उन्हें अपने सोर्स कंट्रोल और बिल्ड सिस्टम में इंटिग्रेट किया जा सके. साथ ही, कॉन्फ़िगरेशन अपडेट अपने-आप होने की सुविधा चालू की जा सके. इसके अलावा, कई प्रोजेक्ट में पैरामीटर और वैल्यू को सिंक में रखा जा सके.

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

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

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

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

Remote Config टेंप्लेट एक्सपोर्ट और इंपोर्ट करने के लिए:

  1. मौजूदा Remote Config कॉन्फ़िगरेशन टेंप्लेट डाउनलोड करें.
  2. Remote Config टेंप्लेट की पुष्टि करें.
  3. Remote Config टेंप्लेट को पब्लिश करें.

मौजूदा Remote Config टेंप्लेट डाउनलोड करें

मौजूदा Remote Config टेंप्लेट को JSON फ़ॉर्मैट में डाउनलोड करने के लिए, इसका इस्तेमाल करें:

  1. Firebase कंसोल में, DevOps और जुड़ाव > रिमोट कॉन्फ़िगरेशन > पैरामीटर या स्थितियां पेज पर जाएं.

  2. मेन्यू खोलें और मौजूदा कॉन्फ़िगरेशन फ़ाइल डाउनलोड करें को चुनें.

  3. जब आपसे कहा जाए, तब कॉन्फ़िगरेशन फ़ाइल डाउनलोड करें पर क्लिक करें. इसके बाद, वह जगह चुनें जहां आपको फ़ाइल सेव करनी है. इसके बाद, सेव करें पर क्लिक करें.

रिमोट कॉन्फ़िगरेशन टेंप्लेट की पुष्टि करना

Firebase कंसोल से पब्लिश करने की कोशिश करते समय, सर्वर टेंप्लेट की पुष्टि की जाती है. ध्यान दें कि 'उपयोगकर्ता को रैंडम प्रतिशत में बांटें' की शर्तों को इंपोर्ट किया जा सकता है. हालांकि, इंपोर्ट नहीं की जा सकने वाली किसी भी शर्त को अपलोड करने के दौरान गड़बड़ी होगी. अगर आपको ऐसे टेंप्लेट को पब्लिश करना है जिसे क्लाइंट टेंप्लेट से एक्सपोर्ट किया गया था, तो पक्का करें कि आपने क्लाइंट से जुड़ी सभी शर्तें हटा दी हों.

Remote Config टेंप्लेट पब्लिश करना

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

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

पब्लिश करने के बाद, पैरामीटर और वैल्यू में किए गए बदलाव, आपके ऐप्लिकेशन और उपयोगकर्ताओं के लिए तुरंत उपलब्ध हो जाते हैं. अगर ज़रूरी हो, तो पिछले वर्शन पर रोल बैक करें.

अपने टेंप्लेट को पब्लिश करने के लिए, इन कमांड का इस्तेमाल करें:

  1. Firebase कंसोल में, DevOps और जुड़ाव > रिमोट कॉन्फ़िगरेशन > पैरामीटर या स्थितियां पेज पर जाएं.

  2. मेन्यू खोलें और किसी फ़ाइल से पब्लिश करें को चुनें.

  3. जब कहा जाए, तब ब्राउज़ करें पर क्लिक करें. इसके बाद, उस Remote Config फ़ाइल पर जाएं जिसे पब्लिश करना है और उसे चुनें. इसके बाद, चुनें पर क्लिक करें.

  4. फ़ाइल की पुष्टि की जाएगी. अगर पुष्टि हो जाती है, तो कॉन्फ़िगरेशन को तुरंत अपने ऐप्लिकेशन और उपयोगकर्ताओं के लिए उपलब्ध कराने के लिए, पब्लिश करें पर क्लिक करें.

अगले चरण