برنامه خود را با Firebase Studio منتشر کنید، برنامه خود را با Firebase Studio منتشر کنید، برنامه خود را با Firebase Studio منتشر کنید، برنامه خود را با Firebase Studio منتشر کنید

Firebase Studio گزینه‌های انتشار متعددی ارائه می‌دهد و به شما این امکان را می‌دهد که روشی را انتخاب کنید که به بهترین وجه با نیازهای پروژه شما مطابقت داشته باشد. در اینجا مروری بر گزینه‌های موجود داریم:

  • Firebase App Hosting : App Hosting که برای انتشار برنامه‌های پویای Next.js و Angular ایده‌آل است، پشتیبانی از چارچوب داخلی، ادغام با GitHub و ادغام با سایر محصولات Firebase مانند Firebase Authentication ، Cloud Firestore و Firebase AI Logic را ارائه می‌دهد.

    اگر یک برنامه Next.js را با استفاده از App Prototyping agent توسعه داده‌اید، می‌توانید آن را مستقیماً از Firebase Studio و تنها با چند کلیک منتشر کنید.

  • Firebase Hosting : برای میزبانی برنامه‌های وب و محتوای وب استاتیک (HTML، CSS، جاوا اسکریپت، تصاویر و سایر دارایی‌های استاتیک) و برنامه‌های تک صفحه‌ای بسیار مناسب است. Firebase Hosting از طریق یک CDN جهانی، گواهینامه‌های SSL رایگان و پشتیبانی دامنه سفارشی، تحویل سریع محتوا را فراهم می‌کند.

    اگر یک برنامه وب استاتیک یا تک صفحه‌ای را در Firebase Studio توسعه داده‌اید، می‌توانید با درخواست انتشار برنامه از Gemini در Firebase مستقیماً آن را از Firebase Studio منتشر کنید.

  • Cloud Run : از Cloud Run برای استقرار برنامه‌های کانتینر شده استفاده کنید. این گزینه خوبی برای انتشار برنامه‌های مقیاس‌پذیر و قابل حمل است که می‌توانند روی هر پلتفرمی اجرا شوند.

  • سایر گزینه‌های استقرار: استقرار در راهکار میزبانی مورد نظر شما، از جمله پلتفرم‌های دیگر یا سرور خودتان.

برنامه خود را با Firebase App Hosting منتشر و نظارت کنید

بعد از اینکه برنامه خود را آزمایش کردید و از آن در فضای کاری خود راضی بودید، می‌توانید آن را با Firebase App Hosting در وب منتشر کنید.

وقتی App Hosting راه‌اندازی می‌کنید، Firebase Studio یک پروژه Firebase برای شما ایجاد می‌کند (اگر قبلاً با تولید خودکار کلید API Gemini یا سایر سرویس‌های backend، پروژه‌ای ایجاد نشده باشد) و شما را در اتصال یک حساب Cloud Billing راهنمایی می‌کند.

