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

با یک برنامه Next.js یا Angular موجود (Next.js نسخه‌های 13+ یا Angular 17.2+) در مخزن GitHub، شروع به کار با App Hosting می‌تواند به همان سادگی ایجاد یک App Hosting Backend و سپس شروع عرضه با فشار به شاخه زنده شما اگر برنامه ای ندارید، از یکی از برنامه های نمونه ما استفاده کنید تا مراحل توضیح داده شده در این راهنما را طی کنید.

قبل از شروع

قبل از اینکه بتوانید Firebase App Hosting راه اندازی کنید، باید یک پروژه Firebase ایجاد کنید (اگر قبلاً آن را ندارید) و به طرح Blaze ارتقا دهید.

برای ایجاد یک پروژه:

  1. در کنسول Firebase ، روی افزودن پروژه کلیک کنید.

    • برای افزودن منابع Firebase به پروژه Google Cloud موجود ، نام پروژه آن را وارد کنید یا آن را از منوی کشویی انتخاب کنید.

    • برای ایجاد یک پروژه جدید، نام پروژه مورد نظر را وارد کنید. همچنین می توانید به صورت اختیاری شناسه پروژه نمایش داده شده در زیر نام پروژه را ویرایش کنید.

  2. در صورت درخواست، شرایط Firebase را بررسی کرده و بپذیرید.

  3. روی Continue کلیک کنید.

  4. (اختیاری) Google Analytics برای پروژه خود راه اندازی کنید، که به شما امکان می دهد با استفاده از هر یک از محصولات Firebase زیر تجربه ای بهینه داشته باشید:

    یا یک حساب Google Analytics موجود را انتخاب کنید یا یک حساب جدید ایجاد کنید.

    اگر حساب جدیدی ایجاد می‌کنید، مکان گزارش Analytics خود را انتخاب کنید، سپس تنظیمات اشتراک‌گذاری داده و شرایط Google Analytics را برای پروژه خود بپذیرید.

  5. روی ایجاد پروژه (یا افزودن Firebase ، اگر از پروژه Google Cloud موجود استفاده می کنید) کلیک کنید.

Firebase به طور خودکار منابع پروژه Firebase شما را فراهم می کند. پس از تکمیل فرآیند، به صفحه نمای کلی پروژه Firebase خود در کنسول Firebase هدایت خواهید شد.

مرحله 0 (اختیاری): یک مخزن GitHub و برنامه وب ایجاد کنید

اگر قبلاً یک برنامه وب در مخزن GitHub ندارید، یا اگر ترجیح می‌دهید جریان را با یک برنامه نمونه امتحان کنید، با مقداردهی اولیه یکی از نمونه‌های ما، برای Next.js یا Angular شروع کنید:

npm init @apphosting

می توانید برنامه نمونه را به صورت محلی با استفاده از next dev یا ng start اجرا کنید. برای ادامه، یک مخزن جدید GitHub ایجاد کنید و کد نمونه تازه راه‌اندازی شده را به آن فشار دهید.

مرحله 1: یک باطن App Hosting ایجاد کنید

پشتیبان App Hosting مجموعه ای از منابع مدیریت شده است که App Hosting برای ساخت و اجرای برنامه وب شما ایجاد می کند. می‌توانید با استفاده از کنسول Firebase یا Firebase CLI، پشتیبان‌های App Hosting را ایجاد و فهرست کنید.

کنسول Firebase : از منوی Build ، App Hosting را انتخاب کنید و سپس شروع کنید .

CLI: (نسخه 13.15.4 یا بالاتر) برای ایجاد یک Backend، دستور زیر را از ریشه دایرکتوری پروژه محلی خود اجرا کنید و ID project و منطقه ترجیحی خود را به عنوان آرگومان ارائه کنید:

firebase apphosting:backends:create --project PROJECT_ID --location us-central1

برای هر دو کنسول یا CLI، دستورات را دنبال کنید تا یک نام به باطن خود اختصاص دهید، یک اتصال GitHub راه اندازی کنید، و این تنظیمات اولیه استقرار را پیکربندی کنید:

  • دایرکتوری ریشه برنامه خود را تنظیم کنید (به طور پیش فرض روی / )

    این معمولاً جایی است که فایل package.json شما قرار دارد.

  • شاخه زنده را تنظیم کنید

    این شاخه ای از مخزن GitHub شما است که در URL زنده شما مستقر می شود. اغلب، این شاخه ای است که شاخه های ویژگی یا شاخه های توسعه در آن ادغام می شوند.

  • پذیرش یا رد عرضه خودکار

    عرضه خودکار به طور پیش فرض فعال است. پس از اتمام ایجاد باطن، می توانید انتخاب کنید که برنامه شما بلافاصله در App Hosting مستقر شود.

مرحله 2: برنامه مستقر را مشاهده کنید

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

برای مشاهده URL برنامه وب خود، کنسول Firebase را بررسی کنید یا دستور CLI زیر را اجرا کنید:

firebase apphosting:backends:get --project PROJECT_ID {BACKEND_ID} --location us-central1

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

هنگامی که باطن شما ایجاد شد و یک URL زنده دارید، می توانید هر زمان که تغییرات را در شاخه زنده مخزن GitHub خود اعمال کنید، انتشار نسخه جدیدی از برنامه وب خود را راه اندازی کنید. برای انجام تست تنظیمات App Hosting :

  1. در GitHub، تغییری را به شاخه زنده برنامه وب فشار دهید.
  2. تب App Hosting را در کنسول Firebase باز کنید و View dashboard را برای باطن خود انتخاب کنید. لیست جدول تعهد خاص مرتبط با عرضه ایجاد شده توسط تغییر شما را نشان می دهد.

مراحل بعدی