एक्सटेंशन मेनिफ़ेस्ट, एक्सटेंशन इंस्टेंस और उनके कॉन्फ़िगरेशन की सूची होती है. मेनिफ़ेस्ट की मदद से, ये काम किए जा सकते हैं:
- एक्सटेंशन के कॉन्फ़िगरेशन को अन्य लोगों के साथ शेयर करना
- अपने एक्सटेंशन के कॉन्फ़िगरेशन को अलग-अलग प्रोजेक्ट के बीच कॉपी करना. जैसे, स्टेजिंग प्रोजेक्ट से प्रोडक्शन प्रोजेक्ट में कॉपी करना
- अपने सभी एक्सटेंशन एक साथ डिप्लॉय करना
- Firebase Local Emulator Suite का इस्तेमाल करके, यह जांच करें कि आपके एक्सटेंशन, आपके ऐप्लिकेशन के साथ कैसे काम करते हैं
- एक्सटेंशन के कॉन्फ़िगरेशन को सोर्स कंट्रोल में कमिट करना
- अपनी सीआई/सीडी पाइपलाइन में एक्सटेंशन शामिल करना
एक्सटेंशन मेनिफ़ेस्ट के दो हिस्से होते हैं:
आपके
firebase.jsonकाextensionsसेक्शन, जो एक्सटेंशन वर्शन के रेफ़रंस के लिए इंस्टेंस आईडी का मैप होता है. उदाहरण के लिए:{ "extensions": { "my-bigquery-extension": "firebase/firestore-bigquery-export@^0.1.18", "my-image-resizer": "firebase/storage-resize-images@^0.1.22", } }.envफ़ाइलें, जिनमें आपके एक्सटेंशन के हर इंस्टेंस का कॉन्फ़िगरेशन होता है. ये फ़ाइलें, आपके Firebase प्रोजेक्ट की डायरेक्ट्री कीextensions/सबडायरेक्ट्री में होती हैं. उदाहरण के लिए,storage-resize-imagesके किसी इंस्टेंस में, इस तरह की.envफ़ाइल हो सकती है:IMAGE_TYPE=jpeg LOCATION=us-central1 IMG_BUCKET=${param:PROJECT_ID}.firebasestorage.app IMG_SIZES=100x100 DELETE_ORIGINAL_FILE=false
एक्सटेंशन मेनिफ़ेस्ट बनाना
एक्सटेंशन मेनिफ़ेस्ट बनाने के तीन तरीके हैं:
- Firebase CLI की मदद से, एक्सटेंशन मेनिफ़ेस्ट को मैनेज करना
- किसी प्रोजेक्ट के एक्सटेंशन का कॉन्फ़िगरेशन एक्सपोर्ट करना
- मेनिफ़ेस्ट फ़ाइलों में मैन्युअल तरीके से बदलाव करना
पहले दो तरीकों के बारे में यहां बताया गया है.
Firebase CLI की मदद से, एक्सटेंशन मेनिफ़ेस्ट को मैनेज करना
प्रोजेक्ट के मौजूदा कॉन्फ़िगरेशन में बदलाव किए बिना, एक्सटेंशन मेनिफ़ेस्ट को अपडेट करने के लिए, Firebase CLI के ज़्यादातर ext: कमांड को --local विकल्प के साथ चलाया जा सकता है.
उदाहरण के लिए:
firebase ext:install --local firebase/firestore-bigquery-export
ऊपर दिया गया निर्देश चलाने पर, आपको firebase/firestore-bigquery-export एक्सटेंशन के नए वर्शन को कॉन्फ़िगर करने और कॉन्फ़िगरेशन को मेनिफ़ेस्ट में सेव करने के लिए कहा जाएगा. हालांकि, यह कॉन्फ़िगरेशन आपके प्रोजेक्ट में डिप्लॉय नहीं होगा.
यहां कुछ और कमांड के उदाहरण दिए गए हैं, जो एक्सटेंशन मेनिफ़ेस्ट में बदलाव करते हैं:
# ext:configure changes the params for an extension instance in your extensions manifest
$ firebase ext:configure my-bigquery-extension --local
# ext:update --local updates an instance in your extensions manifest
# to the latest version of that extension
$ firebase ext:update my-bigquery-extension --local
# You can also specify a version if you don't want to update to the latest version
$ firebase ext:update my-bigquery-extension firebase/firestore-bigquery-export@0.1.10 --local
# ext:uninstall --local removes an instance from your extensions manifest
$ firebase ext:uninstall my-bigquery-extension --local
किसी प्रोजेक्ट के एक्सटेंशन कॉन्फ़िगरेशन को एक्सपोर्ट करना
किसी प्रोजेक्ट के मौजूदा एक्सटेंशन कॉन्फ़िगरेशन को मेनिफ़ेस्ट में सेव करने के लिए, यह तरीका अपनाएं:
- अगर आपने अब तक ऐसा नहीं किया है, तो Firebase CLI को सेट अप करें
- शेल प्रॉम्प्ट से, प्रोजेक्ट डायरेक्ट्री में जाएं. (आपकी प्रोजेक्ट डायरेक्ट्री में
firebase.jsonफ़ाइल मौजूद है). ext:exportकमांड चलाएं:firebase ext:export
ext:export कमांड, firebase.json फ़ाइल में extensions सेक्शन जोड़ देगा. इसके अलावा, ext:export कमांड एक extensions डायरेक्ट्री बनाता है. इसमें आपके इंस्टॉल किए गए हर एक्सटेंशन इंस्टेंस के लिए, एक .env फ़ाइल होती है. इन फ़ाइलों में हर इंस्टेंस के लिए कॉन्फ़िगरेशन पैरामीटर होते हैं.
Firebase Local Emulator Suite की मदद से, एक्सटेंशन के कॉन्फ़िगरेशन की जांच करना
एक्सटेंशन मेनिफ़ेस्ट में कुछ एक्सटेंशन इंस्टेंस जोड़ने के बाद, Local Emulator Suite का इस्तेमाल करके उनकी जांच की जा सकती है.
Local Emulator Suite शुरू करें:
- Emulator Suite को इंटरैक्टिव तरीके से चलाने के लिए, यह कमांड चलाएं:
firebase emulators:start - Emulator Suite को चलाने और टेस्ट स्क्रिप्ट को लागू करने के लिए, यह कमांड चलाएं:
firebase emulators:exec my-test.sh
- Emulator Suite को इंटरैक्टिव तरीके से चलाने के लिए, यह कमांड चलाएं:
अब अगर आपके मेनिफ़ेस्ट में एक्सटेंशन इंस्टेंस मौजूद हैं, तो Local Emulator Suite उन एक्सटेंशन के सोर्स कोड को ~/.cache/firebase/extensions में डाउनलोड कर लेगा. डाउनलोड होने के बाद, Local Emulator Suite शुरू हो जाएगा. इसके बाद, बैकग्राउंड में ट्रिगर होने वाले एक्सटेंशन के किसी भी फ़ंक्शन को ट्रिगर किया जा सकेगा. साथ ही, अपने ऐप्लिकेशन को Emulator Suite से कनेक्ट किया जा सकेगा, ताकि यह टेस्ट किया जा सके कि एक्सटेंशन आपके ऐप्लिकेशन के साथ इंटिग्रेट हो रहे हैं या नहीं.
किसी प्रोजेक्ट में एक्सटेंशन कॉन्फ़िगरेशन को डिप्लॉय करना
एक्सटेंशन मेनिफ़ेस्ट में एक्सटेंशन के कुछ इंस्टेंस जोड़ने के बाद, Firebase सीएलआई का इस्तेमाल करके उसे किसी प्रोजेक्ट में डिप्लॉय किया जा सकता है. एक्सटेंशन मेनिफ़ेस्ट का इस्तेमाल करके, मेनिफ़ेस्ट में मौजूद सभी एक्सटेंशन इंस्टेंस को एक ही बार में किसी प्रोजेक्ट में इंस्टॉल, अपडेट, और कॉन्फ़िगर किया जा सकता है.
एक्सटेंशन मेनिफ़ेस्ट को डिप्लॉय करने के लिए:
- शेल प्रॉम्प्ट से, उस डायरेक्ट्री में जाएं जिसमें एक्सटेंशन का सेव किया गया कॉन्फ़िगरेशन मौजूद है. (यह वह डायरेक्ट्री है जिसमें
firebase.jsonमौजूद है. अगर आपने अभी-अभीext:exportचलाया है, तो इसका मतलब है कि आप पहले से ही सही डायरेक्ट्री में हैं.) deployकमांड चलाएं. अगर आपको मौजूदा प्रोजेक्ट के बजाय किसी दूसरे प्रोजेक्ट में एक्सटेंशन डिप्लॉय करने हैं, तो--project=भी डालें:firebase deploy --only extensions –-project=YOUR_PROJECT_ID
deploy कमांड, हर इंस्टेंस के कॉन्फ़िगरेशन की पुष्टि करेगा. साथ ही, आपसे पूछेगा कि क्या आपको अपने डेस्टिनेशन प्रोजेक्ट से ऐसे एक्सटेंशन इंस्टेंस मिटाने हैं जो firebase.json में मौजूद नहीं हैं. इसके बाद, यह आपके सभी एक्सटेंशन इंस्टेंस को डिप्लॉय करेगा.
प्रोजेक्ट के हिसाब से एक्सटेंशन के कॉन्फ़िगरेशन
सेव किए गए एक्सटेंशन कॉन्फ़िगरेशन का इस्तेमाल, कई अलग-अलग प्रोजेक्ट में किया जा सकता है: उदाहरण के लिए, स्टेजिंग प्रोजेक्ट और प्रोडक्शन प्रोजेक्ट. ऐसा करते समय, हर प्रोजेक्ट के लिए कुछ पैरामीटर वैल्यू अलग-अलग हो सकती हैं.
प्रोजेक्ट के हिसाब से बनाई गई .env फ़ाइलों की मदद से, ऐसा किया जा सकता है:
- प्रोजेक्ट के हिसाब से अलग-अलग पैरामीटर वैल्यू को
extensions/EXTENSION_INSTANCE_ID.env.YOUR_PROJECT_IDमें डालें - शेयर की गई पैरामीटर वैल्यू को
extensions/EXTENSION_INSTANCE_ID.envमें डालें.
कभी-कभी, अपने एक्सटेंशन को एम्युलेट करते समय, आपको किसी दूसरी पैरामीटर वैल्यू का इस्तेमाल करना पड़ सकता है: उदाहरण के लिए, हो सकता है कि आपको प्रोडक्शन एपीआई पासकोड के बजाय, टेस्ट एपीआई पासकोड देना पड़े. इन पैरामीटर को .local फ़ाइल में डालें:
- इम्यूलेशन के दौरान इस्तेमाल किए जाने वाले ऐसे पैरामीटर डालें जो सीक्रेट नहीं हैं
extensions/EXTENSION_INSTANCE_ID.env.local - सीक्रेट पैरामीटर वैल्यू को
extensions/EXTENSION_INSTANCE_ID.secret.localमें डालें