برای انتشار برنامه خود:

  1. برای تنظیم پروژه Firebase و انتشار برنامه خود، روی Publish کلیک کنید. پنجره Publish your app ظاهر می‌شود.

  2. در مرحله پروژه Firebase ، App Prototyping agent پروژه Firebase مرتبط با فضای کاری را نمایش می‌دهد. اگر پروژه Firebase از قبل وجود نداشته باشد، App Prototyping agent یک پروژه جدید برای شما ایجاد می‌کند. برای ادامه روی Next کلیک کنید.

  3. در مرحله حساب Link Cloud Billing ، یکی از موارد زیر را انتخاب کنید:

    • حساب Cloud Billing که می‌خواهید به پروژه Firebase خود پیوند دهید را انتخاب کنید.

    • اگر حساب Cloud Billing ندارید یا می‌خواهید یک حساب جدید ایجاد کنید، روی «ایجاد یک حساب Cloud Billing کلیک کنید. این کار کنسول Google Cloud را باز می‌کند، جایی که می‌توانید یک حساب Cloud Billing سلف سرویس جدید ایجاد کنید . پس از ایجاد حساب، به Firebase Studio برگردید و حساب را از لیست Link Cloud Billing انتخاب کنید.

  4. روی Next کلیک کنید. Firebase Studio حساب صورتحساب را به پروژه مرتبط با فضای کاری شما پیوند می‌دهد، که یا هنگام تولید خودکار کلید API Gemini یا هنگام کلیک روی Publish ایجاد شده است.

  5. روی راه‌اندازی سرویس‌ها کلیک کنید. عامل نمونه‌سازی برنامه، تأمین سرویس‌های Firebase را آغاز می‌کند.

  6. روی «انتشار اکنون» کلیک کنید. Firebase Studio سرویس‌های فایربیس را راه‌اندازی می‌کند و سپس بخش App Hosting را راه‌اندازی می‌کند. تکمیل این مرحله ممکن است تا چند دقیقه طول بکشد. برای کسب اطلاعات بیشتر در مورد آنچه در پشت صحنه اتفاق می‌افتد، به فرآیند ساخت App Hosting مراجعه کنید.

  7. وقتی مرحله انتشار کامل شد، نمای کلی برنامه با یک URL و اطلاعات برنامه که توسط قابلیت مشاهده App Hosting ارائه می‌شود، ظاهر می‌شود. برای استفاده از یک دامنه سفارشی (مانند example.com یا app.example.com) به جای دامنه تولید شده توسط Firebase، می‌توانید یک دامنه سفارشی در کنسول Firebase اضافه کنید.

برای اطلاعات بیشتر در مورد App Hosting ، به بخش «درک App Hosting و نحوه عملکرد آن» مراجعه کنید.

(فقط Cloud Firestore ) قوانین امنیتی را در محیط عملیاتی تأیید کنید

وقتی انتشار کامل شد و برنامه شما در Firebase مستقر شد، Cloud Firestore و Firebase Authentication آماده آزمایش در محیط عملیاتی هستند.

مشاهده داده‌های احراز هویت Cloud Firestore و Firebase Authentication در کنسول Firebase

شما می‌توانید داده‌های زنده‌ی برنامه‌ی خود را پس از انتشار، در کنسول Firebase مشاهده کنید.

  • برای مشاهده پایگاه داده زنده Cloud Firestore خود، کنسول Firebase را باز کنید و از منوی ناوبری، Build > Firestore Database را انتخاب کنید.

    از اینجا، می‌توانید داده‌های ذخیره شده را بررسی کنید، قوانین امنیتی خود را مشاهده و آزمایش کنید و ایندکس ایجاد کنید. برای اطلاعات بیشتر به Cloud Firestore مراجعه کنید.

  • برای مشاهده داده‌های Firebase Authentication خود، کنسول Firebase را باز کنید و از منوی ناوبری، Build > Authentication را انتخاب کنید.

    از اینجا، می‌توانید پیکربندی احراز هویت و کاربران برنامه خود را بررسی کنید. برای اطلاعات بیشتر به Firebase Authentication مراجعه کنید.

قوانین تست Cloud Firestore در محیط عملیاتی

پس از انتشار برنامه، باید قوانین امنیتی Cloud Firestore خود را دوباره در برابر محیط تولید خود آزمایش کنید. این به شما کمک می‌کند تا اطمینان حاصل کنید که داده‌های شما برای کاربران مجاز قابل دسترسی است و از دسترسی غیرمجاز محافظت می‌شود.

