شروع کار با «میزبانی برنامه»

با برنامه موجود Next.js یا Angular (نسخه‌های Next.js 13.5.x+‎ یا Angular 18.2.x+‎) در مخزن GitHub، شروع کار با App Hosting می‌تواند به سادگی ایجاد زیرینه App Hosting و سپس شروع راه‌اندازی با فشار دادن به شاخه زنده باشد. اگر برنامه ندارید، از یکی از برنامه‌های نمونه ما برای آشنایی با مراحل شرح‌داده‌شده در این راهنما استفاده کنید.

برای دریافت کمک از هوش مصنوعی، پیام‌واره زیر را در عامل کدنویسی هوش مصنوعی خود (مثل Antigravity،‏ Claude Code،‏ Codex، و Cursor) کپی کنید. می‌توانید پیام‌واره را سفارشی‌سازی کنید و با نماینده‌تان تکرار کنید. برای اطلاعات دقیق نصب، به مهارت‌های عامل Firebase مراجعه کنید. 

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`.  Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me use Firebase to host my web app. Set up my app to use Firebase, and then deploy my app.

این راهنما نحوه راه‌اندازی App Hosting در کنسول Firebase را برای استقرار خودکار هربار که تعهد جدیدی در مخزن GitHub ایجاد می‌شود شرح می‌دهد. در پایان این جریان، برنامه نمونه زنده Next.js یا Angular خواهید داشت که هر بار که تغییر جدیدی را در شاخه main مخزن GitHub خود تعهد می‌کنید، مجدداً مستقر می‌شود.

اگرچه این راهنما بر جریان کنسول Firebase توصیه‌شده تمرکز دارد، روش‌های دیگری برای استقرار وجود دارد، ازجمله استفاده از Firebase CLI برای استقرار کد محلی بدون اتصال GitHub.

مرحله ۱: انشعاب‌گیری از مخزن نسخه نمایشی

به https://github.com/firebase/apphosting-adapters مراجعه کنید و انشعاب را انتخاب کنید.

مرحله ۲: ایجاد زیرینه App Hosting

  1. در کنسول Firebase، به میزبانی و بدون سرور > میزبانی برنامه پیمایش کنید.

  2. روی شروع به کار کلیک کنید.

  3. درصورت درخواست، برای استفاده از App Hosting به طرح قیمت‌گذاری Blaze پرداخت به اندازه استفاده ارتقا دهید.

نماگرفتی از راه‌اندازی زیرینه «میزبانی برنامه».

برای تکمیل این مراحل، پیام‌واره‌ها را دنبال کنید:

  • یک منطقه اصلی (معمولاً نزدیک‌ترین منطقه به کاربران شما) انتخاب کنید.
  • به GitHub متصل شوید. مخزنی را که به‌تازگی با انشعاب از مخزن apphosting-adapters ایجاد کرده‌اید انتخاب کنید.
  • دایرکتوری ریشه برنامه‌تان را روی یکی از موارد زیر تنظیم کنید:
  • شاخه زنده را به‌عنوان اصلی تنظیم کنید.
  • فعال کردن توزیع‌های خودکار (توزیع‌های خودکار به‌طور پیش‌فرض فعال هستند).
  • نامی به زیرینه خود اختصاص دهید.
  • محیط زمان اجرای خود را انتخاب کنید. به‌طور پیش‌فرض، جدیدترین نسخه پیشنهادی Node.js برای شما ازقبل انتخاب شده است.
    • به‌روزرسانی‌های خودکار تصویر پایه (ABIU) را پیکربندی کنید. ‫ABIU به‌طور پیش‌فرض فعال است و وصله‌های امنیتی را به‌طور خودکار روی محیط زیربنایی شما اعمال می‌کند. با انتخاب «مشخص نشده» برای زمان اجرا، می‌توانید از ABIU انصراف دهید.
  • برنامه وب Firebase جدیدی ایجاد کنید.

پایان و استقرار را انتخاب کنید.

مرحله ۳: مشاهده برنامه مستقرشده

وقتی زیرینه ایجاد می‌کنید، Firebase به شما زیردامنه‌ای بدون هزینه می‌دهد که کاربران نهایی بتوانند از برنامه وب شما بازدید کنند. قالب آن به‌صورت backend-id--project-id.us-central1.hosted.app است.

در ردیف اطلاعات زیرساخت در داشبورد زیرساخت، پیوند زیرساخت زنده را انتخاب کنید تا وب‌سایت جدیدتان را ببینید:

نماگرفتی از ردیف اطلاعات زیرینه با پیوند برنامه فعال تأکیدشده.

مرحله ۴: با فشار دادن تغییر، عرضه تدریجی را راه‌اندازی کنید

پس‌از ایجاد زیرینه و داشتن نشانی وب زنده، می‌توانید هرگاه تغییراتی را به شاخه زنده مخزن GitHub خود انتقال می‌دهید، راه‌اندازی نسخه جدید برنامه تحت وب خود را راه‌اندازی کنید. برای انجام آزمایش تنظیمات App Hosting:

  1. در انشعاب مخزن GitHub نسخه نمایشی، به منبع صفحه اصلی برنامه نسخه نمایشی بروید، هر ویرایش قابل‌تشخیصی را که می‌خواهید انجام دهید، و سپس تغییر خود را به شاخه اصلی انتقال دهید. برای پیدا کردن صفحه اصلی:

    • Next.js: /starters/nextjs/basic/src/app/page.tsx
    • Angular: /starters/angular/basic/src/app/pages/home/home.component.html

  2. در کنسول Firebase، App Hosting را هم‌زمان با عرضه تغییر جدیدتان به تولید پایش کنید. وقتی عرضه کامل شد، می‌توانید تغییرتان را در صفحه اصلی برنامه مشاهده کنید.

مراحل بعدی