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

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

مراحل بعدی