[스프링 핵심 원리와 활용] 섹션7. 외부 설정 - OS 환경 변수

[724thomas]

스프링 부트 외부 설정과 프로필 - 신입 개발자 노트

---

1. 외부 설정이란?

💡 개념

• 애플리케이션 실행 시, 외부에서 설정값을 주입하는 방식
• 내부 코드 수정 없이 운영 환경에 따라 유연하게 설정할 수 있음

💬 예시

• 포트 번호, DB 주소, 로그 레벨 등

---

2. application.properties vs application.yml

항목	공통점	차이점
사용 목적	외부 설정을 정의	문법 구조
yml 장점	계층 표현에 유리	들여쓰기 중요
properties 장점	간결하고 널리 사용됨	key=value 형태

---

3. 외부 설정 우선순위

📌 중요

스프링 부트는 여러 설정 위치를 인식하고 우선순위에 따라 적용함.

우선순위 높은 순서:

1. 커맨드 라인 인자 (--server.port=8081)
2. application.properties / application.yml (src/main/resources)
3. application-{profile}.yml
4. 외부 설정 파일 (--spring.config.location)
5. OS 환경 변수
6. JVM 시스템 속성

---

4. @value 사용법

🎯 특정 설정 값을 주입받고 싶을 때 사용

@Value("${server.port}")
private int port;

• ${} 안에 있는 키를 기반으로 값을 읽어옴
• 타입에 맞춰 자동 변환됨

---

5. @ConfigurationProperties 사용법

✅ 여러 설정 값을 객체 단위로 주입할 수 있음

@ConfigurationProperties(prefix = "my.config")
public class MyConfigProperties {
    private String name;
    private int timeout;
}

• yml 구조를 그대로 객체로 바인딩 가능
• @EnableConfigurationProperties 또는 @Component 필요

---

6. 스프링 프로필

🌱 개념

• 같은 코드로 다른 설정을 적용하고 싶을 때 사용
• 예: dev, test, prod 환경별 DB 설정 분리

---

7. 프로필 적용 방법

방법 1: 설정 파일로 구분

• application-dev.yml, application-prod.yml

방법 2: 실행 시 지정

--spring.profiles.active=dev

방법 3: @Profile 사용

@Profile("dev")
@Bean
public DataSource devDataSource() {
    return new H2DataSource();
}

---

8. 프로필 병합 & 기본 프로필

• 다중 프로필 지정 가능: --spring.profiles.active=dev,debug
• 기본 프로필: default
• 지정된 프로필이 없으면 default가 사용됨

---

9. 정리

항목	요약
외부 설정	application.yml 또는 properties 등 다양한 위치에서 설정 주입 가능
우선순위	명령줄 인자가 가장 높음
@value	단일 설정값 주입
@ConfigurationProperties	객체 형태로 주입
프로필	설정을 환경(dev/prod)에 따라 나눔
@Profile	Bean 조건 등록에 활용 가능

---