Quản lý các tiện ích Firebase đã cài đặt

Để cài đặt hoặc quản lý các tiện ích, 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 đã cài đặt của một dự án

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

Chạy lệnh extensions-list:

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

Xem thông tin chi tiết và cấu hình của một phiên bản tiện ích đã cài đặt

  1. Chuyển đến Firebase Extensions trang tổng quan trong bảng điều khiển Firebase.

  2. Trên thẻ của phiên bản tiện ích đã cài đặt, hãy nhấp vào Quản lý.

Giám sát một phiên bản tiện ích đã cài đặt

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

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

Đặt cảnh báo về ngân sách là một phương pháp hay nói chung, 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 thứ ba sẽ chạy trong dự án của mình.

Đảm bảo 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 hàm do tiện ích tạo

  1. Chuyển đến trang tổng quan về Các hàm của bảng điều khiển Firebase.

  2. Trong thẻ Trang tổng quan, bạn có thể xem các hàm từ Firebase Extensions (cùng với mọi hàm khác mà bạn đã triển khai cho dự án của mình).

    Các hàm do tiện ích tạo có tên theo định dạng: ext-extension-instance-id-functionName

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

Xem Cloud Scheduler các công việc do tiện ích tạo

  1. Mở trang Cloud Scheduler của dự án trong bảng điều khiển Google Cloud.

  2. Trong danh sách Công việc, bạn có thể xem các công việc Cloud Scheduler từ Firebase Extensions (cùng với mọi công việc khác mà bạn đã tạo cho dự án của mình).

    Các công việc do tiện ích tạo ra 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 Cloud Tasks do tiện ích xếp hàng

Một số tiện ích sử dụng Cloud Tasks để chạy các tác vụ kéo dài: thường là các tác vụ xử lý chạy tại nhiều thời điểm trong vòng đời của tiện ích – cài đặt, định 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ẽ chạy và hoàn tất tự động mà không cần bạn can thiệp. Tuy nhiên, nếu bạn cần quản lý các tác vụ trong hàng đợi của tiện ích theo cách thủ công (ví dụ: để tạm dừng hàng đợi hoặc xoá một tác vụ chưa bắt đầu khỏi hàng đợi), hãy làm theo các bước sau:

  1. Trong mục Tiện ích 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.

  2. Trên trang chi tiết, hãy mở mục API và tài nguyên. Nếu tiện ích sử dụng Cloud Tasks, sẽ có một mục Hàng đợi Cloud Tasks với một hoặc nhiều mục.

  3. Nhấp vào Xem hàng đợi cho hàng đợi mà bạn muốn quản lý. Thao tác này sẽ mở trang Queue Details (Chi tiết hàng đợi) trong bảng điều khiển Google Cloud. Tại đây, bạn có thể xem các tác vụ trong hàng đợi, tạm dừng hàng đợi, xoá các tác vụ khỏi hàng đợi, v.v. Xem phần Quản lý hàng đợi và công việc trong tài liệu Cloud Tasks.

Xem các bí mật trong Cloud Secret Manager do tiện ích tạo

  1. Mở trang Secret Manager (Trình quản lý bí mật) của dự án trong bảng điều khiển Google Cloud.

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

    Các khoá bí mật do tiện ích tạo có tên ở định dạng: ext-extension-instance-id-paramnName

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

    Các khoá bí mật được gắn nhãn bằng khoá firebase-extensions-managed. Đừng xoá nhãn này trừ phi bạn muốn Firebase ngừng quản lý khoá bí mật.

Kiểm tra xem một tiện ích đã cài đặt có hoạt động bình thường hay không

Bạn có thể xem tất cả các lỗi từ các hàm (bao gồm cả những lỗi do Firebase Extensions tạo) trong bảng điều khiển.

  1. Trong thẻ Health (Tình trạng) của trang tổng quan Functions, bạn có thể xem thông tin tổng quan về lỗi và hiệu suất của tất cả các hàm trong dự án.

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

Kiểm tra tần suất chạy của một tiện ích đã cài đặt

  1. Trong thẻ Trang tổng quan của Trang tổng quan về các hàm, hãy tìm hàm cụ thể cho Firebase Extension mà bạn muốn kiểm tra.

  2. Nhấp vào biểu tượng (trình đơn tuỳ chọn khác) ở phía bên phải của mục nhập, sau đó chọn Số liệu thống kê chi tiết về mức sử dụng.

  3. Trong bảng điều khiển Google Cloud xuất hiện, bạn có thể đi sâu vào nhiều lệnh gọi của một hàm và thậm chí kiểm tra mã nguồn của hàm đó.

Xem nhật ký của một tiện ích

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

Trong thẻ Nhật ký của trang tổng quan về Các hàm, hãy sử dụng bộ lọc ở đầu trang để chọn các hàm do tiện ích của bạn tạo.

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

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

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

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

  1. Chuyển đến Firebase Extensions trang tổng quan, sau đó trên thẻ của phiên bản tiện ích đã cài đặt, hãy nhấp vào Quản lý.

  2. Ở góc trên bên phải, hãy nhấp vào Cập nhật tiện ích.

    Nếu tiện ích không có phiên bản mới, thì trang chi tiết sẽ không có nút cập nhật.

  3. Xem những điểm mới trong bản cập nhật và định cấu hình tiện ích (nếu cần).

  4. Nhấp vào Cập nhật tiện ích.

Định cấu hình lại một phiên bản tiện ích đã 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 một phiên bản tiện ích đã cài đặt. Những giá trị mới này sẽ được dùng trong mọi sự kiện kích hoạt trong tương lai của phiên bản, nhưng mọi cấu phần phần mềm hoặc phần tử cấu trúc trước đó do tiện ích tạo (chẳng hạn như hình ảnh được lưu trữ hoặc các vùng lưu trữ hiện có) sẽ không thay đổi.

  1. Chuyển đến trang tổng quan Firebase Extensions, sau đó nhấp vào Quản lý trên thẻ của phiên bản tiện ích đã cài đặt.

  2. Ở góc trên bên phải, hãy nhấp vào Định cấu hình lại tiện ích.

  3. Làm theo hướng dẫn trên màn hình để định cấu hình lại các giá trị tham số cho tiện ích của bạn.

  4. Nhấp vào Lưu.

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

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

  • Mọi thành phần do tiện ích tạo ra (chẳng hạn như hình ảnh được lưu trữ).

  • Mọi tài nguyên khác trong dự án của bạn, chẳng hạn như một thực thể cơ sở dữ liệu hoặc vùng lưu trữ Cloud Storage. Ngay cả khi tiện ích tương tác với các tài nguyên khác này, chúng cũng không phải là dành riêng cho tiện ích, vì vậy, chúng sẽ không bị xoá nếu tiện ích bị gỡ cài đặt.

Sau đây là cách gỡ cài đặt tiện ích:

  1. Chuyển đến trang tổng quan Firebase Extensions, sau đó nhấp vào Quản lý trên thẻ của phiên bản tiện ích đã cài đặt.

  2. Ở cuối màn hình, hãy nhấp vào Gỡ cài đặt tiện ích.

  3. Xem lại những nội dung sẽ bị xoá, sau đó nhấp vào Gỡ cài đặt tiện ích để xác nhận việc xoá.