了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Quản lý các Tiện ích mở rộng Firebase đã cài đặt

Để cài đặt hoặc quản lý tiện ích mở rộng, bạn phải được chỉ định một trong các vai trò sau: Chủ sở hữu hoặc Người chỉnh sửa hoặc Quản trị viên Firebase .

Liệt kê các phiên bản tiện ích mở rộng đã cài đặt của dự án

Bạn có thể liệt kê mọi phiên bản của tiện ích mở rộng mà bạn đã cài đặt.

Chạy lệnh danh sách tiện ích mở rộng:

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

Theo dõi phiên bản tiện ích mở rộng đã cài đặt

Trong bảng điều khiển Firebase, bạn có thể theo dõi hoạt động của tiện ích mở rộng đã cài đặt, bao gồm kiểm tra tình trạng, mức sử dụng và nhật ký của tiện ích mở rộng đó.

Đặt cảnh báo ngân sách

Đặt cảnh báo ngân sách nói chung là một phương pháp hay, nhưng cảnh báo có thể đặc biệt quan trọng khi bạn tin tưởng mã của bên khác sẽ chạy trong dự án của mình.

Đảm bảo rằng bạn đã thiết lập cảnh báo ngân sách cho dự án Firebase của mình.

Xem các chức năng được tạo bởi tiện ích mở rộng

  1. Chuyển đến bảng điều khiển Chức năng của bảng điều khiển Firebase.

  2. Trong tab Trang tổng quan , bạn có thể xem các chức năng từ Tiện ích mở rộng Firebase (cùng với bất kỳ chức năng nào khác mà bạn đã triển khai cho dự án của mình).

    Các hàm được tạo bởi tiện ích mở rộng có tên, ở định dạng: ext- extension-instance-id - functionName

    Ví dụ: ext-awesome-task-simplifier-onUserCreate

Xem các công việc Cloud Scheduler được tạo bởi tiện ích mở rộng

  1. Mở trang Trình lập lịch biểu đám mây của dự án trong Google Cloud Console.

  2. Trong danh sách Công việc, bạn có thể xem các công việc Bộ lập lịch đám mây từ Tiện ích mở rộng Firebase (cùng với bất kỳ công việc nào khác mà bạn đã tạo cho dự án của mình).

    Các công việc được tạo bởi tiện ích mở rộng có tên ở định dạng: firebase-ext- extension-instance-id - functionName

    Ví dụ: firebase-ext-awesome-task-simplifier-doTask

Xem và quản lý các Tác vụ trên đám mây được các tiện ích mở rộng xếp hàng đợi

Một số tiện ích mở rộng sử dụng Tác vụ trên đám mây để chạy các tác vụ chạy lâu hơn: phổ biến nhất là xử lý các tác vụ chạy ở các điểm khác nhau trong vòng đời của tiện ích mở rộng—cài đặt, cấu hình lại và sau khi nâng cấp.

Thông thường, các tác vụ này sẽ tự động chạy và hoàn thành mà không cần sự can thiệp của bạn. Tuy nhiên, nếu bạn cần quản lý thủ công các tác vụ đã xếp hàng đợi của tiện ích mở rộng—ví dụ: để tạm dừng hàng đợi hoặc xóa khỏi hàng đợi một tác vụ chưa bắt đầu—hãy làm theo các bước sau:

  1. Trong phần Tiện ích mở rộng của bảng điều khiển Firebase, hãy mở trang chi tiết của phiên bản tiện ích mở rộng.

  2. Trên trang chi tiết, hãy mở phần API và tài nguyên . Nếu tiện ích mở rộng sử dụng Tác vụ trên đám mây, thì sẽ có phần hàng đợi Tác vụ trên đám mây với một hoặc nhiều mục nhập.

  3. Nhấp vào Xem hàng đợi cho hàng đợi bạn muốn quản lý. Thao tác này sẽ mở trang Chi tiết hàng đợi trong Google Cloud Console, từ đó bạn có thể xem các tác vụ được xếp hàng đợi, tạm dừng hàng đợi, xóa các tác vụ khỏi hàng đợi, v.v. Xem Quản lý hàng đợi và tác vụ trong tài liệu về Tác vụ trên đám mây.

Xem các bí mật của Cloud Secret Manager được tạo bởi các tiện ích mở rộng

  1. Mở trang Trình quản lý bí mật của dự án trong Google Cloud Console.

  2. Trong danh sách Bí mật, bạn có thể xem các bí mật được tạo cho Tiện ích mở rộng Firebase (cùng với bất kỳ bí mật nào khác mà bạn đã tạo cho dự án của mình).

    Bí mật được tạo bởi tiện ích mở rộng có tên ở định dạng: ext- extension-instance-id - paramnName

    Ví dụ: ext-awesome-task-simplifier-API_KEY

    Các bí mật được gắn nhãn bằng khóa firebase-extensions-managed . Không xóa nhãn này trừ khi bạn muốn ngăn Firebase quản lý bí mật.

Kiểm tra xem tiện ích mở rộng đã cài đặt có tốt không

Bạn có thể xem lại tất cả các lỗi từ các chức năng (bao gồm cả những lỗi được tạo bởi Tiện ích mở rộng Firebase) trong bảng điều khiển.

  1. Trong tab Tình trạng của bảng điều khiển Chức năng của bạn, bạn có thể xem tổng quan về các lỗi và thông tin hiệu suất cho tất cả các chức năng trong dự án của mình.

  2. Để xem thông tin cho một tiện ích mở rộng cụ thể, hãy sử dụng bộ lọc ở đầu trang để chọn một chức năng cụ thể.

