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

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

Phần này thảo luận về mẫu máy chủ. Để tìm hiểu về 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ẻ Tham số và Đ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 sau đây bằng bảng điều khiển Firebase:

Liệt kê tất cả các phiên bản mẫu đã 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

Mỗi loại mẫu có tổng cộng 300 phiên bản đã lưu trữ trong suốt vòng đời (300 mẫu ứng dụng và 300 mẫu máy chủ), bao gồm cả số phiên bản đã lưu trữ cho các mẫu đã xoá. Nếu bạn xuất bản hơn 300 phiên bản mẫu cho mỗi loại mẫu trong suốt vòng đời của một 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 khôi phục khi cần. Số phiên bản được tăng dần theo trình 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á mẫu Remote Config khi cần khỏi trang Nhật ký thay đổi trên bảng điều khiển Remote Config.

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

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

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

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

Trong bảng điều khiển Firebase, hãy mở Remote Config.
Sau đó, trong thẻ Tham số, hãy chọn biểu tượng "đồng hồ" xuất hiện ở 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 đã lưu trữ trong một 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ả các phiên bản đã lưu trữ, bao gồm thời gian cập nhật, người dùng đã thực hiện và cách thực hiện.

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 đã lưu trữ cụ thể nào của mẫu Remote Config. Cách truy xuất phiên bản mẫu đã lưu trữ:

Mở ngăn thông tin chi tiết của Nhật ký thay đổi.
Để 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.
Xem thông tin chi tiết về sự khác biệt của mẫu đang hoạt động và bất kỳ phiên bản đã lưu trữ nào khác bằng cách di chuột qua trình đơn theo bối cảnh cho bất kỳ phiên bản nào chưa 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 đã lưu trữ cụ thể của mẫu Remote Config

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

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 thao tác này nếu bạn chắc chắn muốn khôi phục về 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 mới được đánh số. Ví dụ: việc khôi phục 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 bản gốc ở chỗ số phiên bản là 11. Phiên bản 6 gốc 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ẫuRemote Config

Bạn có thể xoá 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 Tham số, hãy nhấp vào Nhật ký thay đổi.

Chuyển sang mẫu bạn muốn xoá, nhấp vào Thêm, sau đó chọn Xoá.
Khi được nhắc xác nhận việc xoá, hãy nhấp vào Xoá.

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

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

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

Giả sử bạn có nhiều dự án đại diện cho các giai đoạn khác nhau của 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ử, dàn dựng và sản xuất. Trong trường hợp này, bạn có thể nâng cấp một mẫu đã được kiểm thử đầy đủ từ môi trường dàn dựng lên môi trường sản xuất bằng cách tải mẫu đó xuống từ dự án dàn dựng và xuất bản mẫu đó cho 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ừ dự án này sang dự án khác hoặc điền tham số và giá trị từ một dự án đã thiết lập vào một dự án mới.

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

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

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

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

Sử dụng thông tin sau để tải mẫu Remote Config đang hoạt động xuống ở định dạng JSON:

Trong thẻ Remote Config Tham số hoặc Điều kiện , hãy mở Trình đơn rồi chọn Tải tệp cấu hình hiện tại xuống.
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 xuất bản 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 theo 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, hãy nhớ xoá mọi điều kiện dành riêng cho ứng dụng trước.

Xuất bản mẫu Remote Config

Sau khi tải 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 mẫu đó, bạn có thể xuất bản mẫu đó cho 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 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à xuất bản tệp đó, thì tham số đó sẽ bị xoá khỏi máy chủ và không còn dùng được cho ứng dụng nữa.

Sau khi xuất bản, các thay đổi đối với tham số và giá trị sẽ có hiệu lực ngay lập tức đối với ứng dụng và người dùng. Nếu cần, bạn có thể khôi phục về phiên bản trước.

Sử dụng các lệnh sau để xuất bản mẫu:

Trong 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.
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 xuất bản, sau đó nhấp vào Chọn.
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 để cấu hình có hiệu lực ngay lập tức đối với ứng dụng và người dùng.

Các bước tiếp theo

Tìm hiểu thêm về cách sử dụng Remote Config trong môi trường máy chủ.
Dùng thử phía máy chủ Remote Config với Cloud Functions và Vertex AI.

Tạo phiên bản và mẫu Cấu hình từ xa Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.