ऐप्लिकेशन होस्टिंग पर डिप्लॉय करने के अन्य तरीके

ज़्यादातर मामलों में, हम Firebase कंसोल से अपने-आप होने वाले रोलआउट या मैन्युअल तरीके से ट्रिगर होने वाले रोलआउट का इस्तेमाल करने का सुझाव देते हैं. हालांकि, हो सकता है कि आपको अपनी ज़रूरत के हिसाब से ज़्यादा कस्टमाइज़ किए गए डिप्लॉयमेंट फ़्लो की ज़रूरत हो. App Hosting में, कस्टम डिप्लॉयमेंट के लिए कई विकल्प मौजूद हैं.

सोर्स से डिप्लॉय करें

सोर्स से डिप्लॉय करने पर, अपने ऐप्लिकेशन के सोर्स कोड और कॉन्फ़िगरेशन को सीधे App Hosting पर पुश किया जा सकता है. इसके लिए, GitHub से लगातार कनेक्शन बनाए रखने की ज़रूरत नहीं होती.

सोर्स से डिप्लॉय करने पर, App Hosting आपके सोर्स कोड को Google Cloud Storage बकेट में अपलोड करता है. साथ ही, Cloud Build में आपके फ़्रेमवर्क का बिल्ड कमांड चलाता है और कंपाइल किए गए आर्टफ़ैक्ट को Cloud Run और Cloud CDN में डिप्लॉय करता है. लोकल सोर्स डिप्लॉयमेंट के लिए, उसी बिल्ड प्रोसेस का इस्तेमाल किया जाता है जिसका इस्तेमाल GitHub डिप्लॉयमेंट के लिए किया जाता है. अगर आपके प्रोजेक्ट में कोई .gitignore फ़ाइल मौजूद है, तो उसमें मौजूद फ़ाइलों और फ़ोल्डर को आपके डिप्लॉयमेंट से बाहर रखा जाता है.

Firebase सीएलआई या Firebase कंसोल का इस्तेमाल करके, किसी लोकल सोर्स से डिप्लॉय किया जा सकता है.

ज़रूरी आईएएम अनुमतियां और इन्फ़्रास्ट्रक्चर सेटअप

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

ज़रूरी शर्तें इस बात पर निर्भर करती हैं कि आपने किसी खास जगह (इलाके) पर पहली बार डिप्लॉय किया है या नहीं. अनुमतियों के बारे में ज़्यादा जानने के लिए, Firebase IAM की खास जानकारी और Firebase App Hosting की अनुमतियों के बारे में खास जानकारी देखें.

शुरुआती तौर पर शामिल होने के लिए अनुमतियां (किसी जगह पर पहली बार डिप्लॉयमेंट)

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

सेटअप करने के लिए ज़रूरी अनुमतियों में ये शामिल हैं:

• स्टोरेज एपीआई चालू करें: serviceusage.services.enable
• सोर्स बकेट बनाना: storage.buckets.create और storage.buckets.list
• सर्विस एजेंट को कॉन्फ़िगर करें: resourcemanager.projects.setIamPolicy को App Hosting के लिए रीड ऐक्सेस (roles/storage.objectViewer) दें, ताकि वह बिल्ड के दौरान अपलोड किए गए कोड को फ़ेच कर सके.

शुरुआती डिप्लॉयमेंट के लिए, GCS बकेट को 30 दिनों की लाइफ़साइकल के साथ बनाया जाता है. इसके बाद, बकेट को मिटा दिया जाता है. हालांकि, Cloud Console में जाकर इस समयावधि को मैनेज किया जा सकता है. इसके लिए, Cloud Storage -> बकेट -> लाइफ़साइकल -> नियम पर जाएं. ऑब्जेक्ट की लाइफ़साइकल मैनेज करना देखें.

बाद में डिप्लॉयमेंट के लिए अनुमतियां (जगह की जानकारी शुरू होने के बाद)

किसी जगह के लिए सोर्स बकेट और रोल बाइंडिंग शुरू होने के बाद, डेवलपर, एडिटर या App Hosting एडमिन अपडेट डिप्लॉय कर सकते हैं. ऐसा सीएलआई डिप्लॉयमेंट या कंसोल सेटअप की मदद से किया जा सकता है. रूटीन डिप्लॉयमेंट के लिए, प्रोजेक्ट-लेवल पर एडमिन की अनुमतियों की ज़रूरत नहीं होती.

ऐक्टिव डिप्लॉयमेंट की अनुमतियों में ये शामिल हैं:

• बकेट की पुष्टि करें: storage.buckets.list
• सोर्स संग्रह अपलोड करें: storage.objects.create
• ट्रिगर बिल्ड और रोलआउट: स्टैंडर्ड App Hosting अनुमतियां (apphosting.builds.create और apphosting.rollouts.create)

Firebase सीएलआई की मदद से, सोर्स से डिप्लॉय करना

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

