इंस्टॉल किए गए Firebase एक्सटेंशन मैनेज करना

एक्सटेंशन इंस्टॉल या मैनेज करने के लिए, आपको इनमें से कोई एक भूमिका असाइन करनी होगी: मालिक या एडिटर या Firebase एडमिन.

Firebase कंसोल Firebase सीएलआई अपने-आप जनरेट हुआ SDK टूल

किसी प्रोजेक्ट के इंस्टॉल किए गए एक्सटेंशन इंस्टेंस की सूची बनाना

आपके पास, इंस्टॉल किए गए एक्सटेंशन के हर इंस्टेंस की सूची बनाने का विकल्प है.

एक्सटेंशन-सूची कमांड चलाएं:

firebase ext:list --project=projectId-or-alias

इंस्टॉल किए गए एक्सटेंशन इंस्टेंस की जानकारी और कॉन्फ़िगरेशन देखना

1. Firebase कंसोल में, अपने Firebase Extensions डैशबोर्ड पर जाएं.

2. इंस्टॉल किए गए एक्सटेंशन इंस्टेंस के कार्ड पर, मैनेज करें पर क्लिक करें.

इंस्टॉल किए गए एक्सटेंशन इंस्टेंस को मॉनिटर करना

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

बजट से जुड़ी सूचनाएं सेट करना

आम तौर पर, बजट की सूचनाएं सेट करना एक अच्छा तरीका है. हालांकि, सूचनाएं तब ज़्यादा अहम हो सकती हैं, जब आप अपने प्रोजेक्ट में किसी दूसरे पक्ष के कोड पर भरोसा कर रहे हों.

पक्का करें कि आपने अपने Firebase प्रोजेक्ट के लिए, बजट से जुड़ी सूचनाएं सेट अप की हों.

एक्सटेंशन से बनाए गए फ़ंक्शन देखना

1. Firebase कंसोल के Functions डैशबोर्ड पर जाएं.

2. डैशबोर्ड टैब में, Firebase Extensions के फ़ंक्शन देखे जा सकते हैं. साथ ही, अपने प्रोजेक्ट के लिए डिप्लॉय किए गए अन्य फ़ंक्शन भी देखे जा सकते हैं.

   एक्सटेंशन से बनाए गए फ़ंक्शन के नाम इस फ़ॉर्मैट में होते हैं: ext-extension-instance-id-functionName

   उदाहरण के लिए: ext-awesome-task-simplifier-onUserCreate

एक्सटेंशन की मदद से बनाई गई Cloud Scheduler नौकरियां देखना

1. Google Cloud कंसोल में, अपने प्रोजेक्ट का Cloud Scheduler पेज खोलें.

2. जॉब सूची में, Firebase Extensions की Cloud Scheduler जॉब देखी जा सकती हैं. इसके अलावा, प्रोजेक्ट के लिए बनाई गई अन्य जॉब भी देखी जा सकती हैं.

   एक्सटेंशन से बनाई गई जॉब के नाम इस फ़ॉर्मैट में होते हैं: firebase-ext-extension-instance-id-functionName

   उदाहरण के लिए: firebase-ext-awesome-task-simplifier-doTask

एक्सटेंशन के हिसाब से सूची में जोड़े गए Cloud Tasks देखना और मैनेज करना

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

आम तौर पर, ये टास्क आपके बिना किसी रुकावट के अपने-आप चलकर पूरे हो जाते हैं. हालांकि, अगर आपको किसी एक्सटेंशन के लिए, सूची में मौजूद टास्क को मैन्युअल तरीके से मैनेज करना है, तो यह तरीका अपनाएं. उदाहरण के लिए, सूची को रोकना या सूची से वह टास्क हटाना जो अब तक शुरू नहीं हुआ है:

1. Firebase कंसोल के एक्सटेंशन सेक्शन में, एक्सटेंशन इंस्टेंस का ज़्यादा जानकारी वाला पेज खोलें.

2. ज़्यादा जानकारी वाले पेज पर, एपीआई और संसाधन सेक्शन खोलें. अगर एक्सटेंशन, Cloud Tasks का इस्तेमाल करता है, तो आपको Cloud Tasks की सूची वाला सेक्शन दिखेगा. इस सेक्शन में एक या उससे ज़्यादा एंट्री होंगी.

