अपने ऐप्लिकेशन को डिप्लॉय करने की जांच स्थानीय तौर पर करना

App Hosting को डिप्लॉय करने से पहले, अपने ऐप्लिकेशन की लोकल टेस्टिंग की जा सकती है. इसके लिए, App Hosting एम्युलेटर का इस्तेमाल करें. यह Firebase Local Emulator Suite का हिस्सा है.

App Hosting एम्युलेटर का इस्तेमाल करने से पहले, पक्का करें कि आपको Firebase Local Emulator Suite के पूरे वर्कफ़्लो के बारे में पता हो. साथ ही, आपने Local Emulator Suite को इंस्टॉल और कॉन्फ़िगर किया हो और इसके सीएलआई कमांड की समीक्षा की हो.

इस विषय में यह माना गया है कि आपको App Hosting के बारे में पहले से जानकारी है. अगर ज़रूरी हो, तो App Hosting के बारे में जानकारी और अन्य कॉन्टेंट देखें. इससे आपको App Hosting के काम करने का तरीका समझने में मदद मिलेगी.

App Hosting एम्युलेटर की मदद से क्या किया जा सकता है?

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

App Hosting एम्युलेटर:

  1. इससे आपको अपने वेब ऐप्लिकेशन को स्थानीय तौर पर चलाने की सुविधा मिलती है. इसके लिए, apphosting.yaml कॉन्फ़िगरेशन फ़ाइलों में तय किए गए एनवायरमेंट वैरिएबल और सीक्रेट का इस्तेमाल किया जाता है.
  2. apphosting.emulator.yaml फ़ाइल की मदद से, एम्युलेटर में इस्तेमाल करने के लिए एनवायरमेंट वैरिएबल और सीक्रेट को बदला जा सकता है.
  3. इसे Firebase के अन्य एम्युलेटर के साथ इस्तेमाल किया जा सकता है. अगर Firestore, Auth या किसी अन्य एम्युलेटर का इस्तेमाल किया जा रहा है, तो Local Emulator Suite यह पक्का करता है कि ये एम्युलेटर, App Hosting एम्युलेटर से पहले शुरू हों.

एम्युलेटर को कॉन्फ़िगर करना

शुरू करने के लिए, Local Emulator Suite को इंस्टॉल और शुरू करें. इसके बारे में Local Emulator Suite को इंस्टॉल, कॉन्फ़िगर, और इंटिग्रेट करना लेख में बताया गया है. आपको जो भी Firebase एमुलेटर सेट अप करने हैं उनके साथ-साथ, App Hosting Emulator को भी चुनें. सीएलआई आपसे App Hosting एम्युलेटर की कुछ वैल्यू मांगता है. इनमें ये शामिल हैं:

  • प्रोजेक्ट के हिसाब से आपके ऐप्लिकेशन की रूट डायरेक्ट्री. यह तब ज़रूरी है, जब App Hosting के साथ मोनो रिपॉज़िटरी का इस्तेमाल किया जा रहा हो.
  • क्या आपको लोकल डेवलपमेंट के लिए किसी वैल्यू को बदलना है.
  • क्या आपको टीम के सदस्यों को लोकल डेवलपमेंट के लिए, सीक्रेट का ऐक्सेस देना है.
firebase init emulators
=== Emulators Setup
? Which Firebase emulators do you want to set up? Press Space to select emulators, then Enter to confirm your choices. (Press
<space> to select, <a> to toggle all, <i> to invert selection, and <enter> to proceed)
❯◯ App Hosting Emulator
 ◯ Firestore Emulator
 ◯ Database Emulator
 ◯ Hosting Emulator
 ◯ Pub/Sub Emulator
 ◯ Storage Emulator
 ◯ Eventarc Emulator
(Move up and down to reveal more choices)

? Specify your app's root directory relative to your project (./)

? The App Hosting emulator uses a file called apphosting.emulator.yaml to
override values in apphosting.yaml for local testing. This codebase does not
have one, would you like to create it? (Y/n)

? Which environment variables would you like to override? (Press <space> to
select, <a> to toggle all, <i> to invert selection, and <enter> to proceed)
❯◯ MEMCACHE_ADDR
 ◯ API_KEY

? What new value would you like for plaintext MEMCACHE_ADDR?

? What would you like to name the secret reference for API_KEY? (test-api-key)

? What new value would you like for secret TESTKEY [input is hidden]? [input is hidden]

? Your config has secret values. Please provide a comma-separated list of users
or groups who should have access to secrets for local development:

✔  Successfully set IAM bindings on secret test-api-key.

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

{
  ...
  "emulators": {
    "apphosting": {
      "startCommand": <command> [optional],
      "rootDirectory": <path> [optional]
    }
  }
}
  • एम्युलेटर के शुरू होने पर, startCommand अपने-आप जनरेट और सेट हो जाता है. अगर यह जानकारी नहीं दी जाती है, तो एम्युलेटर आपके पैकेज मैनेजर के dev कमांड का पता लगाएगा और उसे चलाएगा.
  • rootDirectory का इस्तेमाल, मोनो रिपॉज़िटरी प्रोजेक्ट सेटअप के लिए किया जाता है. अगर आपका वेब ऐप्लिकेशन किसी सबडायरेक्ट्री में है, तो आपको रूट (firebase.json की जगह) के हिसाब से उस डायरेक्ट्री का पाथ देना होगा.

इम्यूलेशन मैनेज करना

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

