Profile Groups & Patterns: Quản Trị Cấu Hình Môi Trường

TL;DR: Profile groups gom nhiều profile con vào một nhãn logic duy nhất: ví dụ kích hoạt nhóm production sẽ tự động mở rộng thành prod, prod-db, prod-cache và prod-tracing. Cấu hình multi-document YAML cho phép định nghĩa nhiều môi trường trong một file bằng cú pháp phân tách --- và on-profile. Trên môi trường production, cần áp dụng ba nguyên tắc then chốt: không commit mật khẩu, xác thực profile hợp lệ tại thời điểm startup, và điều phối cấu hình canary thông qua biến môi trường Pod.

Profile groups giải quyết bài toán kích hoạt phức tạp như thế nào?

Khi hệ thống microservice phát triển, mỗi môi trường thường đòi hỏi nhiều profile kỹ thuật độc lập như cơ sở dữ liệu, caching, tracing và monitoring. Nếu không dùng group, câu lệnh khởi động sẽ rất dài:

# Anti-pattern: Verbose profile chain in deployment script
SPRING_PROFILES_ACTIVE=prod,prod-db,prod-cache,prod-tracing,prod-monitoring

Cách làm thủ công này rất dễ dẫn đến sai sót: kỹ sư có thể quên mất profile tracing khiến hệ thống mất khả năng giám sát, hoặc khi bổ sung profile mới phải sửa lại toàn bộ script CI/CD.

Spring Boot 2.4+ giới thiệu tính năng Profile Groups giúp gom nhóm các profile con:

# application.yml: Define environment groups
spring:
  profiles:
    group:
      production:
        - prod
        - prod-db
        - prod-cache
        - prod-tracing
      staging:
        - staging
        - staging-db
        - staging-cache

Lúc này, câu lệnh khởi động trở nên ngắn gọn và an toàn:

# Activate entire group with a single logical name
java -jar app.jar --spring.profiles.active=production

Mỗi phân vùng kỹ thuật có thể tách thành các file cấu hình độc lập (application-prod-db.yml, application-prod-cache.yml), giúp việc đọc hiểu và review pull request trở nên rõ ràng hơn.

Cơ chế hoạt động của multi-document YAML có điểm gì đặc biệt?

Thay vì tạo nhiều file riêng biệt, Spring Boot hỗ trợ gom nhiều khối tài liệu vào cùng một file application.yml bằng ký tự phân tách ---:

# Base configuration applied to all environments
spring:
  application:
    name: order-service
  datasource:
    hikari:
      maximum-pool-size: 10

---
# Development overrides
spring:
  config:
    activate:
      on-profile: dev
  datasource:
    url: jdbc:postgresql://localhost:5432/dev
  logging:
    level:
      com.olhub: DEBUG

---
# Production overrides
spring:
  config:
    activate:
      on-profile: prod
  datasource:
    url: <code>{'${PROD_DB_URL}'}</code>
    hikari:
      maximum-pool-size: 50
  logging:
    level:
      com.olhub: INFO

Quy trình hợp nhất cấu hình của Spring Boot diễn ra như sau:

1. Tài liệu đầu tiên không chứa on-profile đóng vai trò là giá trị mặc định cho toàn bộ ứng dụng.
2. Với mỗi khối tài liệu phía sau, container kiểm tra điều kiện on-profile. Nếu khớp, nội dung sẽ được hòa trộn vào cấu hình gốc.
3. Thứ tự ưu tiên tuân theo vị trí xuất hiện: khối tài liệu nằm sau sẽ ghi đè giá trị của khối tài liệu nằm trước.

Làm thế nào để mô phỏng kế thừa cấu hình giữa các môi trường?

Spring Boot không cung cấp cơ chế kế thừa trực tiếp dạng class. Bạn có thể mô phỏng mối quan hệ phụ thuộc thông qua hai kỹ thuật:

Cách thứ nhất là dựa vào thứ tự kích hoạt profile. Các profile khai báo sau trong chuỗi sẽ ghi đè thuộc tính của các profile phía trước:

# Override values in cascade order
SPRING_PROFILES_ACTIVE=prod-base,prod,prod-canary

Cách thứ hai là sử dụng chỉ thị spring.profiles.include bên trong file cấu hình con để tự động kéo theo các profile nền tảng:

