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, tạo phiên bản và khôi phục.

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

  • Mẫu ứng dụng: Cung cấp cấu hình cho các phiên bản ứng dụng khách trên các nền tảng Apple, Android, Web, Flutter, Unity và C++. Mẫu ứng dụng 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ủ: Cung cấp cấu hình cho các môi trường phụ trợ như Cloud Run, Cloud Functions for Firebase hoặc máy chủ trong vùng chứa bằng cách sử dụng Firebase Admin SDK cho Node.js, Python, Go và Java. Mẫu máy chủ đánh giá các tham số phía máy chủ với độ trễ gần như bằng không bằng cách sử dụng tín hiệu tuỳ chỉnh của máy chủ và triển khai theo tỷ lệ phần trăm ngẫu nhiên.

So sánh mẫu ứng dụng và mẫu máy chủ

Mẫu ứng dụng và mẫu 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 phía 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ợ)
SDK được hỗ trợ Firebase client SDK Firebase Admin SDK (Node.js, Python, Go, Java)
Công cụ quản lý Bảng điều khiển Firebase, Firebase CLI, API REST, Firebase Admin SDK Firebase bảng điều khiển
Vị trí của máy chơi trò chơi 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 (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 phía máy chủ

Vòng đời và việc tạo phiên bản mẫu

Cho dù bạn làm việc với mẫu ứng dụng hay mẫu 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 lần bạn cập nhật tham 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 dần theo tuần tự từ giá trị ban đầu do Remote Config lưu trữ.

Tất 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).

Giới hạn và thời gian lưu giữ phiên bản

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

Khôi phục

Bạn có thể khôi phục về 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 trước đây đã chọn. Ví dụ: khi bạn khôi phục từ phiên bản 10 về phiên bản 6, phiên bản 11 sẽ được tạo 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à phát hành mẫu đó cho 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ữ đị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 các bản triển khai cấu hình vào quy trình CI/CD.
  • Quảng bá cấu hình qua các giai đoạn (ví dụ: từ dự án phát triển hoặc thử nghiệm sang dự án chính thức).
  • 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 A/B Testing thử nghiệm sẽ không được đưa vào mẫu đã xuất.

Mẫu mặc định

Đối với ứ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ố ở định dạng XML, PLIST hoặc JSON xuống để đóng gói cùng với ứng dụng. Để biết hướng dẫn, hãy xem bài viết Tải giá trị mặc định của mẫu Remote Config xuống.

Các bước tiếp theo