Firebase App Hosting برای برنامههای وب پویایی که با Firebase JavaScript SDK و Firebase Admin SDK برای Node.js ساخته شدهاند، مناسب است. در یک برنامه وب با ویژگیهای کامل، کیتهای توسعه نرمافزار Firebase مانند Authentication، Cloud Firestore، و App Check نقشهای مهمی ایفا میکنند. این راهنما برخیاز استراتژیهای کلیدی را برای کمک به بهینهسازی کیتهای توسعه نرمافزار Firebase و شروع ساختن Firebase در برنامه وب شما در Firebase App Hosting شرح میدهد.
مقداردهی اولیه خودکار Firebase Admin SDK و کیتهای توسعه نرمافزار وب
محیطهای Google مانند Firebase App Hosting مقداردهی اولیه برنامه را ازطریق فراخوانی سازنده بدون آرگومان در زمان ساخت و زمان اجرا ساده میکنند. این ویژگی هم در Firebase Admin SDK برای Node.js (کیت توسعه نرمافزار سمت سرور که بخش بزرگی از عملکرد Firebase را باز میکند و میتواند در برنامه وب شما بسیار مفید باشد) و هم در کیت توسعه نرمافزار Firebase JavaScript وجود دارد.
با initializeApp()، میتوانید به Firebase App Hosting اجازه دهید بهطور خودکار پیکربندی برنامه وب را برای شما پر کند، درحالیکه همچنان گزینه کنترل دقیق بر مقادیر خاص را درصورت تمایل به لغو مقادیر پیشفرض حفظ میکنید.
مقداردهی اولیه بدون متغیرهای مستقل
برای مقداردهی اولیه کیت توسعه نرمافزار (SDK) Firebase Admin SDK یا Firebase JavaScript با مقادیر پیکربندی پیشفرض، از initializeApp() بدون ارائه هیچ آرگومانی استفاده کنید.
Admin SDK
import { initializeApp } from 'firebase-admin/app';
const app = initializeApp();
برای Admin SDK، این راهبرد مقداردهی اولیه در App Hosting و همچنین دیگر محیطهای سرور Google ازجمله Cloud Run، App Engine، و توابع Cloud Run کار میکند.
کیت توسعه نرمافزار جاوا اسکریپت
import { initializeApp } from 'firebase/app';
const app = initializeApp();
برای کیت توسعه نرمافزار جاوا اسکریپت، این راهبرد مقداردهی اولیه در App Hosting کار میکند.
لغو مقادیر تکمیلشده خودکار
میتوانید پیکربندی پیشفرضی را که بهطور خودکار تزریق میشود لغو کنید. توجه داشته باشید که این گزینهها بین Admin SDK و کیت توسعه نرمافزار جاوا اسکریپت متفاوت است.
لغو کردن Admin SDK
برای مشخص کردن اختیاری گزینههای مقداردهی اولیه سفارشی برای سرویسهایی مانند
Realtime Database، Cloud Storage، یا Cloud Functions، از متغیر محیطی FIREBASE_CONFIG
استفاده کنید. اگر محتوای متغیر FIREBASE_CONFIG با نویسه { شروع شود،
بهعنوان شیء JSON تجزیه خواهد شد. درغیراینصورت، کیت توسعه نرمافزار
فرض میکند که رشته مسیر فایل JSON حاوی گزینهها است.
# apphosting.yaml
env:
- variable: FIREBASE_CONFIG
value: '{"databaseURL":"https://project-id-default-rtdb.firebaseio.com","projectId":"my-project-id"}'
لغو کیت توسعه نرمافزار جاوا اسکریپت
برای لغو مقادیر پیشفرض FIREBASE_WEBAPP_CONFIG که App Hosting برای مقداردهی اولیه کیت توسعه نرمافزار جاوا اسکریپت تزریق میکند، میتوانید مقادیر را در apphosting.yaml مشخص کنید:
# apphosting.yaml
env:
- variable: FIREBASE_WEBAPP_CONFIG
value: '{"apiKey":"myApiKey","appId":"app:123","authDomain":"project-id.firebaseapp.com","databaseURL":"https://project-id-default-rtdb.firebaseio.com","messagingSenderId":"0123456789","projectId":"project-id","storageBucket":"project-id.firebasestorage.app"}'
استفاده از مقداردهی اولیه خودکار در محیطهای دیگر
مقداردهی اولیه خودکار با یک اسکریپت npmpostinstall
هنگام نصب کیت توسعه نرمافزار جاوا اسکریپت در Firebase راهاندازی میشود. متن postinstall بهدنبال متغیر محیطی FIREBASE_WEBAPP_CONFIG میگردد که بهطور خودکار در محیط Cloud Build App Hosting تنظیم شده است.
اگر کیت توسعه نرمافزار JS را خارج از Cloud Build نصب میکنید، باید این متغیر محیطی را خودتان هنگام نصب کیت توسعه نرمافزار جاوا اسکریپت Firebase تنظیم کنید.
برای راهاندازی دستی محیط در زمان نصب:
شیء پیکربندی برنامه وب Firebase خود را از کنسول Firebase کپی کنید.
از پایانه، متغیر محیطی
FIREBASE_WEBAPP_CONFIGرا قبلاز اجرای فرمانnpm installتنظیم کنید.
FIREBASE_WEBAPP_CONFIG="{...}" npm install firebase
هرزمان پروژه Firebase یا برنامه وب خود را تغییر دادید، این فرمان را دوباره اجرا کنید. حافظههای نهان واسطه
(مثل .next/cache) نیز ممکن است نیاز به پاک شدن داشته باشند.
استفاده از FirebaseServerApp برای SSR
اگر در توسعه برنامه وب خود با کیت توسعه نرمافزار Firebase JS یا سایر کیتهای توسعه نرمافزار مشتری Firebase کار کردهاید، احتمالاً با رابط FirebaseApp و نحوه استفاده از آن برای پیکربندی نمونههای برنامه آشنا هستید. برای تسهیل عملیات مشابه در سمت سرور، Firebase FirebaseServerApp را ارائه میدهد.
FirebaseServerApp گونهای از FirebaseApp برای استفاده در محیطهای
پرداخت سمت سرور (SSR) است. این چارچوب شامل ابزارهایی برای ادامه دادن جلسههای Firebase است
که تقسیمبندی پردازش سمت کارخواه (CSR) / پردازش سمت سرور را دربرمیگیرد.
از FirebaseServerApp برای این کارها استفاده کنید:
- کد سمت سرور را در بافت کاربر اجرا میکند، برخلاف Firebase Admin SDK که حقوق کامل مدیریت دارد.
- استفاده از App Check را در محیطهای SSR فعال کنید.
- ادامه دادن جلسه Firebase Auth که در کارخواه ایجاد شده است.
برای جزئیات کامل درباره استفاده از FirebaseServerApp برای این اهداف، به استفاده از Firebase در برنامههای وب پویا با SSR مراجعه کنید.
فعال کردن App Check در برنامه وب
میتوانید از App Check برای تقویت امنیت برنامه وب پویایتان در App Hosting استفاده کنید. با پیادهسازی برخیاز استراتژیهای خاص سمت سرور که در استفاده از Firebase در برنامههای وب پویا با SSR شرح داده شده است، میتوانید از App Hosting زیرینههایتان دربرابر سوءاستفاده محافظت کنید.