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

टेंप्लेट का टाइप चुनें: क्लाइंट टेंप्लेट सर्वर टेंप्लेट


Remote Config टेंप्लेट, JSON फ़ॉर्मैट में पैरामीटर और शर्तों के सेट होते हैं. इन्हें आपके Firebase प्रोजेक्ट के लिए बनाया जाता है. सर्वर टेंप्लेट, Remote Config के लिए Firebase Admin SDK का इस्तेमाल करके, सर्वर इंस्टेंस को कॉन्फ़िगरेशन उपलब्ध कराते हैं. यह Node.js, Java, Python, और Go के लिए उपलब्ध है.

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

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

{
  "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-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "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 टेंप्लेट डाउनलोड और पब्लिश करें, ताकि उन्हें अपने सोर्स कंट्रोल और बिल्ड सिस्टम में इंटिग्रेट किया जा सके. साथ ही, कॉन्फ़िगरेशन के अपडेट अपने-आप होने की सुविधा चालू की जा सके. इसके अलावा, कई प्रोजेक्ट में पैरामीटर और वैल्यू को सिंक किया जा सके.

Firebase कंसोल से, फ़िलहाल चालू Remote Config टेंप्लेट को डाउनलोड किया जा सकता है. इसके बाद, एक्सपोर्ट की गई 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. जब कहा जाए, तब कॉन्फ़िगरेशन फ़ाइल डाउनलोड करें पर क्लिक करें. इसके बाद, वह जगह चुनें जहां आपको फ़ाइल सेव करनी है. इसके बाद, सेव करें पर क्लिक करें.

Remote Config टेंप्लेट की पुष्टि करना

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

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

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

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

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

अपना टेंप्लेट पब्लिश करने के लिए, यह तरीका अपनाएं:

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

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

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

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

अगले चरण