कोड बेस से कई एनवायरमेंट डिप्लॉय करें

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

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

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

  • आपके ऐप्लिकेशन का कोड पहले से ही GitHub में सेव है.
  • आपने अपने हर एनवायरमेंट के लिए पहले से ही एक अलग प्रोजेक्ट बनाया हुआ है. उदाहरण के लिए, my-production-firebase-project और my-staging-firebase-project. अपने प्रोडक्शन Firebase प्रोजेक्ट को "production" एनवायरमेंट टाइप के साथ टैग करना न भूलें.
  • आपने हर प्रोजेक्ट में एक App Hosting बैकएंड बनाया हो. साथ ही, लाइव ब्रांच को उस GitHub ब्रांच पर सेट किया हो जिसे आपको डिप्लॉय करना है, जैसे कि main. ज़्यादा जानकारी के लिए, App Hosting का इस्तेमाल शुरू करना लेख पढ़ें.

चरण 0: apphosting.yaml में डिफ़ॉल्ट कॉन्फ़िगरेशन बनाना

App Hosting में apphosting.yaml नाम की कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल किया जाता है. इससे आपके ऐप्लिकेशन के लिए, रनटाइम सेटिंग (सीपीयू, एक साथ कई काम करने की सुविधा, मेमोरी की सीमाएं वगैरह) और एनवायरमेंट वैरिएबल मैनेज किए जाते हैं. इसमें Cloud Secret Manager की मदद से मैनेज किए जाने वाले सीक्रेट के रेफ़रंस भी इस्तेमाल किए जा सकते हैं. इससे सोर्स कंट्रोल में सुरक्षित तरीके से चेक इन किया जा सकता है. ज़्यादा जानकारी के लिए, बैकएंड कॉन्फ़िगर करना लेख पढ़ें.

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

अगले सेक्शन में, खास एनवायरमेंट के लिए apphosting.yaml में डिफ़ॉल्ट वैल्यू को बदलने का तरीका बताया गया है. इस उदाहरण में, स्टेजिंग एनवायरमेंट बनाने का तरीका बताया गया है.

पहला चरण: एनवायरमेंट का नाम सेट करना

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

अपने बैकएंड के एनवायरमेंट का नाम सेट करने के लिए,

  1. Firebase कंसोल में, अपना स्टेजिंग प्रोजेक्ट चुनें. इस उदाहरण में, my-staging-firebase-project को चुनें.
  2. होस्टिंग और सर्वरलेस > App Hosting पर जाएं.
  3. अपने चुने हुए बैकएंड पर, देखें पर क्लिक करें.
  4. सेटिंग टैब में जाकर, एनवायरमेंट को चुनें.
  5. एनवायरमेंट का नाम में जाकर, अपने एनवायरमेंट का नाम डालें. एनवायरमेंट को अपनी पसंद के मुताबिक कोई भी नाम दिया जा सकता है. इस उदाहरण में, यह staging है.
  6. सेव करें पर क्लिक करें.

जब आपके बैकएंड के लिए App Hosting रोलआउट ट्रिगर किया जाता है (git पुश पर या Firebase कंसोल की मदद से मैन्युअल तरीके से), तो App Hosting, apphosting.yaml पर वापस जाने से पहले apphosting.ENVIRONMENT_NAME.yaml फ़ाइल की जांच करेगा.

दूसरा चरण: एनवायरमेंट के हिसाब से apphosting.yaml फ़ाइल बनाना

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

बिल्ड के समय, App Hosting इन दोनों फ़ाइलों को मर्ज कर देता है. इसमें, बेस apphosting.yaml फ़ाइल के बजाय, एनवायरमेंट के हिसाब से बनाई गई YAML फ़ाइल में मौजूद वैल्यू को प्राथमिकता दी जाती है.

इस उदाहरण में, ऐप्लिकेशन की रूट डायरेक्ट्री में apphosting.staging.yaml नाम की फ़ाइल बनाई जाएगी:


runConfig:
  cpu: 1
  memoryMiB: 512
  concurrency: 5

env:
-   variable: API_URL
    value: api.staging.service.com
    availability:
      -   BUILD

-   variable: DATABASE_URL
    secret: secretStagingDatabaseURL

मान लें कि आपके पास पहले से ही एक apphosting.yaml है, जो कुछ ऐसा दिखता है:

runConfig:
  cpu: 3
  memoryMiB: 1024
  maxInstances: 4
  minInstances: 0
  concurrency: 100

env:
-   variable: API_URL
    value: api.service.com
    availability:
      -   BUILD
      -   RUNTIME

-   variable: STORAGE_BUCKET
    value: mybucket.firebasestorage.app
    availability:
      -   RUNTIME

-   variable: API_KEY
    secret: secretIDforAPI

मर्ज किया गया फ़ाइनल आउटपुट, जिसे Cloud Build लॉग में देखा जा सकता है, कुछ ऐसा दिखेगा:

runConfig:
  cpu: 1
  memoryMiB: 512
  maxInstances: 4
  minInstances: 0
  concurrency: 5

env:
-   variable: API_URL
    value: api.staging.service.com
    availability:
      -   BUILD

-   variable: STORAGE_BUCKET
    value: mybucket.firebasestorage.app
    availability:
      -   RUNTIME

-   variable: API_KEY
    secret: secretIDforAPI

-   variable: DATABASE_URL
    secret: secretStagingDatabaseURL

ध्यान दें कि सीपीयू जैसी कुछ runConfig वैल्यू को ओवरराइट कर दिया गया है. साथ ही, ओवरलैप होने वाले एनवायरमेंट वैरिएबल को भी ओवरराइट कर दिया गया है.

तीसरा चरण: अपना कोड बेस डिप्लॉय करना

एनवायरमेंट के हिसाब से apphosting.ENVIRONMENT_NAME.yaml फ़ाइल में बदलाव करने के बाद, अपनी फ़ाइल को GitHub पर पुश करें:

$ git add apphosting.<ENVIRONMENT_NAME>.yaml
$ git commit -m "Added environment specific yaml file"
$ git push

इस एनवायरमेंट के नाम से टैग किए गए सभी बैकएंड, आपकी ओर से तय की गई YAML फ़ाइल में मौजूद खास ओवरराइड वैल्यू का इस्तेमाल करेंगे. साथ ही, वैल्यू न मिलने पर apphosting.yaml पर वापस चले जाएंगे. जिन बैकएंड के साथ कोई एनवायरमेंट नेम नहीं जुड़ा है उनके लिए, apphosting.yaml का इस्तेमाल जारी रखा जा सकता है.

अगले चरण