Mẫu và phiên bản Cấu hình từ xa

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. Remote Config sắp xếp các cấu hình thành mẫu có thể được tạo, cập nhật, kiểm soát phiên bản và khôi phục.

Tuỳ thuộc vào cấu trúc của bạn, bạn có thể tạo và quản lý mẫu phía máy khách, mẫu phía máy chủ hoặc cả hai:

  • Mẫu ứng dụng: Phân phát cấu hình cho các thực thể ứng dụng trên nền tảng Apple, Android, Web, Flutter, Unity và C++. Mẫu phía máy khách hỗ trợ các điều kiện dựa trên đối tượng Google Analytics, phiên bản ứng dụng, nền tảng, ngôn ngữ thiết bị, quốc gia, phân vị người dùng và tín hiệu tuỳ chỉnh.

  • Mẫu máy chủ: Phân phát cấu hình cho các môi trường phụ trợ như Cloud Run, Cloud Functions for Firebase hoặc các máy chủ chứa bằng cách sử dụng Firebase Admin SDK cho Node.js, Python, Go và Java. Mẫu phía máy chủ đánh giá các thông số phía máy chủ với độ trễ gần như bằng 0 bằng cách sử dụng các tín hiệu tuỳ chỉnh phía máy chủ và các lần triển khai tỷ lệ phần trăm ngẫu nhiên.

So sánh mẫu phía máy khách và mẫu phía máy chủ

Các mẫu máy khách và máy chủ được duy trì độc lập trong dự án Firebase của bạn. Hãy tham khảo bảng sau đây để tìm hiểu sự khác biệt giữa mẫu phía máy khách và mẫu phía máy chủ:

Tính năng Mẫu khách hàng Mẫu máy chủ
Môi trường mục tiêu Ứng dụng khách (Apple, Android, Web, Flutter, Unity, C++) Môi trường máy chủ (Cloud Run, Cloud Functions for Firebase, GKE, dịch vụ phụ trợ)
Các SDK được hỗ trợ Firebase SDK cho ứng dụng Firebase Admin SDK (Node.js, Python, Go, Java)
Công cụ quản lý Bảng điều khiển Firebase, CLI Firebase, API REST, Firebase Admin SDK Firebase bảng điều khiển
Vị trí của bảng điều khiển Tham số và Điều kiện Tham số và Điều kiện
Tải mẫu mặc định xuống Được hỗ trợ (XML cho Android, PLIST cho iOS, JSON cho Web) Không áp dụng (các giá trị mặc định được xác định trong mã máy chủ hoặc phần phụ trợ)
Hướng dẫn chi tiết Quản lý mẫu khách hàng Quản lý mẫu máy chủ

Vòng đời và việc quản lý phiên bản của mẫu

Cho dù bạn làm việc với mẫu phía máy khách hay mẫu phía máy chủ, Remote Configđều cung cấp tính năng quản lý phiên bản và quản lý vòng đời tích hợp sẵn:

Tạo và theo dõi phiên bản

Mỗi khi bạn cập nhật các thông số hoặc điều kiện, 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 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 chứa siêu dữ liệu về phiên bản cụ thể đó, chẳng hạn như:

  • versionNumber: Số phiên bản tuần tự của mẫu.
  • updateTime: Dấu thời gian khi mẫu được xuất bản.
  • updateUser: Email hoặc danh tính của người dùng đã thực hiện nội dung cập nhật.
  • updateOrigin: Cách thực hiện thay đổi (ví dụ: CONSOLE, REST_API hoặc ADMIN_SDK_NODE).
  • updateType: Bản chất của thay đổi (ví dụ: INCREMENTAL_UPDATE hoặc FORCED_UPDATE).

Hạn mức và thời gian lưu giữ phiên bản

Tổng cộng có giới hạn là 300 phiên bản được lưu trữ trong suốt vòng đời cho mỗi loại mẫu (300 mẫu máy khách 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 đã 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 đó.

Quay lại

Bạn có thể quay lại bất kỳ phiên bản nào đã lưu trữ của một mẫu bất cứ lúc nào. Khi bạn khôi phục, Remote Config sẽ tạo một phiên bản mới có nội dung khớp với phiên bản cũ đã chọn. Ví dụ: việc quay lại từ phiên bản 10 về phiên bản 6 sẽ tạo ra phiên bản 11 với cấu hình của phiên bản 6.

Nhập và xuất

Bạn có thể tải mẫu đang hoạt động xuống dưới dạng tệp JSON và xuất bản mẫu đó vào cùng một dự án hoặc một dự án khác. Tính năng này cho phép bạn:

  • Lưu trữ các định nghĩa mẫu trong hệ thống kiểm soát nguồn (chẳng hạn như Git).
  • Tích hợp việc triển khai cấu hình vào quy trình CI/CD.
  • Chuyển cấu hình qua các giai đoạn (ví dụ: từ dự án phát triển hoặc dự án dàn dựng sang dự án phát hành công khai).
  • Di chuyển cấu hình giữa các dự án.

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.

Giá trị mặc định của mẫu

Đối với các ứng dụng khách, bạn có thể tải các tệp chứa giá trị mặc định của tham số xuống ở định dạng XML, PLIST hoặc JSON để đi kèm với ứng dụng của mình. Để biết hướng dẫn, hãy xem phần Tải giá trị mặc định của mẫu Remote Config xuống.

Các bước tiếp theo