ज़रूरी शर्तें

• आपके प्रोजेक्ट Blaze प्लान पर होने चाहिए.
• आपके पास firebase-tools का 14.4.0 या इसके बाद का वर्शन होना चाहिए.

डिप्लॉयमेंट के चरण

1. अपनी लोकल प्रोजेक्ट डायरेक्ट्री में firebase init apphosting चलाएं.
2. जब आपसे पूछा जाए, तब किसी मौजूदा प्रोजेक्ट का इस्तेमाल करें को चुनें. इसके बाद, अपना टारगेट Firebase प्रोजेक्ट चुनें.
3. डिप्लॉय करने के लिए, कोई नया या मौजूदा बैकएंड चुनें. इस चरण से, आपकी लोकल डायरेक्ट्री के लिए App Hosting डिप्लॉयमेंट सेट अप हो जाते हैं. साथ ही, आपसे कॉन्फ़िगरेशन की जानकारी मांगी जाती है:
   • उस बैकएंड का आईडी जिस पर डिप्लॉय करना है
   • अगर नया बैकएंड बनाया जा रहा है, तो उसे डिप्लॉय करने के लिए क्षेत्र
   • आपके ऐप्लिकेशन कोड की रूट डायरेक्ट्री का पाथ
   • आपका पसंदीदा Node.js रनटाइम. वर्शन वाले रनटाइम को चुनने पर, बेस इमेज के अपने-आप अपडेट होने की सुविधा (एबीआईयू) चालू हो जाती है. इससे आपके मौजूदा एनवायरमेंट में, सिक्योरिटी पैच अपने-आप लागू हो जाते हैं.
4. App Hosting, डिप्लॉयमेंट की आपकी प्राथमिकताओं को firebase.json में सेव करता है. अगर आपके लोकल प्रोजेक्ट में यह फ़ाइल पहले से मौजूद नहीं है, तो यह फ़ाइल बनाई जाती है. इनिशलाइज़ेशन पूरा होने के बाद, अपना सोर्स कोड डिप्लॉय करने के लिए firebase deploy चलाएं.

ध्यान दें: अगर आपको इंटरैक्टिव प्रॉम्प्ट को बायपास करना है (उदाहरण के लिए, सीआई/सीडी स्क्रिप्ट में), तो कमांड-लाइन फ़्लैग --runtime (उदाहरण के लिए, --runtime nodejs22) का इस्तेमाल करके, एबीआईयू और रनटाइम सेटिंग को मैनेज किया जा सकता है. अगर आपने एक से ज़्यादा बैकएंड के लिए, लोकल सोर्स डिप्लॉयमेंट सेट अप किए हैं (इसका मतलब है कि firebase.json में एक से ज़्यादा backendId एंट्री हैं), तो firebase deploy इनमें से हर बैकएंड पर डिप्लॉय होता है. किसी खास बैकएंड पर डिप्लॉय करने के लिए, firebase deploy --only apphosting:backendId का इस्तेमाल करें.

firebase.json का उदाहरण

{
  "apphosting": [
    {
      "backendId": "my-backend",
      // rootDir specifies the directory containing the app to deploy, but the entire
      // parent directory of firebase.json will be zipped and uploaded to ensure that
      // dependencies outside of the app directory will be available at build time.
      "rootDir": "./my-app",
      "ignore": [
        "node_modules",
        ".git",
        "firebase-debug.log",
        "firebase-debug.*.log",
        "functions"
      ]
    }
  ]
}

Firebase कंसोल (ज़िप अपलोड) की मदद से डिप्लॉय करना

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

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

इस्तेमाल किए जा सकने वाले फ़ॉर्मैट

Console का अपलोडर, कंप्रेस किए गए संग्रह के दो फ़ॉर्मैट की पुष्टि करता है और उन्हें स्वीकार करता है:

• .zip
• .tgz

ये फ़ॉर्मैट, फ़ाइल अपलोडर के ब्यौरे वाले टेक्स्ट में साफ़ तौर पर दिखते हैं.

डिप्लॉयमेंट के चरण

पहला विकल्प: बैकएंड पर शुरुआती ऑनबोर्डिंग के दौरान

