Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

จัดการ Firebase Extensions ที่ติดตั้ง

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

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

แสดงรายการอินสแตนซ์ส่วนขยายที่ติดตั้งของโครงการ

คุณสามารถแสดงรายการทุกอินสแตนซ์ของส่วนขยายที่คุณติดตั้ง

เรียกใช้คำสั่งรายการส่วนขยาย:

firebase ext:list --project=projectId-or-alias

ตรวจสอบอินสแตนซ์ส่วนขยายที่ติดตั้ง

ในคอนโซล Firebase คุณสามารถตรวจสอบกิจกรรมของส่วนขยายที่ติดตั้ง รวมถึงตรวจสอบสถานภาพ การใช้งาน และบันทึก

ตั้งค่าการแจ้งเตือนงบประมาณ

การตั้งค่าการแจ้งเตือนงบประมาณเป็นแนวทางปฏิบัติที่ดีโดยทั่วไป แต่การแจ้งเตือนอาจมีความสำคัญเป็นพิเศษเมื่อคุณไว้วางใจให้โค้ดของบุคคลอื่นทำงานในโปรเจ็กต์ของคุณ

อย่าลืมตั้งค่า การแจ้งเตือนงบประมาณ สำหรับโครงการ Firebase

ดูฟังก์ชันที่สร้างโดยส่วนขยาย

  1. ไปที่ แดชบอร์ดฟังก์ชัน ของคอนโซล Firebase

  2. ในแท็บ แดชบอร์ด คุณสามารถดูฟังก์ชันต่างๆ จาก Firebase Extensions (ควบคู่ไปกับฟังก์ชันอื่นๆ ที่คุณได้ปรับใช้สำหรับโครงการของคุณ)

    ฟังก์ชันที่สร้างโดยส่วนขยายมีชื่อในรูปแบบ: ext- extension-instance-id - functionName

    ตัวอย่างเช่น ext-awesome-task-simplifier-onUserCreate

ดูงาน Cloud Scheduler ที่สร้างโดยส่วนขยาย

  1. เปิดหน้า Cloud Scheduler ของโปรเจ็กต์ใน Google Cloud Console

  2. ในรายการงาน คุณสามารถดูงาน Cloud Scheduler จาก Firebase Extensions (ควบคู่ไปกับงานอื่นๆ ที่คุณสร้างสำหรับโครงการของคุณ)

    งานที่สร้างโดยส่วนขยายมีชื่อในรูปแบบ: firebase-ext- extension-instance-id - functionName

    ตัวอย่างเช่น: firebase-ext-awesome-task-simplifier-doTask

ดูและจัดการ Cloud Tasks ที่อยู่ในคิวตามส่วนขยาย

ส่วนขยายบางตัวใช้ Cloud Tasks เพื่อเรียกใช้งานที่ใช้เวลานานขึ้น: โดยทั่วไปแล้ว การประมวลผลงานที่ทำงานที่จุดต่างๆ ในวงจรชีวิตของส่วนขยาย เช่น การติดตั้ง การกำหนดค่าใหม่ และหลังการอัปเกรด

โดยปกติแล้ว งานเหล่านี้จะดำเนินการและเสร็จสิ้นโดยอัตโนมัติ โดยที่คุณไม่ต้องดำเนินการใดๆ อย่างไรก็ตาม หากคุณจำเป็นต้องจัดการงานที่อยู่ในคิวของส่วนขยายด้วยตนเอง เช่น ต้องการหยุดคิวชั่วคราวหรือนำงานที่ยังไม่เริ่มออกจากคิว ให้ทำตามขั้นตอนเหล่านี้:

  1. ในส่วนส่วน ขยายของ คอนโซล Firebase ให้เปิดหน้ารายละเอียดของอินสแตนซ์ส่วนขยาย

  2. ในหน้ารายละเอียด ให้เปิดส่วน API และทรัพยากร หากส่วนขยายใช้ Cloud Tasks จะมีส่วน คิวของ Cloud Task ที่มีหนึ่งรายการขึ้นไป

  3. คลิก ดูคิว สำหรับคิวที่คุณต้องการจัดการ การดำเนินการนี้จะเปิดหน้ารายละเอียดคิวใน Google Cloud Console ซึ่งคุณสามารถดูงานที่จัดคิว หยุดคิวชั่วคราว ลบงานออกจากคิว และอื่นๆ ดู จัดการคิวและงาน ในเอกสารประกอบของ Cloud Tasks

