Quản lý tiện ích mở rộng Firebase đã cài đặt

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

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

Chạy lệnh danh sách tiện ích mở rộng:

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

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

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

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

Nói chung, đặt cảnh báo 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 cậy mã của bên khác chạy trong dự án của mình.

Đảm bảo rằng 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 chức năng được tạo bởi tiện ích mở rộng

  1. Chuyển đến trang tổng quan Chức năng của bảng điều khiển Firebase.

  2. Trong tab Trang tổng quan , bạn có thể xem các chức năng từ Tiện ích mở rộng Firebase (cùng với bất kỳ chức năng nào khác mà bạn đã triển khai cho dự án của mình).

    Các hàm được tạo bởi tiện ích mở rộng có tên, theo định dạng: ext- extension-instance-id - functionName

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

Xem các công việc Cloud Scheduler được tạo bởi tiện ích mở rộng

  1. Mở trang Trình lập lịch đám mây của dự án của bạ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 Trình lập lịch trình đám mây từ Tiện ích mở rộng 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ác công việc được tạo bởi tiện ích mở rộng có tên theo định dạng: firebase-ext- extension-instance-id - functionName

    Ví dụ: firebase-ext-awesome-task-simplifier-doTask

Xem và quản lý các Tác vụ trên đám mây được sắp xếp theo các tiện ích mở rộng

Một số tiện ích mở rộng sử dụng Nhiệm vụ trên đám mây để chạy các tác vụ chạy lâu hơn: phổ biến nhất là xử lý các tác vụ chạy ở nhiều thời điểm khác nhau trong vòng đời của tiện ích mở rộng—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 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ý thủ công các tác vụ được xếp hàng đợi của tiện ích mở rộng—ví dụ: để tạm dừng hàng đợi hoặc xóa khỏi hàng đợi một tác vụ chưa bắt đầu—hãy làm theo các bước sau:

  1. Trong phần Tiện ích mở rộng 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 mở rộng.

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

  3. Bấm vào Xem hàng đợi cho hàng đợi bạn muốn quản lý. Thao tác này sẽ mở trang Chi tiết hàng đợi trong bảng điều khiển Google Cloud, từ đó bạn có thể xem các tác vụ được xếp hàng đợi, tạm dừng hàng đợi, xóa các tác vụ khỏi hàng đợi, v.v. Xem Quản lý hàng đợi và nhiệm vụ trong tài liệu Nhiệm vụ trên đám mây.

Xem bí mật của Cloud Secret Manager được tạo bởi tiện ích mở rộng

  1. Mở trang Trình quản lý bí mật của dự án của bạ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 Tiện ích mở rộng Firebase (cùng với mọi bí mật khác mà bạn đã tạo cho dự án của mình).

    Bí mật được tạo bởi tiện ích mở rộng có tên theo định dạng: ext- extension-instance-id - paramnName

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

    Các bí mật được gắn nhãn bằng khóa firebase-extensions-managed . Không xóa nhãn này trừ khi bạn muốn ngăn Firebase quản lý bí mật.

Kiểm tra xem tiện ích mở rộng đã cài đặt có hoạt động tốt không

Bạn có thể xem lại tất cả các lỗi từ các chức năng (bao gồm cả những lỗi được tạo bởi Tiện ích mở rộng Firebase) trong bảng điều khiển.

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

  2. Để xem thông tin về một tiện ích mở rộng cụ thể, hãy sử 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 tiện ích mở rộng đã cài đặt

  1. Trong tab Trang tổng quan của trang tổng quan Chức năng , hãy tìm chức năng cụ thể cho Tiện ích mở rộng Firebase mà bạn muốn kiểm tra.

  2. Nhấp vào (menu mục bổ sung) ở phía bên phải của mục nhập, sau đó chọn Số liệu thống kê sử dụng chi tiết .

  3. Trong bảng điều khiển Google Cloud được hiển thị, bạn có thể đi sâu vào các cách 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 tiện ích mở rộng

Nếu bạn đang cố gắng gỡ lỗi dự án của mình hoặc gửi báo cáo lỗi tới Firebase thì việc xem nhật ký của các chức năng đang chạy trong dự án của bạn sẽ rất hữu ích.

Trong tab Nhật ký của bảng điều khiển Chức năng , hãy sử dụng bộ lọc ở đầu trang để chọn các chức năng do tiện ích mở rộng của bạn tạo.

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

Bạn có thể cập nhật phiên bản đã cài đặt của tiện ích mở rộng lên phiên bản được 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 tích cực trong quy trình thử nghiệm, dự án hoặc ứng dụng của bạn.

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

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

  1. Để cập nhật phiên bản tiện ích mở rộng trong bảng kê khai tiện ích mở rộng của bạn lên phiên bản mới nhất, hãy chạy lệnh cập nhật tiện ích mở rộng:

    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 mở rộng trong tệp kê khai của bạn vào dự án Firebase, hãy chạy:

    firebase deploy --only extensions --project=projectId-or-alias

Định cấu hình lại phiên bản tiện ích mở rộng đã 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 phiên bản tiện ích mở rộng đã cài đặt. Các giá trị mới này sẽ được sử dụng trong bất kỳ trình kích hoạt phiên bản nào trong tương lai , nhưng tất cả các thành phần cấu trúc hoặc tạo phẩm trước đó do tiện ích mở rộng tạo ra (như hình ảnh được lưu trữ hoặc nhóm lưu trữ hiện có) sẽ không bị thay đổi.

  1. Để định cấu hình lại một cách tương tác tiện ích mở rộng trong bảng kê khai tiện ích mở rộng của bạn, hãy chạy lệnh cấu hình tiện ích mở rộng:

    firebase ext:configure extensionInstanceId
  2. Sau đó, để triển khai các tiện ích mở rộng trong tệp kê khai của bạn vào dự án Firebase, hãy chạy:

    firebase deploy --only extensions --project=projectId-or-alias

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

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

  • Bất kỳ tạo phẩm nào được tiện ích mở rộng tạo ra (như hình ảnh được lưu trữ).

  • Bất kỳ tài nguyên nào khác trong dự án của bạn, chẳng hạn như phiên bản cơ sở dữ liệu hoặc nhóm Cloud Storage. Ngay cả khi tiện ích mở rộng tương tác với các tài nguyên khác này, chúng không dành riêng cho tiện ích mở rộng nên chúng không bị xóa nếu tiện ích mở rộng bị gỡ cài đặt.

Dưới đây là cách gỡ cài đặt tiện ích mở rộng:

  1. Để xóa phiên bản tiện ích mở rộng khỏi bảng kê khai tiện ích mở rộng của bạn, hãy chạy lệnh gỡ cài đặt tiện ích mở rộng:

    firebase ext:uninstall extensionInstanceId
  2. Sau đó, để triển khai các thay đổi đối với tệp kê khai của bạn trên dự án Firebase, hãy chạy:

    firebase deploy --only extensions --project=projectId-or-alias