برنامه وب را به‌صورت محلی آزمایش کنید، تغییرات را با دیگران هم‌رسانی کنید، سپس به‌صورت زنده مستقر کنید

قبل‌از استقرار در سایت فعال، باید تغییراتتان را مشاهده و آزمایش کنید. Firebase Hosting به شما امکان می‌دهد تغییرات را به‌صورت محلی مشاهده و آزمایش کنید و با منابع پروژه باطن شبیه‌سازی‌شده تعامل داشته باشید. اگر لازم است هم‌تیمی‌هایتان تغییرات شما را مشاهده و آزمایش کنند، Hosting می‌تواند نشانی‌های وب پیش‌نمایش موقت و قابل‌هم‌رسانی برای سایت شما ایجاد کند. ما حتی از ادغام GitHub برای استقرار از درخواست pull پشتیبانی می‌کنیم.

قبل از شروع

مراحل فهرست‌شده در Hosting صفحه شروع به کار، به‌ویژه تکالیف زیر را تکمیل کنید:

  1. Firebase CLI را نصب کنید یا به جدیدترین نسخه به‌روز کنید.
  2. فهرست راهنمای پروژه محلی (حاوی محتوای برنامه) را به پروژه Firebase متصل کنید.

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

مرحله ۱: آزمایش محلی

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