شما می‌توانید قوانین خود را با استفاده از تمام روش‌های زیر آزمایش کنید:

  • تست برنامه : با برنامه‌ی مستقر شده‌ی خود تعامل داشته باشید و عملیاتی را انجام دهید که الگوهای مختلف دسترسی به داده‌ها (خواندن، نوشتن، حذف) را برای نقش‌ها یا حالت‌های مختلف کاربر فعال می‌کند. این تست در دنیای واقعی به تأیید اجرای صحیح قوانین شما در عمل کمک می‌کند.

  • Rules Playground : برای بررسی‌های هدفمند، از Rules Playground در کنسول Firebase استفاده کنید. این ابزار به شما امکان می‌دهد درخواست‌ها (خواندن، نوشتن، حذف) را با استفاده از قوانین تولید خود در پایگاه داده Cloud Firestore شبیه‌سازی کنید. می‌توانید وضعیت احراز هویت کاربر، مسیر داده‌ها و نوع عملیات را مشخص کنید تا ببینید آیا قوانین شما دسترسی را طبق برنامه مجاز یا غیرمجاز می‌دانند.

  • تست واحد : برای تست جامع‌تر، می‌توانید تست‌های واحد برای قوانین امنیتی خود بنویسید. پیش‌نمایش Firebase Studio که توسط Firebase Local Emulator Suite پشتیبانی می‌شود، به شما امکان می‌دهد این تست‌ها را به صورت محلی اجرا کنید و رفتار قوانین تولید خود را شبیه‌سازی کنید. این یک روش قوی برای تأیید منطق پیچیده قوانین و تأیید پوشش برای سناریوهای مختلف است. پس از استقرار، باید دوباره بررسی کنید که تست‌های واحد شما با استفاده از شبیه‌ساز مطابق انتظار کار می‌کنند و همه سناریوها را پوشش می‌دهند.

برنامه خود را با قابلیت مشاهده App Hosting رصد کنید

پنل نمای کلی برنامه در Firebase Studio معیارهای کلیدی و اطلاعات مربوط به برنامه شما را ارائه می‌دهد و به شما امکان می‌دهد عملکرد برنامه وب خود را با استفاده از ابزارهای مشاهده داخلی App Hosting رصد کنید. پس از انتشار سایت، می‌توانید با کلیک روی Publish به نمای کلی دسترسی پیدا کنید. از این پنل می‌توانید:

  • برای انتشار نسخه جدید برنامه خود، روی انتشار کلیک کنید.
  • پیوند برنامه خود را به اشتراک بگذارید یا برنامه خود را مستقیماً در «بازدید از برنامه خود» باز کنید.
  • خلاصه‌ای از عملکرد برنامه خود را در ۷ روز گذشته، از جمله تعداد کل درخواست‌ها و وضعیت آخرین به‌روزرسانی خود، مرور کنید. برای دسترسی به اطلاعات بیشتر در کنسول Firebase ، روی «مشاهده جزئیات» کلیک کنید.
  • نموداری از تعداد درخواست‌هایی که برنامه شما در ۲۴ ساعت گذشته دریافت کرده است، بر اساس کد وضعیت HTTP، مشاهده کنید.
  • وضعیت فعال‌سازی سرویس‌های Firebase مانند Firebase Authentication و Cloud Firestore را مشاهده کنید.

اگر پنل نمای کلی برنامه را ببندید، می‌توانید هر زمان که خواستید با کلیک روی «انتشار» دوباره آن را باز کنید.

برای اطلاعات بیشتر در مورد مدیریت و نظارت بر انتشارهای App Hosting به بخش «مدیریت انتشارها و نسخه‌ها» مراجعه کنید.

سایت App Hosting خود را به حالت اولیه برگردانید

اگر نسخه‌های متوالی از برنامه خود را در App Hosting مستقر کرده‌اید، می‌توانید آن را به یکی از نسخه‌های قبلی برگردانید. همچنین می‌توانید آن را حذف کنید.

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

    1. App Hosting در کنسول Firebase باز کنید.

    2. بخش مدیریت برنامه خود را پیدا کنید، روی View و سپس روی Rollouts کلیک کنید.

    3. در کنار پیاده‌سازی که می‌خواهید به آن برگردید، روی More کلیک کنید، سپس Roll back to this build را انتخاب کنید و تأیید کنید.

    برای اطلاعات بیشتر به مدیریت انتشارها و عرضه‌ها مراجعه کنید.

  • برای حذف دامنه App Hosting خود از وب:

    1. از کنسول Firebase ، App Hosting باز کنید و در بخش برنامه Firebase Studio روی View کلیک کنید.

    2. در بخش اطلاعات Backend ، روی مدیریت کلیک کنید. صفحه دامنه‌ها بارگذاری می‌شود.

    3. در کنار دامنه خود، روی More کلیک کنید، سپس Disable domain را انتخاب کنید و تأیید کنید.

    این کار دامنه شما را از وب حذف می‌کند. برای حذف کامل بک‌اند App Hosting خود، دستورالعمل‌های موجود در بخش «حذف بک‌اند» را دنبال کنید.

