Firebase App Hosting เหมาะอย่างยิ่งสำหรับเว็บแอปแบบไดนามิกที่สร้างด้วย Firebase JavaScript SDK และ Firebase Admin SDK สำหรับ Node.js ในเว็บแอปที่มีฟีเจอร์ครบครัน SDK ของ Firebase เช่น Authentication, Cloud Firestore และ App Check มีบทบาทสำคัญอย่างยิ่ง คู่มือนี้อธิบายกลยุทธ์สำคัญบางอย่างที่จะช่วยเพิ่มประสิทธิภาพ SDK ของ Firebase และเริ่มต้นสร้าง Firebase ลงในเว็บแอปบน Firebase App Hosting
เริ่มต้น Firebase Admin SDK และ SDK บนเว็บโดยอัตโนมัติ
สภาพแวดล้อมของ Google เช่น Firebase App Hosting มีการเริ่มต้นแอปที่เรียบง่ายผ่านการเรียกใช้คอนสตรัคเตอร์แบบไม่มีอาร์กิวเมนต์ในเวลาบิลด์และรันไทม์ ซึ่งเป็นฟีเจอร์ของทั้ง Firebase Admin SDK สำหรับ Node.js ซึ่งเป็น SDK ฝั่งเซิร์ฟเวอร์ที่ปลดล็อกฟังก์ชันการทำงานของ Firebase จำนวนมากและมีประโยชน์อย่างยิ่งในเว็บแอป และ Firebase JavaScript SDK
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
JavaScript SDK
import { initializeApp } from 'firebase/app';
const app = initializeApp();
สำหรับ JavaScript SDK กลยุทธ์การเริ่มต้นนี้จะทำงานใน App Hosting
ลบล้างค่าที่สร้างขึ้นโดยอัตโนมัติ
คุณลบล้างการกำหนดค่าเริ่มต้นที่แทรกโดยอัตโนมัติได้ โปรดทราบว่าตัวเลือกเหล่านี้จะแตกต่างกันระหว่าง Admin SDK และ JavaScript SDK
การลบล้าง Admin SDK รายการ
หากต้องการระบุตัวเลือกการเริ่มต้นที่กำหนดเองสำหรับบริการต่างๆ เช่น Realtime Database, Cloud Storage หรือ Cloud Functions ให้ใช้ตัวแปรสภาพแวดล้อม FIREBASE_CONFIG หากเนื้อหาของตัวแปร FIREBASE_CONFIG ขึ้นต้นด้วยอักขระ { ระบบจะแยกวิเคราะห์เป็นออบเจ็กต์ JSON มิฉะนั้น SDK จะถือว่าสตริงเป็นเส้นทางของไฟล์ JSON ที่มีตัวเลือก
# apphosting.yaml
env:
- variable: FIREBASE_CONFIG
value: '{"databaseURL":"https://project-id-default-rtdb.firebaseio.com","projectId":"my-project-id"}'
การลบล้าง JavaScript SDK
หากต้องการลบล้างค่า FIREBASE_WEBAPP_CONFIG เริ่มต้นที่ App Hosting แทรกสำหรับการเริ่มต้น JavaScript SDK คุณสามารถระบุค่าใน 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"}'
การใช้การเริ่มต้นอัตโนมัติในสภาพแวดล้อมอื่นๆ
ระบบจะตั้งค่าการเริ่มต้นอัตโนมัติด้วยสคริปต์ postinstall
npm เมื่อคุณติดตั้ง Firebase JavaScript SDK สคริปต์ postinstall จะมองหาตัวแปรสภาพแวดล้อม FIREBASE_WEBAPP_CONFIG ซึ่งตั้งค่าโดยอัตโนมัติในสภาพแวดล้อมของบิลด์ App Hosting Cloud Build
หากติดตั้ง JS SDK นอก Cloud Build คุณจะต้องตั้งค่าตัวแปรสภาพแวดล้อมนี้ด้วยตนเองเมื่อติดตั้ง Firebase JavaScript SDK
วิธีตั้งค่าสภาพแวดล้อมด้วยตนเองเมื่อติดตั้ง
คัดลอกออบเจ็กต์การกำหนดค่าเว็บแอป Firebase จากคอนโซล Firebase
จากเทอร์มินัล ให้ตั้งค่าตัวแปรสภาพแวดล้อม
FIREBASE_WEBAPP_CONFIGก่อนเรียกใช้คำสั่งnpm install
FIREBASE_WEBAPP_CONFIG="{...}" npm install firebase
เรียกใช้คำสั่งนี้อีกครั้งทุกครั้งที่คุณเปลี่ยนโปรเจ็กต์ Firebase หรือเว็บแอป นอกจากนี้ คุณอาจต้องล้างแคชระดับกลาง (เช่น .next/cache) ด้วย
ใช้ FirebaseServerApp สำหรับ SSR
หากคุณเคยใช้ Firebase JS SDK หรือ Firebase Client SDK อื่นๆ ในการพัฒนาเว็บแอป คุณอาจคุ้นเคยกับอินเทอร์เฟซ 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 จากการละเมิดได้