استقرار چندین محیط از یک پایگاه کد

معمولاً چندین محیط از یک پایگاه کد مستقر می‌شوند که هرکدام پیکربندی کمی متفاوت دارند. برای مثال، ممکن است بخواهید واحد پردازش مرکزی و حافظه دسترسی تصادفی کمتری به محیط آماده‌سازی خود اختصاص دهید، یا ممکن است بخواهید مطمئن شوید محیط تولید شما حداقل ۱ نمونه فعال و آماده برای ارائه درخواست‌ها نگه می‌دارد. همچنین ممکن است بخواهید متغیرهای محیطی و اطلاعات محرمانه متفاوتی را بسته به محیط و منابعی که می‌خواهید استفاده کنید مشخص کنید.

این راهنما نحوه استقرار محیط تولید و آماده‌سازی را شرح می‌دهد، هرکدام در یک پروژه Firebase جداگانه. با پیروی از همین اصول، می‌توانید در انواع دیگر محیط‌ها نیز استقرار انجام دهید. برای کسب اطلاعات بیشتر درباره محیط‌ها، نمای کلی محیط‌ها و روال‌های مطلوب عمومی برای راه‌اندازی پروژه‌های Firebase را بررسی کنید.

پیش‌نیازها

  • کد برنامه شما ازقبل در GitHub ذخیره شده است.
  • قبلاً برای هریک از محیط‌هایتان پروژه متمایزی ایجاد کرده‌اید—برای مثال my-production-firebase-project و my-staging-firebase-project. حتماً پروژه Firebase تولیدی‌تان را با نوع محیط «تولید» برچسب‌گذاری کنید.
  • در هر پروژه، یک پسای App Hosting ایجاد کرده‌اید و شاخه زنده روی شاخه GitHub که می‌خواهید مستقر کنید (مانند main) تنظیم شده است. برای اطلاعات بیشتر، به شروع به کار با App Hosting مراجعه کنید.

مرحله ۰: ایجاد پیکربندی پیش‌فرض در apphosting.yaml

App Hosting از فایل پیکربندی‌ای به‌نام apphosting.yaml برای مدیریت تنظیمات زمان اجرا (CPU، همزمانی، محدودیت‌های حافظه، و غیره) و متغیرهای محیطی برای برنامه‌تان پشتیبانی می‌کند. همچنین از ارجاع به اطلاعات محرمانه مدیریت‌شده با Cloud Secret Manager پشتیبانی می‌کند، که باعث می‌شود بررسی در کنترل منبع ایمن باشد. برای اطلاعات بیشتر، به پیکربندی پشت‌بام مراجعه کنید.

برای شروع، فایل apphosting.yaml را در دایرکتوری ریشه برنامه‌تان ایجاد کنید. این فایل پیکربندی جایگزین است که وقتی فایل پیکربندی مختص محیط پیدا نشود، استفاده می‌شود. مقادیر ذخیره‌شده در apphosting.yaml باید پیش‌فرض‌هایی باشند که استفاده از آن‌ها برای همه محیط‌ها ایمن باشد.

بخش‌های بعدی نحوه لغو مقادیر پیش‌فرض در apphosting.yaml را برای محیط‌های خاص توضیح می‌دهد. این جریان نمونه یک محیط آماده‌سازی ایجاد می‌کند.

مرحله ۱: تنظیم نام محیط

هر باطن App Hosting دارای تنظیم نام محیط است. این فیلد برای نگاشت کردن پسای شما به فایل پیکربندی مختص محیط استفاده می‌شود و هرزمان بخواهید می‌توانید آن را تغییر دهید. برای هر پس‌زمینه فقط می‌توانید یک نام محیط تنظیم کنید.

برای تنظیم نام محیط پسین،

  1. در کنسول Firebase، پروژه آماده‌سازی‌تان را انتخاب کنید (در این مثال، my-staging-firebase-project).
  2. به میزبانی و بدون سرور > میزبانی برنامه بروید.
  3. روی مشاهده در باطن انتخابی‌تان کلیک کنید.
  4. در برگه تنظیمات، محیط را انتخاب کنید.
  5. در بخش نام محیط، نام محیط خود را وارد کنید. می‌توانید هر نامی که می‌خواهید برای محیط انتخاب کنید. در این مثال، staging است.
  6. روی ذخیره کردن کلیک کنید.

وقتی عرضه App Hosting برای باطن شما راه‌اندازی می‌شود (یا در git push یا به‌صورت دستی ازطریق کنسول Firebase)، App Hosting قبل‌از بازگشت به apphosting.yaml، وجود فایل apphosting.ENVIRONMENT_NAME.yaml را بررسی می‌کند.

مرحله ۲: ایجاد کردن فایل apphosting.yaml مختص محیط

برای پیکربندی مختص محیط، فایلی با نام apphosting.ENVIRONMENT_NAME.yaml ایجاد کنید تا جایگزینی‌های مختص محیط را مشخص کنید. این فایل همان قالب apphosting.yaml پیش‌فرض را دارد و باید در دایرکتوری ریشه برنامه‌تان در کنار apphosting.yaml قرار داشته باشد.

در زمان ساخت، App Hosting این دو فایل را ادغام می‌کند و اولویت را به مقادیر موجود در فایل YAML مختص محیط نسبت‌به فایل پایه apphosting.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 مانند CPU و همچنین هرگونه متغیر محیطی هم‌پوشان بازنویسی شده‌اند.

مرحله ۳: پایگاه کدتان را مستقر کنید

وقتی ویرایش فایل 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 استفاده کنید.

مراحل بعدی