कई साइटों पर प्रोजेक्ट के संसाधन शेयर करना

एक Firebase प्रोजेक्ट में, एक या उससे ज़्यादा Firebase Hosting साइटें सेट अप की जा सकती हैं. सभी साइटें एक ही Firebase प्रोजेक्ट में होने की वजह से, सभी साइटें प्रोजेक्ट के दूसरे Firebase संसाधनों को ऐक्सेस कर सकती हैं.

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

पहला चरण: Firebase सीएलआई का वर्शन अपडेट करना

Firebase Hosting की सबसे नई सुविधाएं ऐक्सेस करने के लिए, Firebase सीएलआई के सबसे नए वर्शन पर अपडेट करें.

दूसरा चरण: अन्य साइटें जोड़ना

Firebase प्रोजेक्ट में अन्य साइटें जोड़ने के लिए, इनमें से किसी एक तरीके का इस्तेमाल करें:

  • Firebase कंसोल के Hosting पेज पर मौजूद वर्कफ़्लो का इस्तेमाल करना

  • Firebase सीएलआई कमांड का इस्तेमाल करें: firebase hosting:sites:create SITE_ID

  • Hosting REST API का इस्तेमाल करें: projects.sites.create

इनमें से हर तरीके के लिए, आपको एक SITE_ID तय करना होगा. इसका इस्तेमाल, साइट के लिए Firebase से मिले डिफ़ॉल्ट सबडोमेन बनाने के लिए किया जाता है:

  • SITE_ID.web.app
  • SITE_ID.firebaseapp.com

इन यूआरएल के लिए SITE_ID का इस्तेमाल किया जाता है. इसलिए, साइट आईडी के लिए ये ज़रूरी शर्तें हैं:

  • यह मान्य होस्टनेम लेबल होना चाहिए. इसका मतलब है कि इसमें ., _ वगैरह नहीं होने चाहिए.
  • इसमें 30 या उससे कम वर्ण होने चाहिए
  • Firebase में यह नाम दुनिया भर में यूनीक होना चाहिए

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

सेकंडरी साइट मिटाना

Firebase प्रोजेक्ट से अनचाही साइटों को मिटाने के लिए, इनमें से किसी एक तरीके का इस्तेमाल करें:

  • Firebase कंसोल के Hosting पेज पर मौजूद वर्कफ़्लो का इस्तेमाल करना

  • Firebase सीएलआई कमांड का इस्तेमाल करें: firebase hosting:sites:delete SITE_ID

  • Hosting REST API का इस्तेमाल करें: projects.sites.delete

ध्यान दें कि डिफ़ॉल्ट साइट को नहीं मिटाया जा सकता. इस साइट का SITE_ID, आपके Firebase प्रोजेक्ट आईडी जैसा होता है.

तीसरा चरण: अपनी साइटों के लिए डिप्लॉय टारगेट सेट अप करना

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

डिप्लॉय टारगेट बनाने और Hosting साइट पर TARGET_NAME लागू करने के लिए, अपनी प्रोजेक्ट डायरेक्ट्री के रूट से यह सीएलआई कमांड चलाएं:

firebase target:apply hosting TARGET_NAME RESOURCE_IDENTIFIER

पैरामीटर कहां हैं:

  • TARGET_NAME — उस Hosting साइट के लिए यूनीक नाम (जिसे आपने खुद तय किया है) जिस पर आपको डिप्लॉय करना है

  • RESOURCE_IDENTIFIER — Hosting साइट के लिए SITE_ID, जैसा कि आपके Firebase प्रोजेक्ट में सूची में दिया गया है

उदाहरण के लिए, अगर आपने अपने Firebase प्रोजेक्ट में दो साइटें (myapp-blog और myapp-app) बनाई हैं, तो नीचे दिए गए निर्देशों को चलाकर, हर साइट पर एक यूनीक TARGET_NAME (क्रमशः blog और app) लागू किया जा सकता है:

