[스프링 핵심 원리와 활용] 섹션8. 외부 설정과 프로필

[724thomas]

1. 외부 설정

• 하나의 애플리케이션을 여러 환경(개발/운영)에서 사용할 때 환경마다 다른 값을 적용해야 함
• 빌드를 환경별로 나누는 대신, 빌드는 1번만 하고 실행 시점에 외부에서 설정 주입
• 변하는 값(환경별 설정)과 변하지 않는 값(코드, 빌드 결과물)을 분리

2. 외부 설정 방법 4가지

• OS 환경 변수
  OS 전체에서 접근 가능 (System.getenv())
• 자바 시스템 속성
  JVM 내부에서 접근 가능 (System.getProperty(key))
  실행 시 -Dkey=value로 전달
• 커맨드 라인 인수
  main(String[] args)로 전달 (직접 파싱 필요)
• 설정 데이터(외부 파일)
  application.properties 또는 application.yml
  파일 내용으로 다수의 설정값 관리

3. 커멘드 라인 옵션 인수

java -jar app.jar --url=devdb --username=dev_user

4. 스프링 외부 설정 통합

• ENvironment 인터페이스
  외부 설정을 일관되게 읽을 수 있도록 추상화
  OS 환경 변수, 시스템 속성, 커맨드 라인, 설정 파일 등 모두 environment.getProperty(key)로 조회 가능
• PropertySource
  외부 설정을 읽는 각 구현체 (SystemEnvironmentPropertySource, CommandLinePropertySource 등)

5. 설정 파일

• application.properties / application.yml 자동 인식
• 외부 파일: 서버별로 다른 파일을 배포
• 내부 파일 분리: application-dev.properties, application-prod.properties를 JAR 안에 포함하고 프로필로 구분

6. 프로필

• 실행시 특정 환경 설정만 활성화
• application.properties에서 설정: spring.profiles.active=dev
• 실행 시 옵션: java -jar app.jar --spring.profiles.active=prod
• 규칙: application-{profile}.properties

7. 외부 설정을 읽는 방법

• Environment 직접 사용
  String url = env.getProperty("my.datasource.url");
• @value: 기본값 지정 가능 @value("${key:default}")
  @value("${my.datasource.url}")
  private String url;
• @ConfigurationProperties: 객체로 바인딩하여 타입 안정성 확보, 생성자 바인딩을 사용하여 불변성 보장
  @ConfigurationProperties("my.datasource")
  public class MyDataSourceProperties { ... }

8. 설정 검증

• spring-boot-starter-validation 의존성 추가 후 자바 빈 검증기 활용
  @notempty
  private String url;

@min(1) @max(999)
private int maxConnection;

• 잘못된 값이 들어오면 애플리케이션 시작 시 예외 발생 → 빠른 문제 인지 가능

9. 우선순위

• 범위 좁고, 유연성이 높은 설정이 우선

1. 커맨드 라인 옵션 인수 (--key=value)
2. 자바 시스템 속성 (-Dkey=value)
3. OS 환경 변수
4. 설정 파일