एक फायरबेस एक्सटेंशन स्थापित करें

आप फायरबेस कंसोल या फायरबेस सीएलआई (कमांड-लाइन इंटरफेस) का उपयोग करके किसी भी आधिकारिक फायरबेस एक्सटेंशन को इंस्टॉल (और प्रबंधित ) कर सकते हैं।

Firebase CLI और Firebase कंसोल के लिए समर्थित कार्रवाइयों में अंतर की समीक्षा करना सुनिश्चित करें।

फायरबेस कंसोल फायरबेस सीएलआई

पहली बार किसी Firebase एक्सटेंशन को आज़माने के लिए, हम अनुशंसा करते हैं कि आप किसी परीक्षण या विकास प्रोजेक्ट में एक्सटेंशन इंस्टॉल करें।

एक्सटेंशन इंस्टॉल या प्रबंधित करने के लिए, आपको इनमें से कोई एक भूमिका सौंपी जानी चाहिए: स्वामी या संपादक या Firebase व्यवस्थापक .

एक्सटेंशन इंस्टॉल करने के लिए, आपका प्रोजेक्ट ब्लेज़ (पे ऐज़ यू गो) प्लान पर होना चाहिए। हालांकि एक्सटेंशन इंस्टॉल करने के लिए कोई शुल्क नहीं है, लेकिन अगर आपका उपयोग सेवाओं के फ्री टियर से अधिक है, तो आपसे फायरबेस सेवाओं या क्लाउड सेवाओं जैसे [क्लाउड सीक्रेट मैनेजर] [गुप्त-मूल्य निर्धारण] के उपयोग के लिए शुल्क लिया जा सकता है।

शुरू करने से पहले

1. यदि आपने पहले से ऐसा नहीं किया है, तो अपने प्रोजेक्ट में Firebase जोड़ें .

2. यदि आपने पहले से ऐसा नहीं किया है, तो अपने प्रोजेक्ट को ब्लेज़ (जैसे ही भुगतान करें) योजना में अपग्रेड करें।

3. Firebase CLI के नवीनतम संस्करण को इंस्टॉल या अपडेट करें।

4. अपने फायरबेस प्रोजेक्ट आईडी या पहले कॉन्फ़िगर किए गए प्रोजेक्ट उपनाम पर ध्यान दें।

   • प्रोजेक्ट आईडी — firebase projects:list ।
   • प्रोजेक्ट उपनाम - अपने स्थानीय ऐप निर्देशिका से firebase use चलाएं।
   नोट: सीएलआई कमांड का उपयोग करके एक्सटेंशन इंस्टॉल और प्रबंधित करने के लिए, आपको --project फ्लैग का उपयोग करना होगा और अपनी प्रोजेक्ट आईडी या अपने प्रोजेक्ट उपनाम में पास करना होगा। हालांकि, अगर आपके पास पहले से ही आपकी स्थानीय ऐप निर्देशिका से संबद्ध एक फायरबेस प्रोजेक्ट है, तो आपको अपनी स्थानीय ऐप निर्देशिका से कमांड चलाते समय --project ध्वज को पारित करने की आवश्यकता नहीं है।

चरण 1 : किसी एक्सटेंशन के बारे में विस्तृत जानकारी देखें

यह कदम वैकल्पिक है, लेकिन दृढ़ता से अनुशंसित है।

Firebase एक्सटेंशन इंस्टॉल करने से पहले, हम अनुशंसा करते हैं कि आप एक्सटेंशन के बारे में विस्तृत जानकारी की समीक्षा करें, जिसमें शामिल हैं:

• एक्सटेंशन कैसे काम करता है, कोई भी प्री-इंस्टॉलेशन कार्य, और एक्सटेंशन के बारे में विवरण
• सामान्य पहचान जानकारी और विवरण
• क्या एक्सटेंशन के कार्यों के लिए बिलिंग खाते की आवश्यकता है
• संचालन के लिए आवश्यक Google सेवाएं (एपीआई) और एक्सेस भूमिकाएं
• एक्सटेंशन के लिए बनाए गए संसाधन (जैसे फ़ंक्शन)
• उपयोगकर्ता-कॉन्फ़िगर करने योग्य पैरामीटर का विवरण

किसी एक्सटेंशन की विस्तृत जानकारी देखने के लिए:

1. सुनिश्चित करें कि आपने अपना परिवेश सेट किया है और एक एक्सटेंशन चुना है .

2. अपने कंप्यूटर पर कहीं से भी एक्सटेंशन-इन्फो कमांड चलाएँ:

   firebase ext:info publisher-id/extension-id

   publisher-id और extension-id तर्क आवश्यक हैं और एक्सटेंशन के प्रीइंस्टॉल विवरण पृष्ठ पर पाए जा सकते हैं।

नोट: आप इस विस्तृत जानकारी को विस्तार निर्देशिका में शामिल README में भी देख सकते हैं।

चरण 2 : एक एक्सटेंशन स्थापित करें

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

1. सुनिश्चित करें कि आपने अपना परिवेश सेट किया है और एक एक्सटेंशन चुना है .