apphosting.emulator.yaml फ़ाइल को इस तरह से डिज़ाइन किया गया है कि इसे सुरक्षित तरीके से कमिट किया जा सके और सहकर्मियों के साथ शेयर किया जा सके. यह पक्का करने के लिए कि संवेदनशील डेटा गलती से सोर्स रिपॉज़िटरी में न चला जाए, apphosting.yaml में मौजूद हर वह एनवायरमेंट वैरिएबल जो सीक्रेट है उसे apphosting.emulator.yaml में भी सीक्रेट होना चाहिए. अगर किसी सीक्रेट को प्रोडक्शन और लोकल डेवलपमेंट के बीच बदलने की ज़रूरत नहीं है (उदाहरण के लिए, Gemini API पासकोड), तो उसे apphosting.emulator.yaml में जोड़ने की ज़रूरत नहीं है. इसके बजाय, अपनी टीम को सीक्रेट का ऐक्सेस दें.

अगर आपका ऐप्लिकेशन कई सीक्रेट इस्तेमाल करता है, तो हो सकता है कि आप Cloud Secret Manager के मुफ़्त टीयर की सीमा को पार कर जाएं. उदाहरण के लिए, तीन अलग-अलग सेवाओं के लिए एपीआई पासकोड, जिनमें से हर एक के लिए प्रोडक्शन, स्टेजिंग, और लोकल डेवलपमेंट की अलग-अलग वैल्यू हों. ऐसे में, आपको हर महीने हर अतिरिक्त सीक्रेट के लिए 0.06 डॉलर चुकाने होंगे. अगर आपको इस शुल्क से बचने के लिए, सोर्स कंट्रोल के बाहर लोकल कॉन्फ़िगरेशन को मैनेज करना है, तो लेगसी apphosting.local.yaml फ़ाइल का इस्तेमाल किया जा सकता है. apphosting.emulator.yaml के उलट, इस फ़ाइल में एनवायरमेंट वैरिएबल के लिए, सादे टेक्स्ट वाली वैल्यू दी जा सकती हैं. ये वैल्यू, apphosting.yaml में सीक्रेट वैल्यू होती हैं.

उपयोगकर्ताओं या ग्रुप को सीक्रेट का ऐक्सेस देना

एम्युलेटर के चालू होने पर, apphosting.emulator.yaml में सेव किए गए सीक्रेट पढ़े जाते हैं. इसका मतलब है कि आपकी डेवलपमेंट टीम को सीक्रेट का ऐक्सेस चाहिए. apphosting:secrets:grantaccess कमांड का इस्तेमाल करके, किसी उपयोगकर्ता या ग्रुप को ईमेल के ज़रिए सीक्रेट का ऐक्सेस दिया जा सकता है.

firebase apphosting:secrets:grantaccess test-api-key --emails my-team@my-company.com

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

सीक्रेट के ऐक्सेस को मैनेज करने के लिए, अलग-अलग उपयोगकर्ताओं को ऐक्सेस देने के बजाय, Google Groups का इस्तेमाल करें. इससे आपकी डेवलपर टीम में नए सदस्यों को शामिल करना आसान हो जाएगा. ऐसा इसलिए, क्योंकि उन्हें ग्रुप में जोड़ने से, उन्हें उन सभी सीक्रेट का ऐक्सेस मिल जाएगा जिनकी उन्हें ज़रूरत है. ऐसा हो सकता है कि आपके पास पहले से ही कोई ऐसा ग्रुप हो जहां डेवलपर एक-दूसरे से बातचीत करते हों. Google Groups की मदद से ऐक्सेस कंट्रोल करने से, यह भी पक्का किया जा सकता है कि आपकी टीम छोड़ने वाले डेवलपर को ईमेल ग्रुप से हटाए जाने पर, उनके पास किसी भी सीक्रेट का ऐक्सेस न रहे. अगर सीक्रेट के पास प्रोडक्शन डेटा या असल दुनिया के खराब असर का ऐक्सेस है, तो भी अपनी कुंजी को रोटेट करना और उसे firebase apphosting:secrets:set के साथ नई वैल्यू देना सही हो सकता है.

एम्युलेटर चलाना

firebase emulators:start

इससे आपकी firebase.json फ़ाइल में बताए गए सभी एमुलेटर चालू हो जाएंगे. इनमें App Hosting एमुलेटर भी शामिल है.

Angular ऐप्लिकेशन के लिए, start कमांड को कॉन्फ़िगर करना

अगर एम्युलेटर start कमांड का टाइम आउट हो जाता है, तो हो सकता है कि Angular डेवलपमेंट सर्वर आपके ऐप्लिकेशन को उस पोर्ट से अलग पोर्ट पर उपलब्ध करा रहा हो जिसकी उम्मीद App Hosting एम्युलेटर को है. firebase.json में कुछ और कॉन्फ़िगरेशन जोड़कर, इस समस्या को हल किया जा सकता है:

  • emulators.apphosting.startCommand को ng serve पर सेट करें.
  • डिफ़ॉल्ट के अलावा किसी अन्य पोर्ट का इस्तेमाल करने के लिए, उसे emulators.apphosting.port के साथ सेट करें. इसके लिए, emulators.apphosting.startCommand में ng serve में --port फ़्लैग न जोड़ें.

उदाहरण के लिए:

"emulators": {
    "apphosting": {
      "port": 5002,
      "rootDirectory": "./test-app",
      "startCommand": "ng serve"
    },
    "ui": {
      "enabled": true
    },
    ...
  }