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 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

  1. Chuyển đến Trang tổng quan về hàm trong 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 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

  1. 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.

  2. 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:

  1. 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.

  2. 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.

  3. 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

  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 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.

  1. 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.

  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 Tiện ích Firebase 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 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.

  1. Để 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

  2. 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.

  1. Để đị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

  2. 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:

  1. Để 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

  2. 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