3. आपको जिस कतार को मैनेज करना है उसके लिए, कतार देखें पर क्लिक करें. इससे Google Cloud कंसोल में, सूची की जानकारी वाला पेज खुलेगा. इस पेज से, सूची में मौजूद टास्क देखे जा सकते हैं, सूची को रोका जा सकता है, सूची से टास्क हटाए जा सकते हैं वगैरह. क्लाउड टास्क दस्तावेज़ में सूची और टास्क मैनेज करना देखें.

   ध्यान दें: किसी सूची को रोका जा सकता है. हालांकि, अगर इसे बहुत देर तक रोका जाता है, तो सूची को फिर से शुरू करने पर, पुष्टि करने से जुड़ी गड़बड़ियों की वजह से टास्क पूरे नहीं हो सकते. (टास्क की पुष्टि करने की समयसीमा, सूची में शामिल होने के एक घंटे बाद खत्म हो जाती है.)
   चेतावनी: सूची को मिटाएं नहीं. एक्सटेंशन के काम करने के लिए, इसकी ज़रूरत होती है. अगर आपने गलती से सूची मिटा दी है, तो आपको यह तरीका अपनाना होगा:

   1. एक्सटेंशन का नया इंस्टेंस इंस्टॉल करें.
   2. नया इंस्टेंस इंस्टॉल करने के बाद ही, पुराना इंस्टेंस अनइंस्टॉल करें.

एक्सटेंशन की मदद से बनाए गए Cloud Secret Manager के पासवर्ड देखना

1. Google Cloud कंसोल में, अपने प्रोजेक्ट का Secret Manager पेज खोलें.

2. सीक्रेट की सूची में, आपके पास Firebase Extensions के लिए बनाए गए सीक्रेट देखने का विकल्प होता है. इसके अलावा, अपने प्रोजेक्ट के लिए बनाए गए अन्य सीक्रेट भी देखे जा सकते हैं.

   एक्सटेंशन से बनाए गए सीक्रेट के नाम इस फ़ॉर्मैट में होते हैं: ext-extension-instance-id-paramnName

   उदाहरण के लिए: ext-awesome-task-simplifier-API_KEY

   सीक्रेट को कुंजी firebase-extensions-managed से लेबल किया जाता है. इस लेबल को तब तक न हटाएं, जब तक आपको Firebase को सीक्रेट मैनेज करने से नहीं रोकना है.

यह देखना कि इंस्टॉल किया गया एक्सटेंशन सही तरीके से काम कर रहा है या नहीं

कंसोल में, फ़ंक्शन से जुड़ी सभी गड़बड़ियों की समीक्षा की जा सकती है. इनमें Firebase Extensions से बनाई गई गड़बड़ियां भी शामिल हैं.

1. फ़ंक्शन डैशबोर्ड के स्थिति टैब में, अपने प्रोजेक्ट के सभी फ़ंक्शन की गड़बड़ियों और परफ़ॉर्मेंस की खास जानकारी देखी जा सकती है.

2. किसी खास एक्सटेंशन की जानकारी देखने के लिए, पेज पर सबसे ऊपर मौजूद फ़िल्टर का इस्तेमाल करके कोई फ़ंक्शन चुनें.

यह देखना कि इंस्टॉल किया गया एक्सटेंशन कितनी बार चल रहा है

1. फ़ंक्शन डैशबोर्ड के डैशबोर्ड टैब में, उस Firebase Extension के लिए खास फ़ंक्शन ढूंढें जिसकी आपको जांच करनी है.

2. एंट्री की सबसे दाईं ओर मौजूद (ओवरफ़्लो मेन्यू) पर क्लिक करें. इसके बाद, इस्तेमाल से जुड़े ज़्यादा आंकड़े चुनें.

3. दिखाए गए Google Cloud कंसोल में, किसी फ़ंक्शन के अलग-अलग कॉल में ड्रिल-डाउन किया जा सकता है. साथ ही, उसके सोर्स कोड की जांच भी की जा सकती है.

किसी एक्सटेंशन के लॉग देखना

अगर आपको अपने प्रोजेक्ट को डीबग करना है या Firebase में गड़बड़ी की रिपोर्ट सबमिट करनी है, तो अपने प्रोजेक्ट में चल रहे फ़ंक्शन के लॉग देखना मददगार हो सकता है.