1. सोर्स चुनें: बैकएंड क्रिएशन विज़र्ड में, "आपको अपना ऐप्लिकेशन कैसे इंपोर्ट करना है?" चरण के दौरान, ज़िप फ़ाइल अपलोड करें को चुनें.
2. शामिल होने की तैयारी: "आगे बढ़ें" पर क्लिक करने से, बैकग्राउंड में तैयारी का फ़्लो ट्रिगर होता है. इससे Storage API को क्रम से चालू किया जाता है, यह पक्का किया जाता है कि सही भूमिकाएं सेट अप की गई हों, और बकेट को अपसर्ट किया जाता है. यूज़र इंटरफ़ेस (यूआई) में, डाइनैमिक स्टेटस मैसेज के साथ लोडिंग स्पिनर दिखता है: "एपीआई चालू किया जा रहा है...", "अनुमतियों की जांच की जा रही है..." और "बकेट तैयार की जा रही है...".
   • गड़बड़ी ठीक करना और गार्डरेल: अगर तैयारी का कोई चरण पूरा नहीं हो पाता है (जैसे, आईएएम की ज़रूरी अनुमतियां न होने की वजह से, मालिक के अलावा किसी अन्य व्यक्ति को 403 PERMISSION_DENIED मिलता है), तो यूज़र इंटरफ़ेस (यूआई) पर एक चेतावनी दिखती है. इसमें आपको प्रोजेक्ट के मालिक से संपर्क करने का निर्देश दिया जाता है. स्टेपर नेविगेशन को पूरी तरह से लॉक कर दिया जाता है. साथ ही, समस्या हल होने तक "आगे बढ़ें" बटन और "पूरा करें और डिप्लॉय करें" बटन बंद रहता है.
3. फ़ाइलें अपलोड करना: फ़ाइल तैयार होने के बाद, उसे चुनें या फ़ाइल अपलोडर कॉम्पोनेंट में खींचें और छोड़ें.

4. सेटिंग कॉन्फ़िगर करें: अपने ऐप्लिकेशन की रूट डायरेक्ट्री की जानकारी दें. डिफ़ॉल्ट रूप से, यह / पर सेट होती है.

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

5. Finish and Deploy पर क्लिक करें: ज़िप फ़ाइलें अपलोड करने के लिए, अलग से मौजूद "Finish" बटन को बंद कर दिया जाता है. ऐसा इसलिए, क्योंकि संग्रह को अपलोड करना एक बार की जाने वाली कार्रवाई है. साथ ही, बैकएंड सही तरीके से काम करे, इसके लिए ज़रूरी है कि अपलोड करने के तुरंत बाद उसे डिप्लॉय किया जाए.

दूसरा विकल्प: मैन्युअल तरीके से रोलआउट करना

1. डायलॉग बॉक्स खोलें: App Hosting डैशबोर्ड में, रोलआउट बनाएं पर क्लिक करें.
2. सोर्स चुनें: डायलॉग बॉक्स के स्टेपर में, ज़िप फ़ाइल अपलोड करें को चुनें. अगर बैकएंड में पहले से कोई GitHub कनेक्शन मौजूद नहीं है, तो "GitHub" विकल्प बंद हो जाता है.
3. तैयारी और अपलोड करना: इस विकल्प को चुनने पर, बैकग्राउंड में तैयारी करने की वही प्रोसेस ट्रिगर होती है ("एपीआई चालू किया जा रहा है...", "अनुमतियों की जांच की जा रही है..." और "बकेट तैयार की जा रही है..."). इसके बाद, अपलोडर का इस्तेमाल करके अपनी संग्रह फ़ाइल को खींचें और छोड़ें या उसे चुनें. साथ ही, ऐप्लिकेशन की रूट डायरेक्ट्री की जानकारी दें. इसके बाद, बिल्ड और रोल आउट को ट्रिगर करने के लिए, डिप्लॉय करें पर क्लिक करें.

Terraform का इस्तेमाल करके डिप्लॉय करना

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

अगर Terraform आपके लिए नया है, तो Terraform और Firebase का इस्तेमाल शुरू करना लेख पढ़ें. अगर आपको Terraform के बारे में पहले से जानकारी है, तो सैंपल कॉन्फ़िगरेशन फ़ाइलों और अन्य App Hosting संसाधनों का इस्तेमाल करके शुरुआत की जा सकती है.

सीआई/सीडी के लिए GitHub कनेक्शन सेट अप करना

आपके पास Firebase कंसोल में बैकएंड की सेटिंग के डिप्लॉयमेंट टैब में जाकर, किसी भी समय GitHub रिपॉज़िटरी को कनेक्ट करने का विकल्प होता है. इससे आपको लोकल एनवायरमेंट से ऐप्लिकेशन का प्रोटोटाइप डिप्लॉय करने में मदद मिलती है. इसके बाद, तैयार होने पर ऑटोमेटेड सीआई/सीडी पाइपलाइन पर ट्रांज़िशन किया जा सकता है.

एआई टूल का इस्तेमाल करके डिप्लॉय करना

हम 22 मार्च, 2027 को Firebase Studio को बंद कर रहे हैं. हालांकि, आपके App Hosting बैकएंड पर इसका कोई असर नहीं पड़ेगा, लेकिन Firebase Studio में मौजूद पब्लिश करें बटन को हटा दिया जाएगा. यूआरएल बदले बिना अपडेट पब्लिश करना जारी रखने के लिए, अपना प्रोजेक्ट माइग्रेट करें. माइग्रेट करने का तरीका जानें.