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

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

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

  1. ไปที่หน้าแดชบอร์ดส่วนขยาย Firebase ในคอนโซล 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 ที่มีรายการอย่างน้อย 1 รายการ

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

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

  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 ที่ต้องการตรวจสอบ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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