Mẫu và phiên bản 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à các tập hợp các thông số và điều kiện 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 ứng dụng (client) mà từ đó ứng dụng của bạn tìm nạp giá trị và mẫu máy chủ mà từ đó ứng dụng 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 cách sử dụng bảng điều khiển của 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ẻ Thông 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ề một phiên bản ứng dụng cụ thể
• Xoá mẫu Cấu hình từ xa khỏi trang Nhật ký thay đổi

Có tổng giới hạn 300 phiên bản được lưu trữ trong thời gian hoạt động 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 phát hành 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 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 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 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 sẽ 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ạ, chứa siêu dữ liệu về phiên bản cụ thể đó.

Bạn có thể xoá mẫu Cấu hình từ xa khi cần trên trang Nhật ký thay đổi 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ủa mẫu Cấu hình từ xa.

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 đã lưu trữ của mẫu Cấu hình từ xa. Cách 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 đó, trên 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ở trang Nhật ký thay đổi 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 mọi phiên bản đã lưu trữ, bao gồm cả thời điểm cập nhật, người dùng đã tạo và cách tạo mẫu.

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 phiên bản cụ thể được lưu trữ của mẫu Cấu hình từ xa. Cách truy xuất phiên bản mẫu đã lưu trữ:

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 đó từ trình đơn bên phải.

3. Xem điểm khác biệt chi tiết về mẫu đang hoạt động và mọi phiên bản đã lưu trữ khác bằng cách di chuột qua trình đơn theo bối cảnh của mọi phiên bản chưa được chọn rồi chọn Compare with selected version (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ề bất kỳ phiên bản mẫu đã lưu trữ nào. 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 điều 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 ra một phiên bản được đánh số mới một cách hiệu quả. Ví dụ: việc khôi phục từ phiên bản 10 sang phiên bản 6 sẽ tạo ra bản sao mới của phiên bản 6 một cách hiệu quả, chỉ khác với 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 chưa hết hạn và phiên bản 11 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. Cách xoá mẫu Cấu hình từ xa:

1. Trên trang Thông số Cấu hình từ xa, hãy nhấp vào Nhật ký thay đổi.

1. Chuyển sang mẫu bạn muốn xoá, nhấp vào Lựa chọn khác, sau đó 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 và phát hành mẫu Cấu hình từ xa để tích hợp vào hệ thống xây dựng và kiểm soát nguồn, tự động cập nhật cấu hình, đồng thời đồ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 Cấu hình từ xa hiện đang hoạt động xuống từ bảng điều khiển của Firebase. Sau đó, bạn có thể cập nhật tệp JSON đã xuất rồi phát hành tệp đó lên cùng một dự án, hoặc phát hành tệp đó lên 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, chẳng hạn như môi trường phát triển, kiểm thử, chạy thử và phát hành chính thức. 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 lên môi trường phát hành chính thức bằng cách tải mẫu đó xuống từ dự án thử nghiệm rồi phát hành mẫu đó lên dự án phát hành chính thức.

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 sẵn các 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 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 cách sau để tải mẫu Cấu hình từ xa đang hoạt động xuống ở định dạng JSON:

1. Từ thẻ Thông số hoặc điều kiện cấu hình từ xa, hãy mở Trình đơn rồi 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 Download config file (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 Save (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. Xin lưu ý rằng bạn có thể nhập Người dùng trong điều kiện Tỷ lệ phần trăm ngẫu nhiên, nhưng mọi điều kiện không được hỗ trợ sẽ gây ra lỗi trong quá trình tải lên. Nếu bạn đang tìm cách xuất bản một mẫu ban đầu được xuất từ mộ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 Cấu hình từ xa

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

Sau khi phát hành, các thay đổi đối với tham số và giá trị sẽ xuất hiện ngay lập tức cho ứ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.

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

1. Từ thẻ Thông số hoặc điều kiện cấu hình từ xa, hãy 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 bạn muốn xuất bản, sau đó nhấp vào Chọn.
3. Tệp này sẽ được xác thực. 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ủa mình.

Các bước tiếp theo

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