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

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

คอนโซล Firebase Firebase CLI SDK ที่สร้างขึ้นโดยอัตโนมัติ

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

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

เรียกใช้คําสั่ง 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

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

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

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

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 คุณควรดูบันทึกของฟังก์ชันที่ทำงานอยู่ในโปรเจ็กต์

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

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

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

หมายเหตุ: หากคุณติดตั้งส่วนขยายโดยใช้ SDK ที่สร้างขึ้นโดยอัตโนมัติ ให้ใช้วิธีการเดียวกันในการอัปเกรด แทนที่จะใช้คอนโซลหรือ CLI

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

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

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

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

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

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

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

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

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

หมายเหตุ: หากคุณติดตั้งส่วนขยายโดยใช้ SDK ที่สร้างขึ้นโดยอัตโนมัติ ให้ใช้วิธีเดียวกันในการกำหนดค่าใหม่ แทนที่จะใช้คอนโซลหรือ CLI

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

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

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

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

หมายเหตุ: ระบบอาจใช้เวลา 3-5 นาทีในการบันทึกการเปลี่ยนแปลงสำหรับส่วนขยาย

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

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

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

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

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

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

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

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

หมายเหตุ: หากคุณติดตั้งส่วนขยายโดยใช้ SDK ที่สร้างขึ้นโดยอัตโนมัติ อย่าลืมนำการกำหนดค่าอินสแตนซ์ออกจากโค้ด Cloud Functions ด้วย