अपने फ़ंक्शन डैशबोर्ड के लॉग टैब में, पेज पर सबसे ऊपर मौजूद फ़िल्टर का इस्तेमाल करके, अपने एक्सटेंशन से बनाए गए फ़ंक्शन चुनें.

इंस्टॉल किए गए एक्सटेंशन इंस्टेंस को नए वर्शन पर अपडेट करना

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

ध्यान दें: अगर आपने अपने-आप जनरेट हुए एसडीके टूल का इस्तेमाल करके कोई एक्सटेंशन इंस्टॉल किया है, तो उसे अपग्रेड करने के लिए उसी तरीके का इस्तेमाल करें. कंसोल या सीएलआई का इस्तेमाल न करें.

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

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

1. अपने Firebase Extensions डैशबोर्ड पर जाएं. इसके बाद, इंस्टॉल किए गए एक्सटेंशन इंस्टेंस के कार्ड पर, मैनेज करें पर क्लिक करें.

2. सबसे ऊपर दाएं कोने में, एक्सटेंशन अपडेट करें पर क्लिक करें.

   अगर एक्सटेंशन का नया वर्शन उपलब्ध नहीं है, तो ज़्यादा जानकारी वाले पेज पर अपडेट बटन नहीं दिखेगा.

3. अपडेट में नया क्या है, इसकी समीक्षा करें. साथ ही, ज़रूरत पड़ने पर एक्सटेंशन को कॉन्फ़िगर करें.

4. एक्सटेंशन अपडेट करें पर क्लिक करें.

इंस्टॉल किए गए एक्सटेंशन इंस्टेंस को फिर से कॉन्फ़िगर करना

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

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

1. अपने Firebase Extensions डैशबोर्ड पर जाएं. इसके बाद, इंस्टॉल किए गए एक्सटेंशन इंस्टेंस के कार्ड पर, मैनेज करें पर क्लिक करें.

2. ऊपरी दाएं कोने में, एक्सटेंशन को फिर से कॉन्फ़िगर करें पर क्लिक करें.

3. अपने एक्सटेंशन के लिए पैरामीटर वैल्यू को फिर से कॉन्फ़िगर करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.

4. सेव करें पर क्लिक करें.

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

एक्सटेंशन इंस्टेंस को अनइंस्टॉल करना

अपने Firebase प्रोजेक्ट से, एक्सटेंशन के किसी इंस्टेंस को अनइंस्टॉल किया जा सकता है. इस कार्रवाई से सेवा खाता और सभी रिसॉर्स (जैसे कि फ़ंक्शन का सेट) मिटा दिए जाते हैं जिन्हें Firebase ने एक्सटेंशन के उस इंस्टेंस के लिए खास तौर पर बनाया था. हालांकि, इनका डेटा नहीं मिटाया जाता:

• एक्सटेंशन से बनाए गए आर्टफ़ैक्ट, जैसे कि सेव की गई इमेज.

• आपके प्रोजेक्ट में मौजूद कोई अन्य संसाधन, जैसे कि डेटाबेस इंस्टेंस या Cloud Storage बकेट. भले ही, एक्सटेंशन ने इन अन्य संसाधनों के साथ इंटरैक्ट किया हो, लेकिन ये एक्सटेंशन के हिसाब से नहीं होते. इसलिए, एक्सटेंशन को अनइंस्टॉल करने पर, ये मिटते नहीं हैं.

एक्सटेंशन को अनइंस्टॉल करने का तरीका यहां बताया गया है:

1. अपने Firebase Extensions डैशबोर्ड पर जाएं. इसके बाद, इंस्टॉल किए गए एक्सटेंशन के इंस्टेंस के कार्ड पर, मैनेज करें पर क्लिक करें.

2. स्क्रीन पर सबसे नीचे, एक्सटेंशन अनइंस्टॉल करें पर क्लिक करें.

3. देखें कि क्या मिटाया जाएगा. इसके बाद, मिटाए जाने की पुष्टि करने के लिए, एक्सटेंशन अनइंस्टॉल करें पर क्लिक करें.

ध्यान दें: अगर आपने अपने-आप जनरेट किए गए SDK टूल का इस्तेमाल करके एक्सटेंशन इंस्टॉल किया है, तो अपने Cloud Functions कोड से इंस्टेंस कॉन्फ़िगरेशन को भी हटाना न भूलें.