Hosting بخشی از Firebase Local Emulator Suite است که به برنامه شما امکان می‌دهد با محتوا و پیکربندی شبیه‌سازی‌شده Hosting و همچنین به‌صورت اختیاری با منابع پروژه شبیه‌سازی‌شده شما (توابع، پایگاه‌های داده، و قوانین) تعامل داشته باشد.

  1. (اختیاری) به‌طور پیش‌فرض، برنامه میزبانی‌شده محلی شما با منابع پروژه (توابع، پایگاه داده، قوانین، و غیره) واقعی، نه شبیه‌سازی‌شده، تعامل خواهد داشت. درعوض، می‌توانید به‌طور اختیاری برنامه‌تان را متصل کنید تا از هر منبع پروژه شبیه‌سازی‌شده‌ای که پیکربندی کرده‌اید استفاده کنید. بیشتر بدانید: Realtime Database | Cloud Firestore | Cloud Functions

  2. از ریشه فهرست راهنمای پروژه محلی‌تان، فرمان زیر را اجرا کنید:

    firebase emulators:start
  3. برنامه وب را در نشانی وب محلی که CLI برگردانده است (معمولاً http://localhost:5000) باز کنید.

  4. برای به‌روزرسانی نشانی وب محلی با تغییرات، مرورگرتان را بازآوری کنید.

آزمایش از دستگاه‌های محلی دیگر

به‌طور پیش‌فرض، شبیه‌سازها فقط به درخواست‌های localhost پاسخ می‌دهند. این بدین معنی است که می‌توانید از مرورگر وب رایانه‌تان به محتوای میزبانی‌شده دسترسی داشته باشید اما از دستگاه‌های دیگر در شبکه‌تان نمی‌توانید. اگر می‌خواهید از دستگاه‌های محلی دیگر آزمایش کنید، firebase.json خود را به این صورت پیکربندی کنید:

"emulators": {
    // ...

    "hosting": {
      "port": 5000,
      "host": "0.0.0.0"
    }
  }

مرحله ۲: پیش‌دید و هم‌رسانی

اگر می‌خواهید دیگران تغییرات برنامه وب شما را قبل‌از فعال شدن مشاهده کنند، می‌توانید از کانال‌های پیش‌نمایش استفاده کنید.

پس‌از استقرار در کانال پیش‌نمایش، Firebase برنامه وب شما را در «نشانی وب پیش‌نمایش» ارائه می‌کند که نشانی وب موقت و قابل‌هم‌رسانی است. هنگام استفاده از نشانی وب پیش‌نمایش، برنامه وب شما با باطن واقعی شما برای همه منابع پروژه تعامل دارد (به‌استثنای هرگونه تابع «سنجاق‌شده» در پیکربندی بازنویسی‌های شما).

توجه داشته باشید که اگرچه حدس زدن نشانی‌های وب پیش‌نمایش دشوار است (زیرا حاوی درهم‌سازی تصادفی هستند)، اما عمومی هستند. بنابراین، هر کسی که نشانی وب را بداند می‌تواند به آن دسترسی داشته باشد.

  1. از ریشه فهرست راهنمای پروژه محلی‌تان، فرمان زیر را اجرا کنید:

    firebase hosting:channel:deploy CHANNEL_ID

    ‫CHANNEL_ID را با رشته‌ای بدون فاصله جایگزین کنید (برای مثال، feature_mission-2-mars). از این شناسه برای ساختن نشانی وب پیش‌نمایش منسوب به کانال پیش‌نمایش استفاده خواهد شد.

  2. برنامه وب را در نشانی وب پیش‌نمایش که توسط CLI برگردانده شده است باز کنید. چیزی شبیه به این خواهد بود: PROJECT_ID--CHANNEL_ID-RANDOM_HASH.web.app

  3. برای به‌روزرسانی نشانی وب پیش‌نمایش با تغییرات، همان فرمان را دوباره اجرا کنید. حتماً همان CHANNEL_ID را در فرمان مشخص کنید.

درباره مدیریت کانال‌های پیش‌نمایش، ازجمله نحوه تنظیم انقضای کانال، بیشتر بدانید.

Firebase Hosting از GitHub Action پشتیبانی می‌کند که وقتی تغییرات را به درخواست واکشی ارسال می‌کنید، به‌طور خودکار نشانی وب پیش‌نمایش ایجاد و به‌روز می‌کند. با نحوه راه‌اندازی و استفاده از این GitHub Action آشنا شوید.

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

وقتی آماده بودید تغییراتتان را با دنیا هم‌رسانی کنید، محتوا و پیکربندی Hosting را در کانال زنده‌تان مستقر کنید. Firebase چند گزینه مختلف برای این مرحله ارائه می‌دهد که به مورد استفاده شما بستگی دارد (گزینه‌های زیر را ببینید).

گزینه ۱: کلون کردن از کانال پیش‌نمایش به کانال زنده

این گزینه اطمینان می‌دهد که محتوا و پیکربندی دقیقی را که در کانال پیش‌نمایش آزمایش کرده‌اید در کانال زنده خود مستقر می‌کنید. درباره کلون کردن نسخه‌ها بیشتر بدانید.

  1. از هر فهرست راهنمایی، فرمان زیر را اجرا کنید:

    firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:live

    هر جای‌بان را با موارد زیر جایگزین کنید:

    • SOURCE_SITE_ID و TARGET_SITE_ID: این‌ها شناسه‌های Hosting سایتی هستند که کانال‌ها را دربردارند.

      • برای سایت پیش‌فرض Hosting، از شناسه پروژه Firebase خود استفاده کنید.
      • می‌توانید سایت‌هایی را که در یک پروژه Firebase یا حتی در پروژه‌های Firebase متفاوت هستند مشخص کنید.
    • SOURCE_CHANNEL_ID: این شناسه کانالی است که درحال‌حاضر نسخه‌ای را که می‌خواهید در کانال زنده خود مستقر کنید ارائه می‌دهد.

      • برای کانال زنده، از live به‌عنوان شناسه کانال استفاده کنید.
  2. تغییراتتان را مشاهده کنید (مرحله بعدی).

گزینه ۲: استقرار از دایرکتوری پروژه محلی به کانال زنده

این گزینه به شما انعطاف‌پذیری می‌دهد تا پیکربندی‌های خاص کانال زنده را تنظیم کنید یا حتی اگر از کانال پیش‌نمایش استفاده نکرده‌اید، آن را مستقر کنید.

  1. از ریشه فهرست راهنمای پروژه محلی‌تان، فرمان زیر را اجرا کنید:

    firebase deploy --only hosting
  2. تغییراتتان را مشاهده کنید (مرحله بعدی).

برای اطلاعات بیشتر، این پرسشگان را ببینید.

مرحله ۴: مشاهده تغییرات در سایت فعال

هر دو گزینه بالا محتوا و پیکربندی Hosting شما را در سایت‌های زیر مستقر می‌کنند:

  • زیردامنه‌های ارائه‌شده توسط Firebase برای سایت پیش‌فرض Hosting شما و هر سایت Hosting اضافی:
    SITE_ID.web.app (مانند PROJECT_ID.web.app)
    SITE_ID.firebaseapp.com (مانند PROJECT_ID.firebaseapp.com)

  • هرگونه دامنه سفارشی که به سایت(های) Hosting خود متصل کرده‌اید

برای محدود کردن استقرار به سایت Hosting خاص، هدف استقرار را در فرمان CLI مشخص کنید.

سایر فعالیت‌ها و اطلاعات استقرار

افزودن نظر برای استقرار

درصورت تمایل می‌توانید نظری به استقرار اضافه کنید. این نظر با سایر اطلاعات استقرار در داشبورد Hosting در کنسول Firebase نمایش داده می‌شود. برای مثال:

firebase deploy --only hosting -m "Deploying the best new feature ever."

افزودن تکالیف دستورگان پیش‌از استقرار و پس‌از استقرار

درصورت تمایل می‌توانید اسکریپت‌های پوسته را به فرمان firebase deploy متصل کنید تا کارهای پیش‌از استقرار یا پس‌از استقرار را انجام دهید. برای مثال، یک قلاب پس‌از استقرار می‌تواند به سرپرستان درباره استقرار محتوای جدید سایت اطلاع دهد. برای جزئیات بیشتر، به اسناد میانای خط فرمان Firebase مراجعه کنید.

ذخیره کردن محتوای مستقرشده در حافظه نهان

وقتی درخواستی برای محتوای ایستا ایجاد می‌شود، Firebase Hosting به‌طور خودکار محتوا را در CDN ذخیره می‌کند. اگر محتوای سایتتان را دوباره مستقر کنید، Firebase به‌طور خودکار همه محتوای ایستا ذخیره‌شده در حافظه نهان را در سراسر CDN پاک می‌کند تا درخواست‌های جدید محتوای جدیدتان را دریافت کنند.

توجه داشته باشید که می‌توانید ذخیره‌سازی محتوای پویا در حافظه نهان را پیکربندی کنید.

ارائه ازطریق HTTPS

مطمئن شوید که همه منابع خارجی که در Firebase Hosting میزبانی نمی‌شوند ازطریق SSL‏ (HTTPS) بارگیری می‌شوند، ازجمله هرگونه دستورگان خارجی. اکثر مرورگرها به کاربران اجازه نمی‌دهند «محتوای مختلط» (ترافیک SSL و غیر SSL) را بار کنند.

درحال حذف فایل‌ها

در Firebase Hosting، روش اصلی برای حذف فایل‌های انتخاب‌شده از سایت مستقرشده این است که فایل‌ها را به‌صورت محلی حذف کنید و سپس دوباره مستقر کنید.

مراحل بعدی