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

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

Bạn có thể liệt kê mọi bản sao của những tiện ích 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 thực thể tiện ích đã cài đặt

  1. Chuyển đến trang tổng quan Firebase Extensions 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 thực thể tiện ích đã cài đặt

Trong bảng điều khiển Firebase, bạn có thể giám sát 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

Nhìn chung, bạn nên đặt cảnh báo về ngân sách, nhưng cảnh báo có thể đặc biệt quan trọng khi bạn tin tưởng mã của một bên khác để chạy trong dự án của mình.

Hãy nhớ thiết lập cảnh báo về ngân sách cho dự án Firebase của bạn.

Xem các hàm do tiện ích tạo

  1. Chuyển đến Trang tổng quan về hàm trên bảng điều khiển của 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ác hàm do tiện ích tạo 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 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ô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 công việc trên Cloud Tasks do tiện ích đưa vào hàng đợi

Một số tiện ích sử dụng Cloud Tasks để chạy các tác vụ chạy trong thời gian dài hơn: thường là các tác vụ xử lý chạy tại nhiều đ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ẽ tự động chạy và hoàn tất 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 một 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 phần Extensions (Tiện ích) của bảng điều khiển Firebase, hãy mở trang chi tiết của thực thể 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 này sử dụng Cloud Tasks, thì sẽ có một mục hàng đợi tác vụ trên đám mây có một hoặc nhiều mục nhập.

  3. Nhấp vào Xem hàng đợi để xem danh sách chờ mà bạn muốn quản lý. Thao tác này sẽ mở trang Thông tin chi tiết về 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á tác vụ khỏi hàng đợi, v.v. Xem phần Quản lý hàng đợi và tác vụ trong tài liệu về Cloud Tasks.

Xem mã thông báo bí mật của người quản lý bí mật trên đám mây do các tiện ích tạo ra

  1. Mở trang 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 Khoá bí mật, bạn có thể xem các khoá bí mật được tạo cho Firebase Extensions (cùng với mọi khoá bí mật khác bạn đã tạo cho dự án của mình).

    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

    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 ngăn Firebase 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ả lỗi từ các hàm (bao gồm cả lỗi do Firebase Extensions tạo) trong bảng điều khiển.

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

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

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

  1. Trong thẻ Trang tổng quan của Trang tổng quan về 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 (trình đơn mục bổ sung) ở ngoài cùng bên phải của mục, rồi chọn Chi tiết số liệu thống kê về việc sử dụng.

  3. Trong bảng điều khiển Google Cloud hiển thị, bạn có thể xem chi tiết các lệnh gọi khác nhau 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 bạn đ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ề 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 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 bản sao đã cài đặt của một tiện ích lên phiên bản phát hành mới nhất. Bạn nên cập nhật một thực thể đã cài đặt vì thực thể đó đang chạy hoặc được thiết lập trong quy trình kiểm thử, dự án hoặc ứng dụng.

Khi bạn cập nhật một thực thể, tất 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à có thể chỉ định giá trị cho mọi tham số mới.

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

  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 xét những tính năng 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 thực thể 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 thực thể tiện ích đã cài đặt. Các giá trị mới này sẽ được sử dụng trong mọi trình kích hoạt trong tương lai của thực thể, nhưng tất cả 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 bộ chứa bộ nhớ hiện có) sẽ không thay đổi.

  1. Chuyển đến trang tổng quan của Firebase Extensions, 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 Đị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 thực thể tiện ích

Bạn có thể gỡ cài đặt một thực thể 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 tập hợp các hàm) mà Firebase tạo riêng cho thực thể đó của tiện ích. Tuy nhiên, những nội dung sau đây sẽ không bị xoá:

  • Mọi cấu phần phần mềm do tiện ích tạo (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ư thực thể cơ sở dữ liệu hoặc bộ chứa Cloud Storage. Ngay cả khi tiện ích đã tương tác với các tài nguyên khác này, thì những tiện ích đó không dành riêng cho tiện ích. Vì vậy, các tiện ích này sẽ không bị xoá nếu 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 thực thể 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á.