Firebase Hosting

شما می‌توانید برنامه‌های وب استاتیک و تک صفحه‌ای را از فضای کاری Firebase Studio خود در Firebase Hosting منتشر کنید.

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

انتشار با Gemini در Firebase

  1. در چت Gemini در Firebase ، عبارتی مانند «Publish my app» را وارد کنید.

  2. Gemini در Firebase شما را در مراحل لازم راهنمایی می‌کند. این مراحل می‌تواند شامل ایجاد یک پروژه Firebase و ثبت برنامه شما باشد، اگر قبلاً این کار را انجام نداده‌اید.

انتشار از پنل Firebase Studio

Firebase Hosting برای سایت‌های استاتیک و برنامه‌های تک صفحه‌ای بهینه شده است. اگر پروژه شما محتوای دینامیک دارد، ممکن است Gemini در Firebase جریان انتشار را آغاز نکند. اگر این اتفاق افتاد اما همچنان می‌خواهید از Firebase Hosting استفاده کنید، پروژه خود را از پنل Firebase Studio منتشر کنید:

  1. اگر قبلاً این کار را نکرده‌اید، یک پروژه Firebase ایجاد کنید و برنامه خود را ثبت کنید .

  2. فضای کاری Firebase Studio خود را باز کنید.

    • اگر از App Prototyping agent استفاده می‌کنید، کلیک کنید نماد تغییر کد برای باز کردن نمای Code به بخش کد بروید .
  3. در پنل ناوبری، روی آیکون Firebase Studio کلیک کنید تا پنل باز شود، سپس بخش Firebase Hosting را باز کنید.

  4. روی تأیید اعتبار Firebase کلیک کنید و دستورالعمل‌های موجود در پنجره ترمینال را برای تأیید اعتبار حساب Firebase خود دنبال کنید.

  5. روی Initialize Firebase Hosting کلیک کنید و دستورالعمل‌های پنجره ترمینال را دنبال کنید تا پیکربندی استقرار خود را تنظیم کنید.

  6. برای استقرار برنامه خود، از بخش Firebase Hosting در پنل Firebase Studio ، روی Deploy to Production یا Deploy to Channel کلیک کنید.

Cloud Run

قبل از اینکه با استفاده از Cloud Run مستقر شوید، مطمئن شوید که یک پروژه Google Cloud راه‌اندازی کرده‌اید و Cloud Billing فعال کرده‌اید .

  1. فضای کاری Firebase Studio خود را باز کنید. اگر از App Prototyping agent استفاده می‌کنید، روی نماد تغییر کد برای باز کردن نمای Code به بخش کد بروید .

  2. روی آیکون Firebase Studio در پنل ناوبری کلیک کنید تا پنل Firebase Studio باز شود و سپس روی Deploy to Cloud Run کلیک کنید.

  3. گزینه «اجازه دسترسی به منابع Google Cloud با استفاده از حساب گوگل من» را انتخاب کنید و سپس از پنجره‌های محاوره‌ای، یک پروژه Google Cloud با قابلیت پرداخت را انتخاب کنید.

  4. از بخش Cloud Run در پنل Firebase Studio روی Authenticate کلیک کنید و مراحل احراز هویت را دنبال کنید.

  5. روی Deploy کلیک کنید و دستورالعمل‌ها را دنبال کنید تا پیکربندی استقرار خود را تنظیم کرده و برنامه خود را مستقر کنید.

مراحل بعدی