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.
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).
Cái gì để ở đâu
| Loại | Ở đâu | Làm mới |
|---|---|---|
| Giá trị mặc định của code | Trong bản build | Khô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 / ConfigMap | Khi khởi động, một số khi đang chạy |
| Feature flag và kill switch | Kho cấu hình hoặc dịch vụ flag | Vài giây |
| Secret (mật khẩu, key) | Secrets manager (Key Vault, Secrets Manager, Vault) | Xoay vòng, TTL ngắn |
Ví dụ
@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
| Được | Mấ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án | Mộ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ành | Có 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.