Quản lý mẫu và phiên bản máy chủ Cấu hình từ xa

Chọn loại mẫu: Mẫu phía máy khách Mẫu phía máy chủ


Mẫu Remote Config là tập hợp các tham số và điều kiện ở định dạng JSON được tạo cho dự án Firebase của bạn. Mẫu máy chủ cung cấp cấu hình cho các phiên bản máy chủ bằng cách sử dụng Firebase Admin SDK cho Remote Config (có sẵn cho Node.js, Java, Python và Go).

Bạn có thể sử dụng bảng điều khiển Firebase để sửa đổi và quản lý mẫu phía máy chủ. Chuyển đến DevOps & Engagement (DevOps và Mức độ gắn bó) > Cấu hình từ xa để xem nội dung của mẫu ở định dạng đồ hoạ trên Parameters page (trang Tham số) và Conditions page (trang Điều kiện).

Sau đây là ví dụ về 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-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "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 trong bảng điều khiển Firebase (chuyển đến DevOps & Engagement (DevOps và Mức độ tương tác) > Remote Config (Cấu hình từ xa)):

  • Liệt kê tất 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 máy chủ cụ thể
  • Xoá Remote Config mẫu khỏi trang Nhật ký thay đổi.

Mỗi loại mẫu có tổng giới hạn là 300 phiên bản được lưu trữ trong suốt thời gian hoạt động (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 phiên bản mẫu cho mỗi loại mẫu trong suốt thời gian hoạt động 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 lần 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 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 nếu cần trên trang DevOps & Engagement (DevOps và Mức độ gắn bó) > Cấu hình từ xa > Nhật ký thay đổi của bảng điều khiển Firebase.

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 Remote Config mẫu máy chủ.

Liệt kê tất 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. Để thực hiện việc này:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang DevOps & Engagement (DevOps và Mức độ tương tác) > Remote Config (Cấu hình từ xa) > Parameters (Tham số).

  2. Chọn biểu tượng "đồng hồ" ở trên cùng bên phải.

    Thao tác này sẽ mở trang Nhật ký thay đổi, trong đó liệt kê tất cả cá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ả các phiên bản được 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 cụ thể nào được lưu trữ của mẫu Remote Config. Sau đây là cách truy xuất phiên bản mẫu đã lưu trữ:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang DevOps & Engagement (DevOps và mức độ tương tác) > Remote Config (Cấu hình từ xa) > Change history (Nhật ký thay đổi).

  2. Theo mặc định, trang này sẽ hiển thị mẫu đang hoạt động. Để xem một phiên bản khác, hãy chọn phiên bản đó trong ngăn chi tiết ở bên phải.

  3. Xem sự khác biệt chi tiết giữa mẫu đang hoạt động và bất kỳ phiên bản nào 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. Sau đây là cách khôi phục mẫu:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang DevOps & Engagement (DevOps và mức độ tương tác) > Remote Config (Cấu hình từ xa) > Change history (Nhật ký thay đổi).

  2. Tìm nút tuỳ chọn ở trên cùng bên phải của trang để xem các phiên bản mẫu trước đó đủ điều kiện khôi phục.

  3. Chỉ nhấp và xác nhận 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 ra 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 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 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ẫu Remote Config

Bạn có thể xoá các mẫu Remote Config bằng bảng điều khiển Firebase. Sau đây là cách xoá mẫu:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang DevOps & Engagement (DevOps và Mức độ tương tác) > Remote Config (Cấu hình từ xa) > Parameters (Tham số).

  2. Nhấp vào Nhật ký thay đổi.

  3. Chuyển đến mẫu bạn muốn xoá, nhấp vào biểu tượng Thêm, sau đó chọn Xoá.

  4. Khi được nhắc xác nhận 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á việc cập nhật cấu hình, cũng như đồng bộ hoá các tham số và giá trị trên nhiều dự án.

Bạn có thể tải mẫu Remote Config đ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 đó lên cùng một dự án hoặc xuất bản tệp đó lên một dự án mới hoặc hiện có.

Ví dụ: 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à môi trường thực tế. 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 thực tế bằng cách tải mẫu đó xuống từ dự án thử nghiệm rồi xuất bản mẫu đó lên dự án thực 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 các 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 sẽ không được đưa vào mẫu đã xuất.

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

  1. Tải mẫu 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 Remote Config hiện tại xuống

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

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang DevOps & Engagement (DevOps và mức độ gắn bó) > Cấu hình từ xa > Parameters or Conditions (Tham số hoặc điều kiện).

  2. Mở Trình đơn rồi chọn Tải tệp cấu hình hiện tại xuống.

  3. 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 Remote Config

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. Bạn có thể nhập các điều kiện sử dụng quy tắc 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ột mẫu của khách hàng, hãy nhớ xoá mọi điều kiện dành riêng cho khách hà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ể phát hành mẫu đó cho một dự án.

Khi bạn xuất bản một mẫu, toàn bộ mẫu cấu hình hiện có sẽ được thay thế bằng tệp đã cập nhật và phiên bản mẫu sẽ tăng 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 được cung cấp 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ẽ ngay lập tức có hiệu lự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ề phiên bản trước đó.

Hãy làm theo các bước sau để xuất bản mẫu:

  1. Trong bảng điều khiển Firebase, hãy chuyển đến trang DevOps & Engagement (DevOps và mức độ gắn bó) > Cấu hình từ xa > Parameters or Conditions (Tham số hoặc điều kiện).

  2. Mở Trình đơn, rồi chọn Xuất bản từ một tệp.

  3. 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.

  4. Tệp đã được xác thực. Nếu quá trình xác thực thành công, hãy 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ủa bạn.

Các bước tiếp theo