외부 구성 (External Configuration)

🔍 개요

• 설정은 코드 밖에서 관리한다. → 환경(DEV/PROD)·Secret 키 분리, 무중단 변경
• Spring Boot는 다양한 소스(CLI 인자, 환경변수, 파일 등)를 우선순위에 따라 병합하고, @Value/@ConfigurationProperties로 주입한다.
• 단일 값은 @Value, 여러 값/그룹은 @ConfigurationProperties를 권장.

---

📄 대표 구성 파일

• application.properties / application.yml (클래스패스 루트 또는 /config 폴더)
• 프로필별: application-dev.yml, application-prod.yml 등

# application.yml
server:
  port: 8081
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: app

---

📌 설정 우선순위 (Spring Boot 기준)

1. Command line arguments (--server.port=9000)
2. OS 환경변수 / SPRING_APPLICATION_JSON
3. application-{profile}.yml (외부 /config → 클래스패스)
4. application.yml (외부 /config → 클래스패스)
5. @PropertySource, @ConfigurationProperties

외부 /config 폴더가 클래스패스보다 우선순위가 높다.

---

🧰 적용 방식

(A) 단일 값 : @Value

@Value("${spring.datasource.url}")
private String dbUrl;

(B) 묶음 바인딩 : @ConfigurationProperties (권장)

// application.yml
app:
  storage:
    endpoint: https://s3.example.com
    bucket: media

@ConfigurationProperties(prefix = "app.storage")
public class StorageProps {
  private String endpoint;
  private String bucket;
  // getters/setters
}

✅ 이 방법은 여러 값을 묶어서 주입할 때 유용

---

🌐 환경별 설정

# application.properties
spring.profiles.active=dev

# application-dev.yml
logging:
  level:
    root: DEBUG
# application-prod.yml
logging:
  level:
    root: INFO

런타임에 --spring.profiles.active=prod 로도 전환 가능. 특정 빈을 환경별로 바꾸려면 @Profile("dev|prod") 사용.

---

🔗 관련

• auto-configuration - 조건(@Conditional*)과 속성으로 기본 빈 자동 등록
• DI - 구성된 값을 빈으로 주입해 결합도 ↓
• IoC - 컨테이너가 생성/주입/생명주기를 관리하는 기반 원리