# application-prod.yml: Explicitly include shared base profiles
spring:
  profiles:
    include:
      - prod-base
      - prod-monitoring
  datasource:
    url: <code>{'${PROD_DB_URL}'}</code>

Sự khác biệt căn bản: group được định nghĩa tập trung ở file gốc application.yml và do người vận hành quyết định, trong khi include được thiết lập cố định bên trong file profile con bởi lập trình viên.

Những quy chuẩn an toàn nào bắt buộc phải áp dụng trên production?

Quản trị cấu hình production đòi hỏi ba nguyên tắc thiết kế phòng vệ:

1. Quản lý bí mật qua biến môi trường: Tuyệt đối không lưu mật khẩu hoặc token truy cập vào repository. Luôn dùng cú pháp placeholder bắt buộc để ứng dụng báo lỗi fail-fast nếu biến môi trường bị thiếu:

# application-prod.yml: Enforce external secret injection
spring:
  datasource:
    url: <code>{'${PROD_DB_URL}'}</code>
    username: <code>{'${PROD_DB_USER}'}</code>
    password: <code>{'${DB_PASSWORD}'}</code>

2. Xác thực cấu hình khởi động qua sự kiện: Tránh tình trạng gõ sai tên profile (prdo thay vì prod) khiến ứng dụng chạy ngầm với cấu hình rỗng. Ta bắt sự kiện ApplicationReadyEvent để kiểm tra tính hợp lệ:

@Component
public class StartupEnvironmentValidator {

    @EventListener(ApplicationReadyEvent.class)
    public void validateActiveProfiles(ApplicationReadyEvent event) {
        Environment env = event.getApplicationContext().getEnvironment();
        Profiles allowedProfiles = Profiles.of("dev", "test", "staging", "prod");

        if (!env.acceptsProfiles(allowedProfiles)) {
            throw new IllegalStateException(
                "Active profiles must match one of: dev, test, staging, prod"
            );
        }

        if (env.acceptsProfiles(Profiles.of("prod"))) {
            if (!StringUtils.hasText(env.getProperty("spring.datasource.url"))) {
                throw new IllegalStateException("Production requires spring.datasource.url");
            }
        }
    }
}

3. Điều phối cấu hình canary linh hoạt: Khi triển khai phiên bản canary, ta tận dụng profile group kết hợp ghi đè thông số Pod:

# Kubernetes Canary Pod manifest
spec:
  containers:
    - name: api
      env:
        - name: SPRING_PROFILES_ACTIVE
          value: "production,prod-canary"

Profile prod-canary được nạp sau cùng để tinh chỉnh các tham số thử nghiệm như tăng tỷ lệ lấy mẫu log tracing lên 100% mà không ảnh hưởng đến các Pod chính.

Spring Boot mở rộng danh sách profile group bên dưới ra sao?

Trước khi chốt đối tượng Environment, bộ xử lý nội bộ của Spring Boot đọc danh sách spring.profiles.active và đối chiếu với bản đồ spring.profiles.group.

Quá trình mở rộng có đặc điểm cộng dồn (additive):

• Tên group ban đầu (ví dụ: production) vẫn được giữ lại trong danh sách active profiles.
• Các profile thành viên (prod, prod-db, prod-cache) được nối tiếp vào danh sách.
• Spring Boot không mở rộng group theo dạng lồng nhau (transitive). Nếu bạn khai báo một group bên trong một group khác, tên đó sẽ bị xem là một chuỗi profile thông thường.

Tóm tắt

• Profile groups gom nhiều profile kỹ thuật thành một định danh logic, giảm thiểu sai sót khi cấu hình triển khai.
• Multi-document YAML dùng --- và on-profile để tích hợp nhiều môi trường vào một file duy nhất, sắp xếp độ ưu tiên từ trên xuống dưới.
• Mô phỏng kế thừa cấu hình bằng cách sắp xếp thứ tự chuỗi kích hoạt hoặc dùng chỉ thị spring.profiles.include.
• Áp dụng nguyên tắc fail-fast bằng cách xác thực tính hợp lệ của profile trong ApplicationReadyEvent.
• Cơ chế giải phóng group mang tính cộng dồn và không hỗ trợ mở rộng bắc cầu nhiều cấp.

Tự kiểm tra

Bài tiếp theo: Logging — SLF4J, levels, config