اگر عرضه خودکار را فعال کرده اید، هر بار که یک commit جدید را به شعبه زنده در مخزن GitHub خود فشار دهید App Hosting به طور خودکار نسخه جدیدی از برنامه شما را عرضه می کند. میتوانید وضعیت عرضه را در کنسول Firebase یا در بررسی GitHub App Hosting بررسی کنید.
علاوه بر این، App Hosting از عرضههای راهاندازی دستی برای یکپارچهسازی CI/CD یا هر مورد دیگری که میخواهید به اجبار عرضه شود، پشتیبانی میکند.
مشاهده عرضهها
کنسول Firebase دسترسی به اطلاعات دقیق در مورد همه عرضههای برنامه شما را فراهم میکند. در App Hosting ، View را برای باطنی که میخواهید عرضههای آن را ببینید، انتخاب کنید. برگه Rollouts برای باطن، جدولی را نشان می دهد که تاریخچه همه عرضه ها را برای این باطن فهرست می کند.
هر ورودی عرضه حاوی پیوندهایی به کار Cloud Build و تغییر یا تعهدی است که راهاندازی آن را آغاز کرده است، همراه با اطلاعات اولیه درباره نویسنده، تاریخ ایجاد و وضعیت عرضه.
- کار Cloud Build محیط ساختی است که در آن App Hosting دستور ساخت برنامه شما را اجرا می کند. با کلیک بر روی شناسه ساخت می توانید به گزارش های Cloud Build دسترسی پیدا کنید.
- Change commit GitHub یا اقدام دیگری است که راهاندازی انتشار آن است.
به صورت دستی یک عرضه را راه اندازی کنید
اگر میخواهید بهصورت دستی یک عرضه از منبع GitHub خود را بدون فشار دادن یک commit جدید راهاندازی کنید، میتوانید یک عرضه از کنسول Firebase یا Firebase CLI ایجاد کنید. این برای مواردی مانند:
- اجبار به بازسازی محتوای ایستا.
- اجازه دادن به سیستم CI/CD برای راهاندازی عرضه.
- محدود کردن عرضه تولید به تاریخ یا زمان خاص.
برای راه اندازی عرضه در کنسول Firebase :
- در App Hosting ، View را برای باطنی که میخواهید برای آن عرضه کنید، انتخاب کنید.
- در خلاصه داشبورد باطن، Create rollout را انتخاب کنید.
- شعبه مورد نظر را برای استقرار انتخاب کنید.
- commit را برای استقرار انتخاب کنید، یا آخرین commit یا commit قبلی که توسط commit ID آن مشخص شده است.
- ایجاد را انتخاب کنید. وضعیت و یک شماره ساخت برای عرضه در جدول تاریخچه عرضه نمایش داده می شود. هنگامی که فرآیند عرضه کامل شد، این عرضه به عنوان عرضه فعلی نمایش داده می شود.
برای راه اندازی یک عرضه در Firebase CLI، دستور زیر را اجرا کنید و زمانی که از شما خواسته شد، شاخه را برای عرضه انتخاب کنید:
firebase apphosting:rollouts:create BACKEND_ID
همچنین، میتوانید با استفاده از گزینه --git-branch
یک rollout برای آخرین commit برای یک شاخه خاص شروع کنید:
firebase apphosting:rollouts:create BACKEND_ID
--git_branch BRANCH_NAME
شما همچنین می توانید با استفاده از گزینه --git-commit
یک rollout با یک commit خاص ایجاد کنید:
firebase apphosting:rollouts:create BACKEND_ID
--git_commit COMMIT_ID
بازیابی عرضه قبلی
میزبانی برنامه دو گزینه برای بازیابی نسخه قبلی در اختیار شما قرار می دهد:
- فوراً بدون بازسازی به عقب برگردید
- بازسازی کنید و به نسخه قبلی برگردید
یک بازگشت فوری ایجاد کنید
گاهی اوقات ممکن است لازم باشد به سرعت به نسخه قدیمیتر برنامه خود بازگردید - برای مثال، اگر یک اشکال مهم را در یک نسخه جدید کشف کردهاید یا با یک ساختار پوستهپوسته مواجه هستید که عرضههای جدید را مسدود میکند. در چنین مواردی می توانید یک تصویر کانتینر موجود به انتخاب خود را از نسخه قبلی بازیابی کنید. این تصویر بازسازی نشده است، اما از پیکربندی کد و محیط از زمانی که برای اولین بار ساخته شده است استفاده می کند.
برای ایجاد یک بازگشت فوری:
- در App Hosting ، View را برای باطنی که میخواهید برای آن بازگشت ایجاد کنید، انتخاب کنید.
- تب Rollouts را انتخاب کنید.
- در جدول History برای باطن، منوی سه نقطه ای را برای ساخت قبلی انتخاب کنید.
- Roll back to this build را انتخاب کرده و تایید کنید.
بازسازی کنید و به عقب برگردید
اگر میخواهید به نسخه قدیمیتر برنامه خود برگردید، اما همچنان پیکربندی فعلی را حفظ کنید، میتوانید برنامه را به عنوان بخشی از فرآیند بازگشت دوباره بسازید. به عنوان مثال، اگر آخرین نسخه شما یک مقدار کلید API را در Secret Manager بهروزرسانی کرده است، بازسازی مجدد میتواند اطمینان حاصل کند که کلید جدید پس از برگشت در برنامه شما استفاده میشود.
برای بازسازی و عقب نشینی:
- در App Hosting ، مشاهده داشبورد را برای باطنی که میخواهید برای آن بازگشت ایجاد کنید، انتخاب کنید.\
- تب Rollouts را انتخاب کنید.
- Create rollout را انتخاب کنید.
- در گفتگوی Create a rollout ، Earlier commit را علامت بزنید و سپس شناسه commit را برای نسخه ای که می خواهید بازسازی کنید وارد کنید و به آن برگردید. شناسه تعهد بخشی از "تغییر جزئیات" برای هر عرضه فهرست شده در تاریخچه عرضه شما است که در داخل پرانتز در برچسب موجود است.
- برای شروع بازگشت، Create را انتخاب کنید.
تنظیمات عرضه را تغییر دهید
میتوانید شاخه زنده را برای عرضهها تغییر دهید و با استفاده از کنترلهای موجود در تنظیمات > نمای استقرار در داشبورد برای یک backend، عرضه خودکار را غیرفعال یا فعال کنید.
- در App Hosting ، مشاهده را برای قسمتی که میخواهید تنظیمات عرضه را بهروزرسانی کنید، انتخاب کنید.
- در داشبورد باطن، تنظیمات را انتخاب کنید. نمای پیش فرض اطلاعات مربوط به دامنه ها و دامنه های سفارشی را نمایش می دهد.
- نمای Deployment را انتخاب کنید. در این نما میتوانید شاخه زنده را برای عرضهها تغییر دهید و عرضههای خودکار را غیرفعال یا فعال کنید. همچنین، گزینه هایی برای تنظیم دایرکتوری ریشه برنامه و محیط برای backend وجود دارد ( به استقرار در چندین محیط مراجعه کنید).