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


Mẫu Remote Config là các tập hợp có định dạng JSON các thông số và điều kiện mà bạn đã tạo cho dự án Firebase của mình. 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ề 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 xuất bản hơn 300 các 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, các phiên bản cũ nhất bị xoá, duy trì tối đa 300 phiên bản 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ạ, trong đó có chứa siêu dữ liệu về nội dung đó phiên bản cụ thể.

Bạn có thể xoá Remote Config mẫu khi cần trong Nhật ký thay đổi trang trên 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ở ra Nhật ký thay đổi trang liệt kê tất cả phiên bản mẫu đã 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 thời điểm cập nhật, người dùng đã tạo bản cập nhật và cách tạo bản cập nhật.

Truy xuấ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 mẫu đã lưu trữ phiên bản:

  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 khác được lưu trữ 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ể khôi phục về phiên bản của mẫu. Cách khôi phục mẫu:

  1. Tìm nút tuỳ chọn ở trên cùng bên phải của 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á mẫu Remote Config khỏi bảng điều khiển Firebase. Người nhận xoá một mẫu Remote Config:

1. Trên trang Remote Config Parameters (Thông số), hãy nhấp vào Change history (Nhật ký thay đổi).
  1. Chuyển sang mẫu bạn muốn xoá, rồi nhấp vào Lựa chọn khác, rồi chọn Xoá.

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

Tải và xuất bản Remote Config mẫu

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 trong 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 thể hiện các giai đoạn khác nhau trong vòng đời phát triển phần mềm, như phát triển, kiểm thử, thử nghiệm và sản xuất môi trường xung quanh. Trong trường hợp này, bạn có thể quảng bá mẫu đã được thử nghiệm đầy đủ từ môi trường thử nghiệm sang môi trường sản xuất bằng cách tải xuống từ dự án thử nghiệm và xuất bản nó lên dự án sản xuất.

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

Các thông số và giá trị thông số được tạo riêng dưới dạng biến thể trong một 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 các đ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ẫu xuống, hãy thực hiện mọi thay đổi cần thiết đối với nội dung JSON và xác thực tệp đó, bạn có thể xuất bản tệp lên một dự án.

Việc xuất bản mẫu sẽ thay thế toàn bộ mẫu cấu hình hiện có bằng đã 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 này sẽ được thay thế nếu bạn xoá một tham số khỏi tệp JSON và xuất bản nó, thông số sẽ bị xoá khỏi máy chủ và không còn dùng được nữa cho khách hàng.

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. Từ Remote Config Tham số hoặc điều kiện , 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, điều hướng đến và chọn Remote Config tệp mà bạn muốn xuất bản, rồi 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