2. एक्सटेंशन-इंस्टॉल कमांड चलाएँ। यदि संकेत दिया जाए, तो एक्सटेंशन इंस्टेंस को अनुकूलित करने के लिए पैरामीटर मान दर्ज करें।

   firebase ext:install publisher-id/extension-id --project=projectId-or-alias

   publisher-id और extension-id तर्क आवश्यक हैं और एक्सटेंशन के प्रीइंस्टॉल विवरण पृष्ठ पर पाए जा सकते हैं।

   नोट: किसी एक्सटेंशन को इंस्टॉल और प्रोविज़न करने में सिस्टम को 3-5 मिनट लग सकते हैं।

   अधिष्ठापन के दौरान पैरामीटर मानों के लिए इंटरेक्टिव टर्मिनल संकेतों को बायपास करें

   1. एक .env फ़ाइल बनाएँ (उदाहरण के लिए, params.env ) जो आपके पैरामीटर मानों को परिभाषित करती है। फ़ाइल को स्थानीय रूप से सहेजें।

      • प्रत्येक पैरामीटर को एक्सटेंशन के extension.yaml .yaml फ़ाइल में पाए जाने वाले उसके param मान के आधार पर घोषित करें।
      • सभी मापदंडों के लिए मान शामिल करें।
      • dotenv सिंटैक्स का पालन करें।

      उदाहरण के लिए, अनुवाद टेक्स्ट एक्सटेंशन के लिए, आप यह .env फ़ाइल बना सकते हैं:

      # params.env
      
      LOCATION=us-east1
      LANGUAGES=fr,es
      COLLECTION_PATH=translations
      INPUT_FIELD_NAME=input
      OUTPUT_FIELD_NAME=output
      

   2. --params ध्वज के साथ एक्सटेंशन-इंस्टॉल कमांड चलाएँ। उदाहरण के लिए, अनुवाद टेक्स्ट एक्सटेंशन को स्थापित करने के लिए, निम्न आदेश चलाएँ:

      firebase ext:install firebase/firestore-translate-text --params=path/to/params.env --project=projectID-or-alias

चरण 3 : पूर्ण पोस्ट-इंस्टॉल सेटअप

कुछ एक्सटेंशन का उपयोग करने से पहले आपके लिए आवश्यक या वैकल्पिक चरणों को पूरा करना होता है। फायरबेस कंसोल के एक्सटेंशन डैशबोर्ड में अपने एक्सटेंशन के पोस्ट-इंस्टॉल विवरण पृष्ठ में इन निर्देशों को ढूंढें (इंस्टॉलेशन के बाद टर्मिनल में डैशबोर्ड का विशिष्ट लिंक प्रदर्शित होता है)।

आप इन निर्देशों को एक्सटेंशन की स्रोत निर्देशिका में शामिल POSTINSTALL.md फ़ाइल में भी पा सकते हैं।

फायरबेस संसाधन बनाएं

अगर आपने एक्सटेंशन को Firebase संसाधनों (क्लाउड फायरस्टोर संग्रह, रीयलटाइम डेटाबेस पथ, क्लाउड स्टोरेज बकेट) का उपयोग करने के लिए कॉन्फ़िगर किया है जो पहले से मौजूद नहीं हैं, तो एक्सटेंशन का उपयोग करने से पहले उन्हें बनाएं।

इवेंटार्क इवेंट हैंडलर बनाएं

निष्पादन के दौरान महत्वपूर्ण घटनाएं होने पर कुछ एक्सटेंशन Eventarc पर प्रकाशित होते हैं। यदि कोई एक्सटेंशन ईवेंट प्रकाशित करता है और आपने इंस्टॉलेशन के दौरान ईवेंट को सक्षम किया है, तो आप अपने स्वयं के कस्टम लॉजिक के साथ इन ईवेंट पर प्रतिक्रिया करने वाले फ़ंक्शन लिख सकते हैं। यह उपयोगी हो सकता है, उदाहरण के लिए, लंबे समय से चल रहे कार्यों के पूरा होने पर उपयोगकर्ताओं को सूचित करने के लिए, या किसी एक्सटेंशन फ़ंक्शन के आउटपुट को पोस्ट-प्रोसेस करने के लिए।

घटनाओं की सूची (यदि कोई हो) के लिए एक्सटेंशन का दस्तावेज़ीकरण देखें।

फिर, Eventarc ईवेंट हैंडलर लिखने के बारे में जानकारी के लिए कस्टम ईवेंट ट्रिगर देखें।

महत्वपूर्ण: यदि आप निःशुल्क कोटा पार करते हैं, तो ईवेंट को सक्षम करने पर शुल्क लग सकते हैं। इवेंटार्क मूल्य निर्धारण देखें।

एकाधिक एक्सटेंशन इंस्टेंस स्थापित करें

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

अगले कदम

• Firebase कंसोल में अपने इंस्टॉल किए गए एक्सटेंशन का विवरण और कॉन्फ़िगरेशन देखें ।

• अपने इंस्टॉल किए गए एक्सटेंशन की गतिविधि की निगरानी करें, जिसमें उसके स्वास्थ्य, उपयोग और लॉग की जांच शामिल है।

• Firebase CLI का उपयोग करके, अपने इंस्टॉल किए गए एक्सटेंशन को प्रबंधित करें। आप अपने एक्सटेंशन को फिर से कॉन्फ़िगर या अनइंस्टॉल कर सकते हैं, साथ ही अपने एक्सटेंशन को नवीनतम संस्करण में अपडेट कर सकते हैं।

• Firebase कंसोल का उपयोग करके, अपने इंस्टॉल किए गए एक्सटेंशन को प्रबंधित करें। आधिकारिक फायरबेस एक्सटेंशन के लिए, आप अपने एक्सटेंशन को फिर से कॉन्फ़िगर या अनइंस्टॉल कर सकते हैं, साथ ही अपने एक्सटेंशन को नवीनतम संस्करण में अपडेट कर सकते हैं।

• सभी प्रोजेक्ट के लिए सर्वोत्तम अभ्यास के रूप में, अपने प्रोजेक्ट के लिए बजट अलर्ट सेट करना सुनिश्चित करें और Firebase कंसोल में अपने उपयोग और बिलिंग डैशबोर्ड की निगरानी करें।