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

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

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

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

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

extensions-list कमांड चलाएं:

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 कंसोल में, सूची की जानकारी वाला पेज खुलेगा. इस पेज से, सूची में मौजूद टास्क देखे जा सकते हैं, सूची को रोका जा सकता है, सूची से टास्क हटाए जा सकते हैं वगैरह. Cloud Tasks के दस्तावेज़ में, सूची और टास्क मैनेज करना देखें.

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

   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. एक्सटेंशन अपडेट करें पर क्लिक करें.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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