firebase target:apply hosting blog myapp-blog
 
firebase target:apply hosting app myapp-app

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

चौथा चरण: हर साइट के लिए होस्टिंग कॉन्फ़िगरेशन तय करना

अपनी firebase.json फ़ाइल में, साइट के होस्टिंग कॉन्फ़िगरेशन को तय करते समय, साइट पर लागू किए गए TARGET_NAME का इस्तेमाल करें.

  • अगर आपकी firebase.json फ़ाइल में एक से ज़्यादा साइटों के लिए कॉन्फ़िगरेशन तय किया गया है, तो ऐरे फ़ॉर्मैट का इस्तेमाल करें:

    {
  "hosting": [ {
      "target": "blog",  // "blog" is the applied TARGET_NAME for the Hosting site "myapp-blog"
      "public": "blog/dist",  // contents of this folder are deployed to the site "myapp-blog"

      // ...
    },
    {
      "target": "app",  // "app" is the applied TARGET_NAME for the Hosting site "myapp-app"
      "public": "app/dist",  // contents of this folder are deployed to the site "myapp-app"

      // ...

      "rewrites": [...]  // You can define specific Hosting configurations for each site
    }
  ]
}

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

    {
  "hosting": {
      "target": "blog",
      "public": "dist",

      // ...

      "rewrites": [...]
  }
}

पांचवां चरण: स्थानीय तौर पर जांच करना, बदलावों की झलक देखना, और अपनी साइटों पर डिप्लॉय करना

अपने स्थानीय प्रोजेक्ट डायरेक्ट्री के रूट से, इनमें से कोई भी कमांड चलाएं.

आदेश ब्यौरा
firebase emulators:start --only hosting स्थानीय तौर पर होस्ट किए गए यूआरएल पर, डिफ़ॉल्ट Hosting साइट के Hosting कॉन्टेंट और कॉन्फ़िगरेशन को एमुलेट करता है
firebase emulators:start --only hosting:TARGET_NAME स्थानीय तौर पर होस्ट किए गए यूआरएल पर, बताई गई Hosting साइट के Hosting कॉन्टेंट और कॉन्फ़िगरेशन को एमुलेट करता है
firebase hosting:channel:deploy \
CHANNEL_ID		 झलक वाले यूआरएल पर, Hosting साइट के डिफ़ॉल्ट Hosting कॉन्टेंट और कॉन्फ़िगरेशन को डिप्लॉय करता है
firebase hosting:channel:deploy \
CHANNEL_ID --only TARGET_NAME		 झलक वाले यूआरएल पर, बताई गई Hosting साइट के Hosting कॉन्टेंट और कॉन्फ़िगरेशन को डिप्लॉय करता है
firebase deploy --only hosting firebase.json में कॉन्फ़िगर की गई सभी Hosting साइटों के लाइव चैनल पर, Hosting कॉन्टेंट और कॉन्फ़िगरेशन को डिप्लॉय करता है
firebase deploy --only hosting:TARGET_NAME Hosting कॉन्टेंट और कॉन्फ़िगरेशन को, बताई गई Hosting साइट के लाइव चैनल पर डिप्लॉय करता है
आदेश ब्यौरा
(इसका सुझाव नहीं दिया जाता; इसके बजाय emulators:start का इस्तेमाल करें)
firebase serve --only hosting 		स्थानीय तौर पर होस्ट किए गए यूआरएल पर, Hosting साइट के डिफ़ॉल्ट Hosting कॉन्टेंट और कॉन्फ़िगरेशन को दिखाता है
(इसका सुझाव नहीं दिया जाता; इसके बजाय emulators:start का इस्तेमाल करें)
firebase serve --only hosting:TARGET_NAME 		स्थानीय तौर पर होस्ट किए गए यूआरएल पर, बताई गई Hosting साइट का Hosting कॉन्टेंट और कॉन्फ़िगरेशन दिखाता है