Kiểm tra tần suất một tiện ích mở rộng đã cài đặt đang chạy

  1. Trong tab Trang tổng quan của Bảng điều khiển chức năng của bạn , tìm chức năng cụ thể cho Tiện ích mở rộng Firebase mà bạn muốn kiểm tra.

  2. Nhấp vào (menu mục bổ sung) ở phía ngoài cùng bên phải của mục nhập, sau đó chọn Số liệu thống kê sử dụng chi tiết .

  3. Trong Google Cloud Console được hiển thị, bạn có thể đi sâu vào các lệnh gọi khác nhau của một chức năng và thậm chí kiểm tra mã nguồn của nó.

Xem nhật ký cho tiện ích mở rộng

Nếu bạn đang cố gắng gỡ lỗi dự án của mình hoặc gửi báo cáo lỗi tới Firebase, bạn nên xem nhật ký của các chức năng đang chạy trong dự án của mình.

Trong tab Nhật ký của bảng điều khiển Chức năng của bạn , hãy sử dụng bộ lọc ở đầu trang để chọn các chức năng được tạo bởi tiện ích mở rộng của bạn.

Cập nhật phiên bản tiện ích mở rộng đã cài đặt lên phiên bản mới nhất

Bạn có thể cập nhật phiên bản đã cài đặt của tiện ích mở rộng lên phiên bản mới nhất được phát hành. Bạn có thể muốn cập nhật một phiên bản đã cài đặt vì phiên bản này đang chạy tích cực hoặc được thiết lập trong quy trình thử nghiệm, dự án hoặc ứng dụng của bạn.

Khi bạn cập nhật một phiên bản, tất cả logic và tài nguyên dành riêng cho phần mở rộng của phiên bản đó sẽ được ghi đè để sử dụng tệp và mã nguồn của phiên bản mới. Tài khoản dịch vụ và ID phiên bản của tiện ích mở rộng sẽ không thay đổi.

Trong quá trình cập nhật, bạn sẽ được thông báo về bất kỳ thay đổi nào đối với phiên bản mới và bạn sẽ có thể chỉ định giá trị cho bất kỳ tham số mới nào.

  1. Để cập nhật phiên bản tiện ích mở rộng trong bảng kê khai tiện ích mở rộng của bạn lên phiên bản mới nhất, hãy chạy lệnh cập nhật tiện ích mở rộng:

    firebase ext:update extensionInstanceId

    Để cập nhật lên một phiên bản cụ thể, hãy cung cấp phiên bản bạn muốn cập nhật:

    firebase ext:update extensionInstanceId versionNumber

  2. Sau đó, để triển khai các tiện ích mở rộng trong tệp kê khai của bạn lên dự án Firebase, hãy chạy:

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

Định cấu hình lại phiên bản tiện ích mở rộng đã cài đặt

Bạn có thể thay đổi giá trị của các tham số do người dùng định cấu hình cho phiên bản tiện ích mở rộng đã cài đặt. Các giá trị mới này sẽ được sử dụng trong bất kỳ trình kích hoạt nào trong tương lai của phiên bản, nhưng tất cả các thành phần cấu tạo hoặc phần tử cấu trúc trước đó được tạo bởi tiện ích mở rộng (như hình ảnh được lưu trữ hoặc bộ chứa lưu trữ hiện có) sẽ không bị thay đổi.

  1. Để định cấu hình lại tiện ích mở rộng một cách tương tác trong bảng kê khai tiện ích mở rộng của bạn, hãy chạy lệnh cấu hình tiện ích mở rộng:

    firebase ext:configure extensionInstanceId

  2. Sau đó, để triển khai các tiện ích mở rộng trong tệp kê khai của bạn lên dự án Firebase, hãy chạy:

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

Gỡ cài đặt phiên bản tiện ích mở rộng

Bạn có thể gỡ cài đặt phiên bản của tiện ích mở rộng khỏi dự án Firebase của mình. Hành động này sẽ xóa tài khoản dịch vụ và tất cả các tài nguyên (chẳng hạn như một tập hợp các chức năng) mà Firebase đã tạo riêng cho phiên bản tiện ích mở rộng đó. Tuy nhiên, những điều sau đây không bị xóa:

  • Bất kỳ thành phần tạo tác nào do tiện ích mở rộng tạo ra (chẳng hạn như hình ảnh được lưu trữ).

  • Bất kỳ tài nguyên nào khác trong dự án của bạn, chẳng hạn như phiên bản cơ sở dữ liệu hoặc bộ chứa Cloud Storage. Ngay cả khi tiện ích mở rộng tương tác với các tài nguyên khác này, chúng không dành riêng cho tiện ích mở rộng , vì vậy chúng sẽ không bị xóa nếu tiện ích mở rộng bị gỡ cài đặt.

Đây là cách gỡ cài đặt tiện ích mở rộng:

  1. Để xóa phiên bản tiện ích mở rộng khỏi bảng kê khai tiện ích mở rộng của bạn, hãy chạy lệnh gỡ cài đặt tiện ích mở rộng:

    firebase ext:uninstall extensionInstanceId

  2. Sau đó, để triển khai các thay đổi đối với tệp kê khai của bạn trên dự án Firebase, hãy chạy:

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