Để 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 phiên bản của các tiện ích đã 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 bản sao tiện ích đã cài đặt
Chuyển đến trang tổng quan Firebase Extensions trong bảng điều khiển Firebase.
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 bản sao 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
Chuyển đến trang tổng quan về Hàm của bảng điều khiển Firebase.
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 ra 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
Mở trang Cloud Scheduler của dự án trong bảng điều khiển Google Cloud.
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 các tiện ích tạo 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ý Cloud Tasks được đư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 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:
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.
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.
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 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à công việc 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
Mở trang Trình quản lý bí mật của dự án trong bảng điều khiển Google Cloud.
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 mà bạn đã tạo cho dự án).
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 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 lại tất cả lỗi của các hàm (bao gồm cả những lỗi do Firebase Extensions tạo) trong bảng điều khiển.
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.
Để 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 một tiện ích đã cài đặt đang chạy
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.
Nhấp vào
(trình đơn mục bổ sung) ở bên phải cùng của mục nhập, sau đó chọn Thống kê chi tiết về mức sử dụng.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 có thể muố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 quy trình làm việc của ứ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 phiên bản đó sẽ được ghi đè để sử dụng tệp và mã nguồn 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.
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, nhấp vào Quản lý.
Ở 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.
Xem lại nội dung mới trong bản cập nhật và định cấu hình tiện ích (nếu cần).
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.
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.
Ở góc trên bên phải, hãy nhấp vào Định cấu hình lại tiện ích.
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.
Nhấp vào Lưu.
Gỡ cài đặt một bản sao 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á:
Bất kỳ cấu phần phần mềm nào do tiện ích tạo ra (như hình ảnh đã lưu trữ).
Mọi tài nguyên khác trong dự án, chẳng hạn như một 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:
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ý.
Ở cuối màn hình, hãy nhấp vào Gỡ cài đặt tiện ích.
Xem xét 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á.