Trang này được dịch bởi Cloud Translation API.

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 điều kiện và thông số được định dạng JSON 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 (từ đó ứng dụng của bạn tìm nạp các giá trị) và mẫu máy chủ (từ đó máy khách máy chủ có thể tìm nạp các giá trị).

Phần này thảo luận về các 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 sẽ hiển thị nội dung của mẫu ở định dạng đồ hoạ trong các thẻ Parameters (Tham số) và Conditions (Điều kiện).

Sau đây là ví dụ về một tệp mẫu phía 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ả 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

Tổng cộng có giới hạn là 300 phiên bản được lưu trữ trong suốt thời gian tồn tại cho mỗi loại mẫu (300 mẫu phía máy khách và 300 mẫu phía máy chủ), bao gồm cả số phiên bản được lưu trữ cho các mẫu đã bị 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 thời gian tồn tạ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 các 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 khi cần. Số phiên bản được tăng tuần tự từ giá trị ban đầu do Remote Config lưu trữ. Tất cả các mẫu đều có một 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 Nhật ký thay đổitrê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ả 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 của mẫu Remote Config. Để thực hiện việc này:

Trên bảng điều khiển Firebase, hãy mở Remote Config.
Sau đó, trong thẻ Thông 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. Trang này liệt kê tất cả các phiên bản mẫu đã lưu 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 cả 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 cụ thể nào đã lưu trữ của mẫu Remote Config. Cách truy xuất một phiên bản mẫu đã lưu trữ:

Mở ngăn 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 bản so sánh chi tiế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 của bất kỳ phiên bản nào chưa đượ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ề bất kỳ phiên bản nào đã lưu 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 nếu bạn chắc chắn muốn quay lại phiên bản đó và sử dụng những 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 ra một phiên bản được đánh số mới. Ví dụ: việc quay lại từ phiên bản 10 về phiên bản 6 sẽ tạo ra 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 ban đầu vẫn được lưu trữ (giả sử chưa hết hạn) và phiên bản 11 sẽ 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 Thông số, hãy nhấp vào Nhật ký thay đổi.

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á.
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 các mẫu Remote Config để tích hợp chúng vào hệ thống kiểm soát nguồn và hệ thống xây dựng, tự động hoá các bản cập nhật cấu hình, đồng thời giữ cho các thông số và giá trị luôn đồng bộ trên nhiều dự án.

Bạn có thể tải mẫu Remote Config hiện đang hoạt độngtừ 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 đó vào cùng một dự án hoặc xuất bản tệp đó vào 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 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ử, dàn dựng 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 dàn dựng sang 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 đó sang 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 thông 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 thử nghiệm A/B Testing sẽ 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 Remote Config mẫu Cấu hình 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 nội dung sau để tải mẫu Remote Config đang hoạt động xuống ở định dạng JSON:

Trong thẻ Remote Config Parameters or Conditions (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, rồi nhấp vào Lưu.

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

Các mẫu máy chủ sẽ đượ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 các đ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 được xuất ban đầu 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ộ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ể xuất bản nội dung đó lên một dự án.

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

Sau khi xuất bản, các thay đổi đối với thông 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 của bạn. Nếu cần, bạn có thể khôi phục về một phiên bản trước.

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

Trong thẻ Remote ConfigTham số hoặc Điều kiện, hãy mở Trình đơn rồi chọn Xuất bản từ mộ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, rồi nhấp vào Chọn.
Tệp này sẽ được xác thực và nếu thành công, bạn có thể nhấp vào Phát hành để cung cấp ngay cấu hình cho các ứng dụng và người dùng của bạn.

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ủ.
Hãy thử Remote Config phía máy chủ bằng 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.