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

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


แสดงรายการอินสแตนซ์ของส่วนขยายที่ติดตั้งในโปรเจ็กต์

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

เรียกใช้คำสั่ง extensions-list ดังนี้

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

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

  1. ไปที่แดชบอร์ด Firebase Extensions ในคอนโซล Firebase

  2. ในการ์ดของอินสแตนซ์ของส่วนขยายที่ติดตั้ง ให้คลิกจัดการ

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

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

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

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

ตรวจสอบว่าคุณได้ตั้งค่า การแจ้งเตือนงบประมาณ สำหรับโปรเจ็กต์ Firebase แล้ว

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

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

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

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

    เช่น ext-awesome-task-simplifier-onUserCreate

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

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

  2. ในรายการงาน คุณจะดูงาน Cloud Scheduler จาก Firebase Extensions (พร้อมกับงานอื่นๆ ที่คุณสร้างสำหรับ โปรเจ็กต์)

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

    เช่น firebase-ext-awesome-task-simplifier-doTask

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

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

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

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

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

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

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

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

  2. ในรายการข้อมูลลับ คุณจะดูข้อมูลลับที่สร้างขึ้นสำหรับ Firebase Extensions (พร้อมกับข้อมูลลับอื่นๆ ที่คุณสร้างสำหรับ โปรเจ็กต์)

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

    เช่น ext-awesome-task-simplifier-API_KEY

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

ตรวจสอบว่าส่วนขยายที่ติดตั้งทำงานได้ตามปกติหรือไม่

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

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

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

ตรวจสอบความถี่ในการเรียกใช้งานส่วนขยายที่ติดตั้ง

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

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

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

ดูบันทึกของส่วนขยาย

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

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

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

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

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

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

  1. ไปที่แดชบอร์ด Firebase Extensions แล้วคลิก จัดการ ในการ์ดของอินสแตนซ์ของส่วนขยายที่ติดตั้ง

  2. คลิกอัปเดตส่วนขยาย ที่มุมขวาบน

    หากส่วนขยายไม่มีเวอร์ชันใหม่ที่พร้อมใช้งาน หน้า "รายละเอียด" จะไม่มีปุ่มอัปเดต

  3. ตรวจสอบสิ่งที่เพิ่มเข้ามาใหม่ในการอัปเดตและกำหนดค่าส่วนขยาย (หากจำเป็น)

  4. คลิกอัปเดตส่วนขยาย

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

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

  1. ไปที่แดชบอร์ดFirebase Extensions Firebase Extensions แล้วคลิกจัดการ ในการ์ดของอินสแตนซ์ของส่วนขยายที่ติดตั้ง

  2. คลิกกำหนดค่าส่วนขยายอีกครั้ง ที่มุมขวาบน

  3. ทำตามวิธีการบนหน้าจอเพื่อกำหนดค่าค่าพารามิเตอร์สำหรับส่วนขยายอีกครั้ง

  4. คลิกบันทึก

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

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

  • อาร์ติแฟกต์ที่ส่วนขยายสร้างขึ้น (เช่น รูปภาพที่จัดเก็บไว้)

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

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

  1. ไปที่แดชบอร์ดFirebase Extensions Firebase Extensions แล้วคลิกจัดการ ในการ์ดของอินสแตนซ์ของส่วนขยายที่ติดตั้ง

  2. คลิกถอนการติดตั้งส่วนขยาย ที่ด้านล่างของหน้าจอ

  3. ตรวจสอบสิ่งที่ระบบจะลบ แล้วคลิกถอนการติดตั้งส่วนขยาย เพื่อยืนยันการลบ