จัดการส่วนขยาย Firebase ที่ติดตั้ง

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

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

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

รันคำสั่ง extensions-list:

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

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

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

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

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

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

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

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

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

    ฟังก์ชั่นที่สร้างโดยส่วนขยายจะมีชื่อในรูปแบบ: 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 จะมีส่วน คิวงานระบบคลาวด์ ที่มีรายการอย่างน้อย 1 รายการ

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

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

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

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

    ข้อมูลลับที่สร้างโดยส่วนขยายจะมีชื่อในรูปแบบ: 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 ที่แสดง คุณสามารถเจาะลึกการเรียกใช้ฟังก์ชันต่างๆ และตรวจสอบซอร์สโค้ดของฟังก์ชันได้

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

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

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

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

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

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

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

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

    firebase ext:update extensionInstanceId

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

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

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

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

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

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

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

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

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

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

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

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

ต่อไปนี้เป็นวิธีถอนการติดตั้งส่วนขยาย:

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

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

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