ติดตั้งส่วนขยาย Firebase

คุณสามารถติดตั้ง (และจัดการ) บัญชีใดก็ได้ ของส่วนขยายอย่างเป็นทางการของ Firebase โดยใช้คอนโซล Firebase หรือ Firebase CLI (อินเทอร์เฟซบรรทัดคำสั่ง)

อย่าลืมอ่าน ความแตกต่างใน การดำเนินการที่รองรับสำหรับ Firebase CLI และคอนโซล Firebase


หากต้องการติดตั้งหรือจัดการส่วนขยาย คุณจะต้องได้รับมอบหมายบทบาทใดบทบาทหนึ่งต่อไปนี้ เจ้าของหรือผู้แก้ไข หรือ ผู้ดูแลระบบ Firebase

หากต้องการติดตั้งส่วนขยาย โปรเจ็กต์ต้องอยู่ใน Blaze (จ่ายเป็นคุณ) (Go) แม้ว่าจะไม่มีค่าใช้จ่ายในการติดตั้งส่วนขยาย แต่คุณก็อาจ เรียกเก็บเงินสำหรับการใช้บริการ Firebase หรือบริการระบบคลาวด์ เช่น Cloud Secret Manager หากการใช้งานของคุณเกินขอบเขตบริการ ฟรี

ก่อนเริ่มต้น

  1. เพิ่ม Firebase ในโปรเจ็กต์ หากยังไม่ได้ทำ

  2. อัปเกรดโปรเจ็กต์เป็น Blaze หากยังไม่ได้ดำเนินการ (จ่ายเมื่อใช้ (Go)

  3. ติดตั้งหรืออัปเดตโปรแกรม Firebase CLI

  4. จดรหัสโปรเจ็กต์ Firebase หรือที่กำหนดค่าไว้ก่อนหน้านี้ ชื่อแทนโปรเจ็กต์

ขั้นตอนที่ 1: ดูข้อมูลโดยละเอียดเกี่ยวกับส่วนขยาย

ขั้นตอนนี้เป็นขั้นตอนที่ไม่บังคับ แต่ขอแนะนำอย่างยิ่ง

ก่อนติดตั้งส่วนขยาย Firebase เราขอแนะนำให้คุณ ตรวจสอบข้อมูลโดยละเอียดเกี่ยวกับส่วนขยาย ได้แก่

  • วิธีการทำงานของส่วนขยาย งานเกี่ยวกับการติดตั้งล่วงหน้า และรายละเอียดเกี่ยวกับ ส่วนขยาย
  • ข้อมูลที่ใช้ระบุโดยทั่วไปและรายละเอียด
  • งานของส่วนขยายจำเป็นต้องมีบัญชีสำหรับการเรียกเก็บเงินหรือไม่
  • บริการของ Google (API) และ บทบาทการเข้าถึงที่จำเป็นสำหรับ การดำเนินการ
  • สร้างทรัพยากรแล้ว สำหรับส่วนขยาย (เช่น ฟังก์ชัน)
  • คำอธิบายของพารามิเตอร์ที่ผู้ใช้กำหนดค่าได้

วิธีดูข้อมูลโดยละเอียดของส่วนขยาย

  1. โปรดตรวจสอบว่าคุณได้ ตั้งค่า สภาพแวดล้อม และ เลือก ส่วนขยาย

  2. เรียกใช้คำสั่ง extensions-info ได้จากทุกที่ในคอมพิวเตอร์ โดยทำดังนี้

    firebase ext:info publisher-id/extension-id

    publisher-id และ extension-id ต้องมีอาร์กิวเมนต์ซึ่งพบได้ใน หน้ารายละเอียดการติดตั้งส่วนขยายล่วงหน้า

ขั้นตอนที่ 2: ติดตั้งส่วนขยาย

ในระหว่างขั้นตอนการติดตั้ง คุณจะได้รับแจ้งให้ตรวจสอบ ข้อกำหนดสำหรับส่วนขยาย (เช่น เปิดใช้ API) สร้าง resources แล้ว ได้รับสิทธิ์เข้าถึง ฯลฯ) คุณจะได้รับแจ้งเกี่ยวกับข้อกำหนดในการเรียกเก็บเงิน และคุณจะได้รับแจ้งให้ ระบุค่าสำหรับพารามิเตอร์ที่กำหนดค่าได้ของส่วนขยาย

  1. โปรดตรวจสอบว่าคุณได้ ตั้งค่า สภาพแวดล้อมและ เลือก ส่วนขยาย

  2. เรียกใช้คำสั่งติดตั้งส่วนขยายจากไดเรกทอรี Firebase ในเครื่อง หากได้รับข้อความแจ้ง ให้ป้อนค่าพารามิเตอร์เพื่อปรับแต่งอินสแตนซ์ของส่วนขยาย

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    publisher-id และ extension-id ต้องมีอาร์กิวเมนต์ซึ่งพบได้ใน หน้ารายละเอียดการติดตั้งส่วนขยายล่วงหน้า

    การเรียกใช้คำสั่งนี้จะเพิ่มอินสแตนซ์ส่วนขยายไปยัง ไฟล์ Manifest ของส่วนขยาย

  3. จากนั้นทำให้ส่วนขยายในไฟล์ Manifest ใช้งานได้ใน Firebase ให้เรียกใช้: 

    firebase deploy --only extensions --project=projectId-or-alias

