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

با برنامه Next.js یا Angular موجود (نسخه‌های Next.js‏ ۱۳.۵.x+ یا Angular‏ ۱۸.۲.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 را شرح می‌دهد تا هر بار که یک commit جدید در مخزن GitHub ایجاد می‌شود، به‌طور خودکار مستقر شود. در پایان این جریان، یک برنامه نمونه Next.js یا Angular زنده خواهید داشت که هربار که تغییر جدیدی را در شاخه main مخزن GitHub خود ثبت می‌کنید، دوباره مستقر می‌شود.

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

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

اگر ازقبل برنامه Next.js یا Angular در مخزن GitHub دارید، می‌توانید این مرحله را رد کنید و به مرحله ۲: ایجاد کردن پس‌بخش App Hosting بروید. برای استقرار برنامه خودتان، نیازی به انشعاب یا نصب مخزن apphosting-adapters ندارید.

اگر برنامه موجودی ندارید و می‌خواهید برنامه نمونه‌ای را مستقر کنید، به https://github.com/firebase/apphosting-adapters بروید و Fork را انتخاب کنید. علاوه‌بر ابزار آداپتور چارچوب، این مخزن شامل الگوهای شروع رسمی Next.js و Angular در دایرکتوری /starters است.

مرحله ۲: ساختن پسای App Hosting

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

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

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

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

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

  • منطقه اصلی را انتخاب کنید (معمولاً منطقه‌ای که به کاربران شما نزدیک‌تر است).

  • به GitHub متصل شوید. مخزنی را که با انشعاب مخزن apphosting-adapters ایجاد کرده‌اید انتخاب کنید، یا مخزن برنامه موجودتان را انتخاب کنید.

  • دایرکتوری ریشه برنامه‌تان را تنظیم کنید:

    • اگر برنامه خودتان را مستقر می‌کنید، دایرکتوری ریشه برنامه‌تان را مشخص کنید (به‌طور پیش‌فرض / است). این دایرکتوری معمولاً جایی است که فایل package.json شما در آن قرار دارد.

    • اگر از مخزن نمایشی apphosting-adapters استفاده می‌کنید، دایرکتوری ریشه برنامه‌تان را روی یکی از مسیرهای زیر تنظیم کنید:

    • /starters/nextjs/basic

    • /starters/angular/basic

  • شاخه فعال را به‌عنوان اصلی تنظیم کنید.

  • عرضه خودکار را فعال کنید (عرضه خودکار به‌طور پیش‌فرض فعال است).

  • نامی به پسای خود اختصاص دهید.

  • محیط زمان اجرای خود را انتخاب کنید. به‌طور پیش‌فرض، جدیدترین نسخه توصیه‌شده 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 را پایش کنید تا تغییر جدیدتان در نسخه تولید عرضه شود. وقتی عرضه تکمیل شد، می‌توانید تغییرتان را در صفحه اصلی برنامه مشاهده کنید.

مراحل بعدی