ดูความลับของ Cloud Secret Manager ที่สร้างโดยส่วนขยาย

  1. เปิดหน้า Secret Manager ของโปรเจ็กต์ใน Google Cloud Console

  2. ในรายการความลับ คุณสามารถดูความลับที่สร้างขึ้นสำหรับ Firebase Extensions (ควบคู่ไปกับความลับอื่นๆ ที่คุณสร้างสำหรับโครงการของคุณ)

    ข้อมูลลับที่สร้างโดยส่วนขยายมีชื่อในรูปแบบ: ext- extension-instance-id - paramnName

    ตัวอย่างเช่น ext-awesome-task-simplifier-API_KEY

    ข้อมูลลับจะถูกกำกับด้วยคีย์ firebase-extensions-managed อย่านำป้ายกำกับนี้ออกเว้นแต่คุณต้องการหยุด Firebase ไม่ให้จัดการข้อมูลลับ

ตรวจสอบว่าส่วนขยายที่ติดตั้งนั้นสมบูรณ์หรือไม่

คุณสามารถตรวจสอบข้อผิดพลาดทั้งหมดจากฟังก์ชัน (รวมถึงข้อผิดพลาดที่สร้างโดย Firebase Extensions) ในคอนโซล

  1. ใน แท็ บความสมบูรณ์ของ แดชบอร์ดฟังก์ชัน คุณสามารถดูภาพรวมของข้อผิดพลาดและข้อมูลประสิทธิภาพสำหรับฟังก์ชันทั้งหมดในโครงการของคุณได้

  2. หากต้องการดูข้อมูลสำหรับส่วนขยายเฉพาะ ให้ใช้ตัวกรองที่ด้านบนของหน้าเพื่อเลือกฟังก์ชันเฉพาะ

ตรวจสอบว่าส่วนขยายที่ติดตั้งทำงานอยู่ทำงานบ่อยเพียงใด

  1. ในแท็บ แดชบอร์ด ของ แดชบอร์ดฟังก์ชัน ให้ค้นหาฟังก์ชันเฉพาะสำหรับส่วนขยาย Firebase ที่คุณต้องการตรวจสอบ

  2. คลิก (เมนูเพิ่มเติม) ที่ด้านขวาสุดของรายการ แล้วเลือก สถิติการใช้งานโดยละเอียด

  3. ใน Google Cloud Console ที่แสดง คุณสามารถเจาะลึกถึงการเรียกใช้ฟังก์ชันต่างๆ และตรวจสอบซอร์สโค้ดได้

ดูบันทึกสำหรับส่วนขยาย

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

ในแท็บ บันทึก ของ แดชบอร์ดฟังก์ชัน ให้ใช้ตัวกรองที่ด้านบนของหน้าเพื่อเลือกฟังก์ชันที่สร้างโดยส่วนขยายของคุณ

อัปเดตอินสแตนซ์ส่วนขยายที่ติดตั้งเป็นเวอร์ชันล่าสุด

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

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

ในระหว่างกระบวนการอัปเดต คุณจะได้รับแจ้งเกี่ยวกับการเปลี่ยนแปลงใดๆ สำหรับเวอร์ชันใหม่ และคุณจะสามารถระบุค่าสำหรับพารามิเตอร์ใหม่ใดๆ ได้

  1. หากต้องการอัปเดตอินสแตนซ์ส่วนขยายใน รายการส่วนขยาย ของคุณเป็นเวอร์ชันล่าสุด ให้เรียกใช้คำสั่งอัปเดตส่วนขยาย:

    firebase ext:update extensionInstanceId

    หากต้องการอัปเดตเป็นเวอร์ชันเฉพาะ ให้ระบุเวอร์ชันที่คุณต้องการอัปเดตเป็น:

    firebase ext:update extensionInstanceId versionNumber
  2. จากนั้น หากต้องการปรับใช้ส่วนขยายในไฟล์ Manifest ของคุณกับโปรเจ็กต์ Firebase ให้เรียกใช้:

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

กำหนดค่าอินสแตนซ์ส่วนขยายที่ติดตั้งใหม่

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

  1. หากต้องการกำหนดค่าส่วนขยายใหม่แบบโต้ตอบใน ไฟล์ Manifest ส่วนขยาย ของคุณ ให้เรียกใช้คำสั่งกำหนดค่าส่วนขยาย:

    firebase ext:configure extensionInstanceId
  2. จากนั้น หากต้องการปรับใช้ส่วนขยายในรายการของคุณกับโครงการ Firebase ให้เรียกใช้:

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

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

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

  • สิ่งประดิษฐ์ใด ๆ ที่สร้างโดยส่วนขยาย (เช่น รูปภาพที่เก็บไว้)

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

วิธีถอนการติดตั้งส่วนขยายมีดังนี้

  1. หากต้องการลบอินสแตนซ์ส่วนขยายออกจาก รายการส่วนขยาย ของคุณ ให้รันคำสั่งถอนการติดตั้งส่วนขยาย:

    firebase ext:uninstall extensionInstanceId
  2. จากนั้น หากต้องการปรับใช้การเปลี่ยนแปลงกับไฟล์ Manifest ของคุณในโครงการ Firebase ให้เรียกใช้:

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