ขั้นตอนที่ 3: ตั้งค่าหลังการติดตั้งให้เสร็จสมบูรณ์

ส่วนขยายบางรายการมีขั้นตอนที่ต้องทำหรือไม่บังคับให้คุณดำเนินการก่อนใช้งาน ให้พวกเขา ค้นหาคำแนะนำเหล่านี้ในหน้ารายละเอียดหลังการติดตั้งของส่วนขยายใน หน้าแดชบอร์ดส่วนขยายของคอนโซล Firebase (ลิงก์เฉพาะที่ แดชบอร์ดจะแสดงที่เทอร์มินัลหลังการติดตั้ง)

นอกจากนี้ คุณยังดูวิธีการเหล่านี้ได้ในไฟล์ POSTINSTALL.md ที่รวมอยู่ใน ไดเรกทอรีแหล่งที่มาของส่วนขยาย

สร้างทรัพยากร Firebase

หากคุณกำหนดค่าส่วนขยายให้ใช้ทรัพยากร Firebase (Cloud Firestore คอลเล็กชัน, เส้นทางฐานข้อมูลเรียลไทม์, ที่เก็บข้อมูล Cloud Storage) ที่ยังไม่มีอยู่ ให้สร้างขึ้นก่อนที่จะใช้ส่วนขยาย

สร้างเครื่องจัดการเหตุการณ์ Eventarc

ส่วนขยายบางรายการเผยแพร่ไปยัง Eventarc เมื่อเหตุการณ์สำคัญเกิดขึ้นในระหว่างการดำเนินการ หากส่วนขยายเผยแพร่เหตุการณ์ และคุณเปิดใช้งานเหตุการณ์ในระหว่างการติดตั้ง คุณก็สามารถเขียนฟังก์ชันที่ตอบสนอง เหตุการณ์เหล่านี้ด้วยตรรกะที่คุณกำหนดเอง ซึ่งจะเป็นประโยชน์ เช่น แจ้งให้ผู้ใช้ทราบเมื่องานที่ใช้เวลานานเสร็จสิ้น หรือเพื่อประมวลผลเอาต์พุตของ ฟังก์ชันส่วนขยาย

ดูรายการเหตุการณ์ที่เผยแพร่ (หากมี) ได้ในเอกสารประกอบของส่วนขยาย ตัวอย่างเช่น โปรดดู ประเภทเหตุการณ์ของส่วนขยาย Run Payments with Stripe

จากนั้นดูที่ทริกเกอร์เหตุการณ์ที่กำหนดเองสำหรับ ข้อมูลเกี่ยวกับการเขียนเครื่องจัดการเหตุการณ์ Eventarc

ติดตั้งอินสแตนซ์ส่วนขยายหลายรายการ

คุณติดตั้งส่วนขยายเดียวกันได้มากกว่า 1 ครั้งในโปรเจ็กต์เดียวกัน อินสแตนซ์ที่ติดตั้งแต่ละรายการสามารถมีการกำหนดค่าที่กำหนดเองและ ทรัพยากรของส่วนขยายได้ คุณสามารถระบุและอ้างอิงถึงอินสแตนซ์ที่ติดตั้งแต่ละรายการโดยใช้ รหัสอินสแตนซ์ ซึ่งจะไม่ซ้ำกันภายในโปรเจ็กต์ของคุณ คุณจะ ขอให้ยืนยันหรือแก้ไขรหัสอินสแตนซ์ของอินสแตนซ์เพิ่มเติมแต่ละรายการ ส่วนขยายที่คุณติดตั้ง

ขั้นตอนถัดไป

  • ดูรายละเอียดและ การกำหนดค่า ของส่วนขยายที่ติดตั้งในคอนโซล Firebase

  • ตรวจสอบกิจกรรม ของส่วนขยายที่ติดตั้ง รวมถึงการตรวจสอบประสิทธิภาพการทำงาน การใช้งาน และบันทึกของส่วนขยายนั้น

  • การใช้ Firebase CLI จัดการ ติดตั้งส่วนขยายแล้ว คุณสามารถกำหนดค่าหรือถอนการติดตั้งส่วนขยายอีกครั้งได้เช่นกัน อัปเดตส่วนขยายเป็นเวอร์ชันล่าสุด

  • การใช้คอนโซล Firebase จัดการ ติดตั้งส่วนขยายแล้ว สำหรับส่วนขยาย Firebase อย่างเป็นทางการ คุณสามารถกำหนดค่าใหม่ หรือถอนการติดตั้งส่วนขยาย รวมทั้งอัปเดตส่วนขยายเป็นเวอร์ชันล่าสุด เวอร์ชัน

  • แนวทางปฏิบัติแนะนำสำหรับทุกโปรเจ็กต์คือ การแจ้งเตือนงบประมาณ สำหรับโปรเจ็กต์และตรวจสอบการใช้งานและการเรียกเก็บเงิน แดชบอร์ด ในคอนโซล Firebase