Tạo phiên bản và mẫu Cấu hình từ xa


Mẫu Remote Config là tập hợp các tham số và điều kiện có định dạng JSON mà bạn đã tạo cho dự án Firebase. Bạn có thể tạo mẫu máy khách để ứng dụng của bạn tìm nạp giá trị và mẫu máy chủ để máy khách máy chủ có thể tìm nạp giá trị.

Phần này thảo luận về mẫu máy chủ. Để tìm hiểu về các mẫu dành riêng cho ứng dụng, hãy nhấp vào Mẫu ứng dụng.

Bạn sửa đổi và quản lý mẫu bằng bảng điều khiển Firebase. Bảng điều khiển này hiển thị nội dung của mẫu ở định dạng đồ hoạ trong thẻ Parameters (Thông số) và Conditions (Điều kiện).

Dưới đây là ví dụ về tệp mẫu máy chủ:

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    },
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

Bạn có thể thực hiện các tác vụ quản lý phiên bản này bằng bảng điều khiển Firebase:

  • Liệt kê tất cả phiên bản mẫu được lưu trữ
  • Truy xuất một phiên bản cụ thể
  • Khôi phục về một phiên bản ứng dụng cụ thể
  • Xoá mẫu Remote Config khỏi trang Nhật ký thay đổi

Tổng số phiên bản được lưu trữ trong vòng đời là 300 phiên bản cho mỗi loại mẫu (300 mẫu ứng dụng và 300 mẫu máy chủ), bao gồm cả số phiên bản được lưu trữ cho các mẫu đã xoá. Nếu bạn phát hành hơn 300 phiên bản mẫu cho mỗi loại mẫu trong suốt thời gian hoạt động của dự án, thì các phiên bản sớm nhất sẽ bị xoá, duy trì tối đa 300 phiên bản của loại đó.

Mỗi khi bạn cập nhật tham số, Remote Config sẽ tạo một mẫu Remote Config mới có phiên bản và lưu trữ mẫu trước đó dưới dạng một phiên bản mà bạn có thể truy xuất hoặc quay lại nếu cần. Số phiên bản được tăng dần theo tuần tự từ giá trị ban đầu do Remote Config lưu trữ. Tất cả các mẫu đều có trường version như minh hoạ, chứa siêu dữ liệu về phiên bản cụ thể đó.

Bạn có thể xoá các mẫu Remote Config khi cần trên trang Nhật ký thay đổi của bảng điều khiển Remote Config.

Quản lý các phiên bản mẫu Remote Config

Phần này mô tả cách quản lý các phiên bản của mẫu Remote Config.

Liệt kê tất cả phiên bản đã lưu của mẫu Remote Config

Bạn có thể truy xuất danh sách tất cả phiên bản đã lưu của mẫu Remote Config. Để thực hiện việc này:

  1. Trên bảng điều khiển Firebase, hãy mở Remote Config.

  2. Sau đó, trong thẻ Parameters (Thông số), hãy chọn biểu tượng "đồng hồ" hiển thị ở trên cùng bên phải.

    Thao tác này sẽ mở trang Nhật ký thay đổi liệt kê tất cả các phiên bản mẫu được lưu trữ trong trình đơn danh sách ở bên phải.

    Danh sách mẫu bao gồm siêu dữ liệu cho tất cả phiên bản được lưu trữ, bao gồm cả thời gian cập nhật, người dùng đã tạo và cách tạo mẫu.

Truy xuất một phiên bản cụ thể của mẫu Remote Config

Bạn có thể truy xuất bất kỳ phiên bản cụ thể nào được lưu trữ của mẫu Remote Config. Cách truy xuất phiên bản mẫu đã lưu trữ:

  1. Mở ngăn chi tiết của Nhật ký thay đổi.

  2. Để xem thông tin chi tiết về một phiên bản khác trong danh sách, hãy chọn phiên bản đó trong trình đơn bên phải.

  3. Xem thông tin chi tiết về sự khác biệt giữa mẫu đang hoạt động và mọi phiên bản đã lưu trữ khác bằng cách di chuột qua trình đơn theo bối cảnh cho mọi phiên bản không được chọn rồi chọn So sánh với phiên bản đã chọn.

Khôi phục về một phiên bản cụ thể đã lưu trữ của mẫu Remote Config

Bạn có thể quay lại bất kỳ phiên bản mẫu nào đã lưu trữ. Cách khôi phục mẫu:

  1. Tìm nút tuỳ chọn ở trên cùng bên phải trang Nhật ký thay đổi. Chỉ nhấp và xác nhận việc này nếu bạn chắc chắn muốn quay lại phiên bản đó và sử dụng các giá trị đó ngay lập tức cho tất cả ứng dụng và người dùng.

Xin lưu ý rằng thao tác khôi phục này sẽ tạo một phiên bản được đánh số mới một cách hiệu quả. Ví dụ: việc quay lại từ phiên bản 10 về phiên bản 6 sẽ tạo một bản sao mới của phiên bản 6, chỉ khác với phiên bản gốc ở chỗ số phiên bản là 11. Phiên bản gốc 6 vẫn được lưu trữ, giả sử phiên bản này chưa hết hạn và phiên bản 11 trở thành mẫu đang hoạt động.

