Để 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 bản sao tiện ích đã cài đặt của một 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 danh sách tiện ích:
firebase ext:list --project=projectId-or-alias
Giám sát một bản sao tiện ích đã cài đặt
Trong bảng điều khiển của 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 đó.
Thiết lập thông báo về ngân sách
Nói chung, việc đặt cảnh báo về ngân sách 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 một bên khác sẽ 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 trong bảng điều khiển của Firebase.
Trong thẻ Trang tổng quan, bạn có thể xem các hàm trong Tiện ích Firebase (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 ra có tên, ở định dạng:
ext-extension-instance-id-functionName
Ví dụ:
ext-awesome-task-simplifier-onUserCreate
Xem công việc trên Cloud Scheduler do tiện ích tạo
Mở trang Cloud Scheduler (Trình lập lịch biểu đám mây) 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 của Cloud Scheduler từ Tiện ích Firebase (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ô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ý 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: phổ biến nhất là xử lý các tác vụ chạy tại các điểm khác nhau 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 chạy và hoàn thành tự động 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ý 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 mục Tiện ích trên bảng điều khiển của Firebase, hãy mở trang chi tiết của phiên bản tiện ích.
Trên trang chi tiết, mở phần 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 gồm một hoặc nhiều mục nhập.
Nhấp vào Xem hàng đợi đối với hàng đợi bạn muốn quản lý. Thao tác này sẽ mở trang 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 công việc trong hàng đợi, tạm dừng hàng đợi, xoá công việc 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ề Tác vụ đám mây.
Xem mã thông tin 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 Secret Manager (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 khoá bí mật được tạo cho Tiện ích Firebase (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 theo đị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 tiện ích đã cài đặt có hoạt động tốt không
Bạn có thể xem lại tất cả lỗi từ các hàm (bao gồm cả những lỗi do Tiện ích Firebase tạo) trong bảng điều khiển.
Trong thẻ Sức khoẻ trên Trang tổng quan về hàm, bạn có thể xem thông tin tổng quan về các lỗi và thông tin về hiệu suất của tất cả cá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 chạy một tiện ích đã cài đặt
Trong thẻ Trang tổng quan của Trang tổng quan về hàm, hãy tìm hàm cụ thể cho Tiện ích Firebase mà bạn muốn kiểm tra.
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.Trong bảng điều khiển Google Cloud hiển thị, bạn có thể xem chi tiết nhiều lệnh gọi của một hàm và thậm chí là 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 cho dự án hoặc gửi báo cáo lỗi cho Firebase, bạn nên xem nhật ký về các hàm đang chạy trong dự án của mình.
Trong thẻ Logs (Nhật ký) của Trang tổng quan về hàm, hãy 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 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ã bản sao 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à sẽ có thể chỉ định giá trị cho mọi tham số mới.
Để cập nhật một bản sao tiện ích trong tệp kê khai tiện ích lên phiên bản mới nhất, hãy chạy lệnh cập nhật tiện ích:
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
Sau đó, để triển khai các tiện ích trong tệp kê khai lên một dự án Firebase, hãy chạy:
firebase deploy --only extensions --project=projectId-or-alias
Định cấu hình lại một bản sao 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 bản sao tiện ích đã cài đặt. Những giá trị mới này sẽ được sử dụng trong mọi điều kiện 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 này tạo ra (như hình ảnh được lưu trữ hoặc bộ chứa lưu trữ hiện có) sẽ không thay đổi.
Để định cấu hình lại một tiện ích một cách có tính tương tác trong tệp kê khai tiện ích, hãy chạy lệnh định cấu hình tiện ích:
firebase ext:configure extensionInstanceId
Sau đó, để triển khai các tiện ích trong tệp kê khai lên một dự án Firebase, hãy chạy:
firebase deploy --only extensions --project=projectId-or-alias
Gỡ cài đặt một bản sao tiện ích
Bạn có thể gỡ cài đặt một bản sao của một tiện ích khỏi dự án Firebase của mình. Thao tác này sẽ xoá tài khoản dịch vụ và tất cả tài nguyên (như một nhóm hàm) mà Firebase đã tạo riêng cho bản sao tiện ích đó. Tuy nhiên, những dữ liệu sau đây 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 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.
Dưới đây là cách gỡ cài đặt tiện ích:
Để xoá một bản sao tiện ích khỏi tệp kê khai tiện ích, hãy chạy lệnh gỡ cài đặt tiện ích:
firebase ext:uninstall extensionInstanceId
Sau đó, để triển khai các thay đổi đối với tệp kê khai trên một dự án Firebase, hãy chạy:
firebase deploy --only extensions --project=projectId-or-alias