با داشتن یک برنامه Next.js یا Angular (نسخه‌های Next.js 13.5.x+ یا Angular 18.2.x+) موجود در مخزن GitHub، شروع کار با App Hosting می‌تواند به سادگی ایجاد یک Backend App Hosting و سپس شروع انتشار با ارسال به شاخه اصلی شما باشد. اگر برنامه‌ای ندارید، از یکی از برنامه‌های نمونه ما برای طی کردن مراحل شرح داده شده در این راهنما استفاده کنید.
برای مواردی که ترجیح می‌دهید یک برنامه Next.js یا Angular را بدون اتصال به مخزن GitHub مستقر کنید، App Hosting از روش‌های جایگزین برای استقرار با Terraform، Firebase Studio یا مستقیماً از منبع محلی پشتیبانی می‌کند. همیشه می‌توانید بعداً به مخزن GitHub متصل شوید.
قبل از اینکه شروع کنی
قبل از اینکه بتوانید Firebase App Hosting راه‌اندازی کنید، باید یک پروژه Firebase ایجاد کنید (اگر از قبل ندارید) و آن را به طرح Blaze ارتقا دهید.
برای ایجاد یک پروژه:
تازه وارد فایربیس یا کلود شده‌اید
اگر در استفاده از Firebase یا Google Cloud تازه‌کار هستید، این مراحل را دنبال کنید.
همچنین اگر می‌خواهید یک پروژه Firebase کاملاً جدید (و پروژه Google Cloud زیربنایی آن) ایجاد کنید، می‌توانید این مراحل را دنبال کنید.
- وارد کنسول Firebase شوید.
- برای ایجاد یک پروژه جدید Firebase، روی دکمه کلیک کنید.
در فیلد متن، نام پروژه را وارد کنید.
اگر عضوی از یک سازمان Google Cloud هستید، می‌توانید به صورت اختیاری انتخاب کنید که پروژه خود را در کدام پوشه ایجاد کنید.
- در صورت درخواست، شرایط Firebase را مرور و قبول کنید، سپس روی ادامه کلیک کنید.
- (اختیاری) دستیار هوش مصنوعی را در کنسول Firebase (به نام "Gemini in Firebase") فعال کنید، که می‌تواند به شما در شروع کار و ساده‌سازی فرآیند توسعه کمک کند.
(اختیاری) Google Analytics برای پروژه خود تنظیم کنید، که امکان تجربه بهینه با استفاده از این محصولات فایربیس را فراهم می‌کند: Firebase A/B Testing ، Cloud Messaging ، Crashlytics ، In-App Messaging و Remote Config (شامل شخصی‌سازی ).
یا یک حساب Google Analytics موجود را انتخاب کنید یا یک حساب جدید ایجاد کنید. اگر یک حساب جدید ایجاد می‌کنید، محل گزارش‌دهی Analytics خود را انتخاب کنید، سپس تنظیمات اشتراک‌گذاری داده‌ها و شرایط Google Analytics را برای پروژه خود بپذیرید.
- روی ایجاد پروژه کلیک کنید.
فایربیس پروژه شما را ایجاد می‌کند، برخی منابع اولیه را فراهم می‌کند و APIهای مهم را فعال می‌کند. پس از اتمام فرآیند، به صفحه نمای کلی پروژه فایربیس خود در کنسول Firebase منتقل خواهید شد.
پروژه ابری موجود
اگر می‌خواهید استفاده از فایربیس را با یک پروژه Google Cloud موجود شروع کنید، این مراحل را دنبال کنید. درباره «افزودن فایربیس» به یک پروژه Google Cloud موجود و عیب‌یابی آن بیشتر بدانید.
- با حسابی که به شما امکان دسترسی به پروژه Google Cloud موجود را می‌دهد، وارد کنسول Firebase شوید.
- برای ایجاد یک پروژه جدید Firebase، روی دکمه کلیک کنید.
- در پایین صفحه، روی «افزودن Firebase به پروژه Google Cloud» کلیک کنید.
- در فیلد متن، نام پروژه موجود را وارد کنید و سپس پروژه را از لیست نمایش داده شده انتخاب کنید.
- روی باز کردن پروژه کلیک کنید.
- در صورت درخواست، شرایط Firebase را مرور و قبول کنید، سپس روی ادامه کلیک کنید.
- (اختیاری) دستیار هوش مصنوعی را در کنسول Firebase (به نام "Gemini in Firebase") فعال کنید، که می‌تواند به شما در شروع کار و ساده‌سازی فرآیند توسعه کمک کند.
(اختیاری) Google Analytics برای پروژه خود تنظیم کنید، که امکان تجربه بهینه با استفاده از این محصولات فایربیس را فراهم می‌کند: Firebase A/B Testing ، Cloud Messaging ، Crashlytics ، In-App Messaging و Remote Config (شامل شخصی‌سازی ).
یا یک حساب Google Analytics موجود را انتخاب کنید یا یک حساب جدید ایجاد کنید. اگر یک حساب جدید ایجاد می‌کنید، محل گزارش‌دهی Analytics خود را انتخاب کنید، سپس تنظیمات اشتراک‌گذاری داده‌ها و شرایط Google Analytics را برای پروژه خود بپذیرید.
- روی افزودن فایربیس کلیک کنید.
فایربیس، فایربیس را به پروژه موجود شما اضافه می‌کند . پس از اتمام فرآیند، به صفحه نمای کلی پروژه فایربیس خود در کنسول Firebase منتقل خواهید شد.
مرحله ۰ (اختیاری): ایجاد یک مخزن گیت‌هاب و برنامه وب
اگر از قبل یک برنامه وب در مخزن گیت‌هاب ندارید، یا اگر ترجیح می‌دهید این روند را با یک برنامه نمونه امتحان کنید، با مقداردهی اولیه یکی از نمونه‌های ما، برای Next.js یا Angular، شروع کنید:
npm init @apphosting
می‌توانید برنامه نمونه را به صورت محلی با استفاده از next dev یا ng start اجرا کنید. برای ادامه، یک مخزن GitHub جدید ایجاد کنید و کد نمونه تازه مقداردهی شده را به آن ارسال کنید.
مرحله ۱: ایجاد یک بک‌اند App Hosting برنامه
بک‌اند App Hosting ، مجموعه‌ای از منابع مدیریت‌شده است که App Hosting برای ساخت و اجرای اپلیکیشن وب شما ایجاد می‌کند.
کنسول فایربیس : از منوی ساخت ، گزینه میزبانی برنامه و سپس شروع به کار را انتخاب کنید.
رابط خط فرمان (CLI): (نسخه ۱۳.۱۵.۴ یا بالاتر) برای ایجاد یک backend، دستور زیر را از ریشه دایرکتوری پروژه محلی خود اجرا کنید و projectID خود را به عنوان آرگومان وارد کنید:
firebase apphosting:backends:create --project PROJECT_ID
برای هر دو کنسول یا CLI، دستورالعمل‌ها را دنبال کنید تا یک منطقه را انتخاب کنید، یک اتصال GitHub برقرار کنید و این تنظیمات اولیه استقرار را پیکربندی کنید:
دایرکتوری ریشه برنامه خود را تنظیم کنید (پیش‌فرض روی
/)این معمولاً جایی است که فایل
package.jsonشما قرار دارد.
شاخه زنده را تنظیم کنید
این شاخه‌ای از مخزن گیت‌هاب شماست که به آدرس اینترنتی زنده شما منتقل می‌شود. اغلب، این شاخه‌ای است که شاخه‌های ویژگی یا شاخه‌های توسعه در آن ادغام می‌شوند.
پذیرش یا رد انتشار خودکار
انتشار خودکار به صورت پیش‌فرض فعال است. پس از اتمام ساخت بک‌اند، می‌توانید انتخاب کنید که برنامه شما بلافاصله در App Hosting مستقر شود.
یک نام به backend خود اختصاص دهید.
مرحله ۲: مشاهده برنامه اجرا شده
وقتی یک backend ایجاد می‌کنید، Firebase یک زیردامنه رایگان به شما می‌دهد که کاربران نهایی می‌توانند از طریق آن از برنامه وب شما بازدید کنند. فرمت آن backend-id -- project-id .us-central1.hosted.app است.
برای مشاهده آدرس اینترنتی برنامه وب خود، کنسول Firebase را بررسی کنید یا دستور CLI زیر را اجرا کنید:
firebase apphosting:backends:get --project PROJECT_ID {BACKEND_ID}
مرحله ۳: با اعمال یک تغییر، یک انتشار را آغاز کنید
زمانی که backend شما ایجاد شد و یک URL زنده داشتید، می‌توانید هر زمان که تغییرات را به شاخه زنده مخزن GitHub خود ارسال کردید، نسخه جدیدی از برنامه وب خود را راه‌اندازی کنید. برای انجام آزمایش تنظیمات App Hosting خود:
- در گیت‌هاب، یک تغییر را به شاخه‌ی زنده‌ی برنامه‌ی وب ارسال کنید.
- تب App Hosting را در کنسول Firebase باز کنید و View dashboard را برای backend خود انتخاب کنید. لیست جدول، commit خاص مرتبط با rollout ایجاد شده توسط تغییر شما را نمایش می‌دهد.
مراحل بعدی
- عمیق‌تر بروید: یک آزمایشگاه کد Firebase را بررسی کنید که یک برنامه میزبانی شده را با ویژگی‌های احراز هویت Firebase و هوش مصنوعی گوگل ادغام می‌کند: Next.js | Angular
- یک دامنه سفارشی متصل کنید .
- پیکربندی بخش مدیریت خود - تنظیم متغیرهای محیطی، ذخیره پارامترهای مخفی و موارد دیگر.
- نظارت بر انتشار به‌روزرسانی‌ها، میزان استفاده از سایت و گزارش‌ها .