Đi tới nội dung chính
System Design Lab
Microservice Patterns

External Configuration Store

Đưa cấu hình, feature flag và secret ra khỏi bản build, vào một kho trung tâm mà ứng dụng đọc khi chạy — để một image chạy được ở mọi nơi và một cấu hình sai được sửa trong vài giây, không cần deploy lại.

Cơ bản 4 phút đọc· Cập nhật 2026-11-18

Sau bài này bạn sẽ

  • Tách cấu hình khỏi code và khỏi bản build.
  • Làm mới cấu hình khi đang chạy một cách an toàn.
  • Đối xử với secret khác với cấu hình thông thường.
  • Lên kế hoạch cho lúc kho cấu hình không khả dụng.

Tổng quan

Một chuỗi nhà hàng in thực đơn ở từng chi nhánh. Sai một giá là chi nhánh nào cũng phải in lại. Với bảng thực đơn điện tử lấy dữ liệu từ văn phòng chính, một lần sửa là chỉ trong một phút mọi nơi đều thấy.

Khi cấu hình được đóng gói trong image (application.yml trong JAR, giá trị trong container), đổi nó nghĩa là build mới và deploy lại, và môi trường nào cũng cần một bản build riêng. Kho cấu hình bên ngoài (Spring Cloud Config, Azure App Configuration, AWS AppConfig, Consul, Kubernetes ConfigMap) giữ cấu hình theo từng môi trường; cùng một image đọc chúng khi khởi động và làm mới trong lúc chạy. Secret thì vào một secrets manager chuyên dụng.

Chạy thử

Một cấu hình nhà cung cấp thanh toán sai được ship lúc t = 10 s. So sánh thanh toán còn lỗi bao lâu khi cách sửa cần build lại và rolling redeploy (A), và khi giá trị được trả lại ngay trong kho (B).

Đang tải mô phỏng…

Cái gì để ở đâu

LoạiỞ đâuLàm mới
Giá trị mặc định của codeTrong bản buildKhông bao giờ lúc đang chạy
Cấu hình môi trường (URL, kích thước pool)Kho cấu hình / ConfigMapKhi khởi động, một số khi đang chạy
Feature flag và kill switchKho cấu hình hoặc dịch vụ flagVài giây
Secret (mật khẩu, key)Secrets manager (Key Vault, Secrets Manager, Vault)Xoay vòng, TTL ngắn

Ví dụ

Spring Boot: cấu hình có kiểu, làm mới được, có giá trị mặc định an toàn
@ConfigurationProperties("payments")
@RefreshScope                                   // được bind lại khi kho cấu hình phát thay đổi
public record PaymentSettings(URI providerUrl, Duration timeout, boolean newCheckoutEnabled) {}

// application.yml trong image chỉ chứa giá trị mặc định; kho ghi đè theo từng môi trường:
// spring.config.import: optional:configserver:http://config:8888
// Giá trị được kiểm tra khi nạp — URL sai bị từ chối thay vì âm thầm được áp dụng.

Đánh đổi

ĐượcMất
Tốc độĐổi hành vi trong vài giây, không cần build hay deploy.Thay đổi bỏ qua quy trình review code và test, trừ khi bạn làm một quy trình riêng cho cấu hình.
Nhất quánMột bản build cho mọi môi trường; một nguồn sự thật.Làm mới khi đang chạy phải an toàn — không phải cấu hình nào cũng đổi nóng được.
Vận hànhCó lịch sử ai đổi gì và lúc nào.Thêm một service sống còn phải bảo mật và giữ khả dụng.

Lưu ý khi chạy production

  • Đặt version cho cấu hình và review thay đổi như code (GitOps hoặc quy trình phê duyệt).
  • Kiểm tra giá trị khi nạp và từ chối thay đổi không qua được kiểm tra.
  • Tung flag rủi ro dần dần (theo tenant hoặc phần trăm) và luôn giữ kill switch.
  • Đừng bao giờ ghi log secret; tham chiếu chúng bằng tên trong cấu hình và lấy về khi chạy.

Đọc thêm

Bài liên quan