หากต้องการติดตั้งหรือจัดการส่วนขยาย คุณต้องได้รับมอบหมายบทบาทใดบทบาทหนึ่งต่อไปนี้ เจ้าของหรือผู้แก้ไข หรือ ผู้ดูแลระบบ Firebase
แสดงรายการอินสแตนซ์ส่วนขยายที่ติดตั้งของโปรเจ็กต์
คุณสามารถแสดงรายการส่วนขยายทุกอินสแตนซ์ที่คุณติดตั้งได้
รันคำสั่ง extensions-list:
firebase ext:list --project=projectId-or-alias
ตรวจสอบอินสแตนซ์ส่วนขยายที่ติดตั้ง
ในคอนโซล Firebase คุณสามารถตรวจสอบกิจกรรมของส่วนขยายที่ติดตั้งได้ รวมถึงการตรวจสอบความสมบูรณ์ การใช้งาน และบันทึก
ตั้งค่าการแจ้งเตือนงบประมาณ
โดยทั่วไป การตั้งค่าการแจ้งเตือนงบประมาณเป็นแนวทางปฏิบัติที่ดี แต่การแจ้งเตือนอาจมีความสำคัญเป็นพิเศษเมื่อคุณไว้วางใจให้โค้ดของบุคคลอื่นทำงานในโครงการของคุณ
ตรวจสอบให้แน่ใจว่าคุณได้ตั้งค่า การแจ้งเตือนงบประมาณ สำหรับโปรเจ็กต์ Firebase ของคุณ
ดูฟังก์ชันที่สร้างโดยส่วนขยาย
ไปที่ แดชบอร์ดฟังก์ชั่น ของคอนโซล Firebase
ใน แท็บแดชบอร์ด คุณสามารถดูฟังก์ชันต่างๆ จากส่วนขยาย Firebase (ควบคู่ไปกับฟังก์ชันอื่นๆ ที่คุณได้ปรับใช้สำหรับโปรเจ็กต์ของคุณ)
ฟังก์ชั่นที่สร้างโดยส่วนขยายจะมีชื่อในรูปแบบ:
ext- extension-instance-id - functionName
ตัวอย่างเช่น:
ext-awesome-task-simplifier-onUserCreate
ดูงาน Cloud Scheduler ที่สร้างโดยส่วนขยาย
เปิดหน้า Cloud Scheduler ของโปรเจ็กต์ใน Google Cloud Console
ในรายการงาน คุณสามารถดูงาน Cloud Scheduler ได้จาก Firebase Extensions (ควบคู่ไปกับงานอื่นๆ ที่คุณสร้างขึ้นสำหรับโปรเจ็กต์ของคุณ)
งานที่สร้างโดยส่วนขยายจะมีชื่อในรูปแบบ:
firebase-ext- extension-instance-id - functionName
ตัวอย่างเช่น:
firebase-ext-awesome-task-simplifier-doTask
ดูและจัดการ Cloud Tasks ที่จัดคิวตามส่วนขยาย
ส่วนขยายบางส่วนใช้ งาน Cloud Tasks เพื่อรันงานที่ใช้เวลานาน โดยทั่วไปคือการประมวลผลงานที่ทำงานที่จุดต่างๆ ในวงจรการใช้งานของส่วนขยาย เช่น การติดตั้ง การกำหนดค่าใหม่ และหลังการอัปเกรด
โดยปกติ งานเหล่านี้จะรันและเสร็จสิ้นโดยอัตโนมัติ โดยที่คุณไม่ต้องดำเนินการใดๆ อย่างไรก็ตาม หากคุณต้องการจัดการงานที่อยู่ในคิวของส่วนขยายด้วยตนเอง เช่น หากต้องการหยุดคิวชั่วคราวหรือลบงานที่ยังไม่ได้เริ่มออกจากคิว ให้ทำตามขั้นตอนเหล่านี้
ในส่วนส่วน ขยาย คอนโซล Firebase ให้เปิดหน้ารายละเอียดของอินสแตนซ์ส่วนขยาย
ในหน้ารายละเอียด ให้เปิดส่วน API และทรัพยากร หากส่วนขยายใช้งาน Cloud Tasks จะมีส่วน คิวงานระบบคลาวด์ ที่มีรายการอย่างน้อย 1 รายการ
คลิก ดูคิว สำหรับคิวที่คุณต้องการจัดการ ซึ่งจะเปิดหน้ารายละเอียดคิวใน Google Cloud Console ซึ่งคุณสามารถดูงานที่อยู่ในคิว หยุดคิวชั่วคราว ลบงานออกจากคิว และอื่นๆ ดู จัดการคิวและงาน ในเอกสาร Cloud Tasks
- ติดตั้งอินสแตนซ์ใหม่ของส่วนขยาย
- หลังจากติดตั้งอินสแตนซ์ใหม่แล้วเท่านั้น ให้ถอนการติดตั้งอินสแตนซ์เก่า
ดูข้อมูลลับของ Cloud Secret Manager ที่สร้างโดยส่วนขยาย
เปิดหน้า Secret Manager ของโปรเจ็กต์ของคุณใน Google Cloud Console
ในรายการข้อมูลลับ คุณสามารถดูข้อมูลลับที่สร้างขึ้นสำหรับส่วนขยาย Firebase (นอกเหนือจากข้อมูลลับอื่นๆ ที่คุณสร้างสำหรับโปรเจ็กต์ของคุณ)
ข้อมูลลับที่สร้างโดยส่วนขยายจะมีชื่อในรูปแบบ:
ext- extension-instance-id - paramnName
ตัวอย่างเช่น:
ext-awesome-task-simplifier-API_KEY
ข้อมูลลับจะมีป้ายกำกับว่า
firebase-extensions-managed
ที่สำคัญ อย่านำป้ายกำกับนี้ออก เว้นแต่คุณต้องการหยุด Firebase ไม่ให้จัดการข้อมูลลับ
ตรวจสอบว่าส่วนขยายที่ติดตั้งมีประสิทธิภาพดีหรือไม่
คุณสามารถตรวจสอบข้อผิดพลาดทั้งหมดจากฟังก์ชันต่างๆ (รวมถึงข้อผิดพลาดที่สร้างโดย Firebase Extensions) ได้ในคอนโซล
ในแท็บ สุขภาพ ของ แดชบอร์ดฟังก์ชัน คุณสามารถดูภาพรวมของข้อผิดพลาดและข้อมูลประสิทธิภาพของฟังก์ชันทั้งหมดในโปรเจ็กต์ของคุณได้
หากต้องการดูข้อมูลสำหรับส่วนขยายเฉพาะ ให้ใช้ตัวกรองที่ด้านบนของหน้าเพื่อเลือกฟังก์ชันเฉพาะ
ตรวจสอบว่าส่วนขยายที่ติดตั้งทำงานบ่อยแค่ไหน
ในแท็ บแดชบอร์ด ของ แดชบอร์ดฟังก์ชัน ให้ค้นหาฟังก์ชันเฉพาะสำหรับส่วนขยาย Firebase ที่คุณต้องการตรวจสอบ
คลิก
(เมนูรายการเพิ่มเติม) ที่ด้านขวาสุดของรายการ จากนั้นเลือก สถิติการใช้งานโดยละเอียดใน Google Cloud Console ที่แสดง คุณสามารถเจาะลึกการเรียกใช้ฟังก์ชันต่างๆ และตรวจสอบซอร์สโค้ดของฟังก์ชันได้
ดูบันทึกสำหรับส่วนขยาย
หากคุณกำลังพยายามแก้ไขจุดบกพร่องโปรเจ็กต์ของคุณ หรือส่งรายงานข้อบกพร่องไปยัง Firebase การดูบันทึกของฟังก์ชันที่ทำงานอยู่ในโปรเจ็กต์ของคุณจะมีประโยชน์
ในแท็บ บันทึก ของ แดชบอร์ดฟังก์ชัน ของคุณ ให้ใช้ตัวกรองที่ด้านบนของหน้าเพื่อเลือกฟังก์ชันที่สร้างโดยส่วนขยายของคุณ
อัปเดตอินสแตนซ์ส่วนขยายที่ติดตั้งเป็นเวอร์ชันล่าสุด
คุณสามารถอัปเดตอินสแตนซ์ที่ติดตั้งของส่วนขยายเป็นเวอร์ชันที่ออกล่าสุดได้ คุณอาจต้องการอัปเดตอินสแตนซ์ที่ติดตั้งไว้ เนื่องจากอินสแตนซ์กำลังทำงานหรือตั้งค่าอยู่ในการทดสอบ โปรเจ็กต์ หรือเวิร์กโฟลว์แอปของคุณ
เมื่อคุณอัปเดตอินสแตนซ์ ทรัพยากรและตรรกะเฉพาะส่วนขยายของอินสแตนซ์ทั้งหมดจะถูกเขียนทับเพื่อใช้ซอร์สโค้ดและไฟล์ของเวอร์ชันใหม่ รหัสอินสแตนซ์และบัญชีบริการของส่วนขยายจะไม่เปลี่ยนแปลง
ในระหว่างกระบวนการอัปเดต คุณจะได้รับแจ้งถึงการเปลี่ยนแปลงสำหรับเวอร์ชันใหม่ และคุณจะสามารถระบุค่าสำหรับพารามิเตอร์ใหม่ได้
หากต้องการอัปเดตอินสแตนซ์ส่วนขยายในรายการ ส่วนขยาย ของคุณเป็นเวอร์ชันล่าสุด ให้รันคำสั่งอัปเดตส่วนขยาย:
firebase ext:update extensionInstanceId
หากต้องการอัปเดตเป็นเวอร์ชันเฉพาะ ให้ระบุเวอร์ชันที่คุณต้องการอัปเดตเป็น:
firebase ext:update extensionInstanceId versionNumber
จากนั้น หากต้องการปรับใช้ส่วนขยายในรายการของคุณกับโปรเจ็กต์ Firebase ให้เรียกใช้:
firebase deploy --only extensions --project=projectId-or-alias
กำหนดค่าอินสแตนซ์ส่วนขยายที่ติดตั้งใหม่
คุณสามารถเปลี่ยนค่าของพารามิเตอร์ที่ผู้ใช้กำหนดค่าสำหรับอินสแตนซ์ส่วนขยายที่ติดตั้งได้ ค่าใหม่เหล่านี้จะถูกนำมาใช้ในทริกเกอร์อินสแตนซ์ใดๆ ในอนาคต แต่ส่วนก่อนหน้าหรือองค์ประกอบโครงสร้างทั้งหมดที่สร้างโดยส่วนขยาย (เช่น ภาพที่เก็บไว้หรือที่เก็บข้อมูลที่มีอยู่) จะไม่มีการเปลี่ยนแปลง
หากต้องการกำหนดค่าส่วนขยายใหม่แบบโต้ตอบใน รายการส่วนขยาย ของคุณ ให้เรียกใช้คำสั่งกำหนดค่าส่วนขยาย:
firebase ext:configure extensionInstanceId
จากนั้น หากต้องการปรับใช้ส่วนขยายในรายการของคุณกับโปรเจ็กต์ Firebase ให้เรียกใช้:
firebase deploy --only extensions --project=projectId-or-alias
ถอนการติดตั้งอินสแตนซ์ส่วนขยาย
คุณสามารถถอนการติดตั้งอินสแตนซ์ของส่วนขยายจากโปรเจ็กต์ Firebase ของคุณได้ การดำเนินการนี้จะลบ บัญชีบริการ และ ทรัพยากร ทั้งหมด (เช่น ชุดฟังก์ชัน) ที่ Firebase สร้างขึ้นสำหรับอินสแตนซ์ของส่วนขยายนั้นโดยเฉพาะ อย่างไรก็ตาม สิ่งต่อไปนี้จะ ไม่ ถูกลบ:
สิ่งประดิษฐ์ใดๆ ที่สร้างโดยส่วนขยาย (เช่น รูปภาพที่เก็บไว้)
ทรัพยากรอื่นๆ ในโปรเจ็กต์ของคุณ เช่น อินสแตนซ์ฐานข้อมูลหรือที่เก็บข้อมูล Cloud Storage แม้ว่าส่วนขยายจะโต้ตอบกับทรัพยากรอื่นๆ เหล่านี้ ส่วนขยายเหล่านั้นจะไม่ เฉพาะส่วนขยาย ดังนั้นจึงไม่ถูกลบหากถอนการติดตั้งส่วนขยาย
ต่อไปนี้เป็นวิธีถอนการติดตั้งส่วนขยาย:
หากต้องการลบอิน สแตนซ์ส่วนขยายออกจากรายการส่วนขยาย ของคุณ ให้รันคำสั่งถอนการติดตั้งส่วนขยาย:
firebase ext:uninstall extensionInstanceId
จากนั้น หากต้องการปรับใช้การเปลี่ยนแปลงรายการของคุณกับโปรเจ็กต์ Firebase ให้เรียกใช้:
firebase deploy --only extensions --project=projectId-or-alias