معمولاً چندین محیط از یک پایگاه کد مستقر میشوند که هرکدام پیکربندی کمی متفاوت دارند. برای مثال، ممکن است بخواهید واحد پردازش مرکزی و حافظه دسترسی تصادفی کمتری به محیط آمادهسازی خود اختصاص دهید، یا ممکن است بخواهید مطمئن شوید محیط تولید شما حداقل ۱ نمونه فعال و آماده برای ارائه درخواستها نگه میدارد. همچنین ممکن است بخواهید متغیرهای محیطی و اطلاعات محرمانه متفاوتی را بسته به محیط و منابعی که میخواهید استفاده کنید مشخص کنید.
این راهنما نحوه استقرار محیط تولید و آمادهسازی را شرح میدهد، هرکدام در یک پروژه 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 دارای تنظیم نام محیط است. این فیلد برای نگاشت کردن پسای شما به فایل پیکربندی مختص محیط استفاده میشود و هرزمان بخواهید میتوانید آن را تغییر دهید. برای هر پسزمینه فقط میتوانید یک نام محیط تنظیم کنید.
برای تنظیم نام محیط پسین،
- در کنسول Firebase، پروژه آمادهسازیتان را انتخاب کنید (در این مثال،
my-staging-firebase-project). - به میزبانی و بدون سرور > میزبانی برنامه بروید.
- روی مشاهده در باطن انتخابیتان کلیک کنید.
- در برگه تنظیمات، محیط را انتخاب کنید.
- در بخش نام محیط، نام محیط خود را وارد کنید. میتوانید هر نامی که میخواهید برای محیط انتخاب کنید. در این مثال، staging است.
- روی ذخیره کردن کلیک کنید.
وقتی عرضه 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 استفاده کنید.
مراحل بعدی
- عمیقتر شوید: یک codelab مربوط به Firebase را مرور کنید که یک برنامه میزبانیشده را با ویژگیهای Firebase Authentication و Gemini API ادغام میکند: Next.js | Angular
- اتصال دادن دامنه سفارشی.
- پیکربندی کردن پسای شما.
- عرضهها، استفاده از سایت، و گزارشها را پایش کنید.