Xoá mẫu Remote Config

Bạn có thể xoá các mẫu Remote Config khỏi bảng điều khiển Firebase. Cách xoá mẫu Remote Config:

1. Trên trang Remote Config Parameters (Thông số), hãy nhấp vào biểu tượng Change history (Nhật ký thay đổi).

  1. Chuyển đến mẫu bạn muốn xoá, nhấp vào biểu tượng Tuỳ chọn khác, rồi chọn Xoá.

  2. Khi được nhắc xác nhận xoá, hãy nhấp vào Xoá.

Tải xuống và phát hành mẫu Remote Config

Tải xuống và phát hành các mẫu Remote Config để tích hợp các mẫu đó vào hệ thống kiểm soát nguồn và xây dựng, tự động hoá việc cập nhật cấu hình, đồng bộ hoá các thông số và giá trị trên nhiều dự án.

Bạn có thể tải mẫu Remote Config hiện đang hoạt động xuống bằng cách lập trìnhtừ bảng điều khiển Firebase. Sau đó, bạn có thể cập nhật tệp JSON đã xuất và phát hành tệp đó cho cùng một dự án hoặc phát hành tệp đó cho một dự án mới hoặc hiện có.

Giả sử bạn có nhiều dự án đại diện cho các giai đoạn khác nhau trong vòng đời phát triển phần mềm, chẳng hạn như môi trường phát triển, kiểm thử, thử nghiệm và phát hành công khai. Trong trường hợp này, bạn có thể quảng bá một mẫu đã được kiểm thử đầy đủ từ môi trường thử nghiệm sang môi trường phát hành công khai bằng cách tải mẫu đó xuống từ dự án thử nghiệm và phát hành mẫu đó sang dự án phát hành công khai.

Bạn cũng có thể sử dụng phương thức này để di chuyển cấu hình từ dự án này sang dự án khác hoặc điền các tham số và giá trị từ một dự án đã thiết lập vào dự án mới.

Các thông số và giá trị thông số được tạo riêng dưới dạng biến thể trong thử nghiệm A/B Testing sẽ không có trong mẫu đã xuất.

Cách xuất và nhập mẫu Remote Config:

  1. Tải mẫu Cấu hình Remote Config hiện tại xuống.
  2. Xác thực mẫu Remote Config.
  3. Xuất bản mẫu Remote Config.

Tải Mẫu cấu hình từ xa hiện tại xuống

Hãy sử dụng mã sau để tải mẫu Remote Config đang hoạt động xuống ở định dạng JSON:

  1. Trên thẻ Remote Config Parameters or Conditions (Thông số hoặc điều kiện Remote Config), hãy mở Menu (Trình đơn) rồi chọn Download current config file (Tải tệp cấu hình hiện tại xuống).
  2. Khi được nhắc, hãy nhấp vào Tải tệp cấu hình xuống, chọn vị trí bạn muốn lưu tệp, sau đó nhấp vào Lưu.

Xác thực mẫu Cấu hình từ xa

Mẫu máy chủ được xác thực khi bạn cố gắng phát hành từ bảng điều khiển Firebase. Xin lưu ý rằng bạn có thể nhập điều kiện Người dùng trong tỷ lệ phần trăm ngẫu nhiên, nhưng mọi điều kiện không được hỗ trợ sẽ tạo ra lỗi trong quá trình tải lên. Nếu bạn đang cố gắng xuất bản một mẫu ban đầu được xuất từ mẫu ứng dụng, trước tiên, hãy nhớ xoá mọi điều kiện dành riêng cho ứng dụng.

Xuất bản mẫu Remote Config

Sau khi tải một mẫu xuống, thực hiện mọi thay đổi cần thiết đối với nội dung JSON và xác thực nội dung đó, bạn có thể phát hành mẫu đó cho một dự án.

Việc phát hành mẫu sẽ thay thế toàn bộ mẫu cấu hình hiện có bằng tệp đã cập nhật và tăng phiên bản mẫu thêm một. Vì toàn bộ cấu hình được thay thế, nên nếu bạn xoá một tham số khỏi tệp JSON và phát hành tham số đó, thì tham số đó sẽ bị xoá khỏi máy chủ và không còn được cung cấp cho ứng dụng nữa.

Sau khi phát hành, các thay đổi đối với thông số và giá trị sẽ ngay lập tức có sẵn cho ứng dụng và người dùng. Nếu cần, bạn có thể quay lại phiên bản trước đó.

Sử dụng các lệnh sau để phát hành mẫu:

  1. Trên thẻ Remote Config Tham số hoặc điều kiện, hãy mở Trình đơn, rồi chọn Xuất bản từ tệp.
  2. Khi được nhắc, hãy nhấp vào Duyệt qua, chuyển đến và chọn tệp Remote Config mà bạn muốn phát hành, sau đó nhấp vào Chọn.
  3. Tệp sẽ được xác thực và nếu thành công, bạn có thể nhấp vào Xuất bản để cung cấp ngay cấu hình cho ứng dụng và người dùng.

Các bước tiếp theo