จัดการ 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. เปิดหน้ารายละเอียดของอินสแตนซ์ส่วนขยายในส่วนFirebaseคอนโซล ส่วนขยาย

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

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

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

  1. เปิดหน้าเครื่องมือจัดการข้อมูลลับของโปรเจ็กต์ในคอนโซล 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. คลิกอัปเดตส่วนขยาย

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

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

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

  2. คลิกกำหนดค่าส่วนขยายใหม่ที่มุมขวาบน

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

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

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

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

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

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

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

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

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

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