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

Mẫu ứng dụng Mẫu máy chủ

Mẫu Cấu hình từ xa là tập hợp các mẫu 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 ứng dụng mà từ đó ứng dụng của bạn tìm nạp các giá trị và server mẫu mà từ đó máy khách của 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ề mẫu, nhấp vào Mẫu ứng dụng.

Bạn sửa đổi và quản lý mẫu bằng cách sử dụng bảng điều khiển của Firebase, bảng điều khiển này hiển thị nội dung của mẫu ở định dạng đồ hoạ trong 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 bằng bảng điều khiển của Firebase:

• 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ề phiên bản ứng dụng cụ thể
• Xoá mẫu Cấu hình từ xa trong phần Thay đổi nhật ký trang

Mỗi loại mẫu được lưu trữ có tổng cộng tối đa 300 phiên bản được lưu trữ trong suốt thời gian hoạt động (300 mẫu ứng dụng khách và 300 mẫu máy chủ), bao gồm các mẫu được lưu trữ số phiên bản cho 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 tồn tại 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 lần bạn cập nhật thông số, Cấu hình từ xa sẽ tạo một mẫu Cấu hình từ xa có phiên bản mới 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 tuần tự từ giá trị ban đầu được Cấu hình từ xa 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á mẫu Cấu hình từ xa khi cần trong Nhật ký thay đổi trang trên bảng điều khiển Cấu hình từ xa.

Quản lý phiên bản mẫu Cấu hình từ xa

Phần này mô tả cách quản lý các phiên bản Cấu hình từ xa của bạn mẫu.

Liệt kê tất cả phiên bản đã lưu trữ của mẫu Cấu hình từ xa

Bạn có thể truy xuất danh sách tất cả phiên bản được lưu trữ của mẫu Cấu hình từ xa. Để thực hiện việc này:

1. Trong bảng điều khiển của Firebase, hãy mở Cấu hình từ xa.

2. Sau đó, từ Tham số , chọn "đồng hồ" biểu tượng 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 Cấu hình từ xa

Bạn có thể truy xuất mọi dữ liệu cụ thể đã lưu trữ phiên bản của mẫu Cấu hình từ xa. 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 đó ở bên phải .

3. Xem điểm khác biệt chi tiết về mẫu đang hoạt động và bất kỳ phiên bản nào khác được lưu trữ bằng di chuột lên trình đơn theo bối cảnh để xem phiên bản 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ề phiên bản cụ thể được lưu trữ của mẫu Cấu hình từ xa

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

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

Xoá mẫu Cấu hình từ xa

Bạn có thể xoá mẫu Cấu hình từ xa khỏi bảng điều khiển của Firebase. Người nhận xoá mẫu Cấu hình từ xa:

1. Trong Cấu hình từ xa Tham số trang, nhấp vào 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 xuống và xuất bản mẫu Cấu hình từ xa

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

Bạn có thể tải mẫu Cấu hình từ xa đang hoạt động xuống trong bảng điều khiển của Firebase. Sau đó, bạn có thể cập nhật đã xuất tệp JSON lên và xuất bản tệp đó lên cùng dự án, hoặc xuất bản lên một tệp mới hoặc dự án 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 cụ thể dưới dạng biến thể trong một Thử nghiệm Thử nghiệm A/B không được đưa vào các mẫu đã xuất.

Cách xuất và nhập mẫu Cấu hình từ xa:

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

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

Sử dụng tính năng sau để tải mẫu Cấu hình từ xa đang hoạt động xuống trong Định dạng JSON:

1. Từ Thông số hoặc điều kiện Cấu hình từ xa tab, mở Trình đơn và chọn 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, rồi chọn vị trí nơi 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 của Firebase. Lưu ý rằng Người dùng trong điều kiện Tỷ lệ phần trăm ngẫu nhiên có thể là đã được nhập, 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ố xuất bản mẫu ban đầu được xuất từ trước khi xoá mọi điều kiện dành riêng cho ứng dụng khách.

Xuất bản mẫu Cấu hình từ xa

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 xuất bản, các thay đổi đối với thông số và giá trị sẽ xuất hiện 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ể quay lại phiên bản trước đó.

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

1. Từ Thông số hoặc điều kiện Cấu hình từ xa tab, 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 Tệp Cấu hình từ xa mà bạn muốn xuất bản, 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

• Tìm hiểu thêm về bằng cách sử dụng Cấu hình từ xa trong môi trường máy chủ.
• Thử Cấu hình từ xa phía máy chủ với Cloud Functions và Vertex AI.