<div id="readability-page-1" class="page">
                
                



<nav id="global-navigation">


</nav>
<main id="wrap" aria-hidden="false">

<div>



                
                    



<article>
<header id="global-header">



<div>
<h2>Spring 설정파일 우선순위</h2>
<ul>
<li role="text" aria-label="2023년 04월 11일 22시 46분에 작성된 글."><time datetime="2023-04-11T22:46">2023.04.11 22:46</time></li>
<li><a href="/category/Spring" aria-label="Spring">Spring</a></li>
</ul>
</div>


</header>
<div id="article"><h2 data-ke-size="size26"><span>Application.yaml 설정 파일 실행시 우선순위</span></h2>
<figure data-ke-mobilestyle="widthOrigin" data-filename="Spring 설정 우선순위.png" data-origin-width="1080" data-origin-height="768"><span data-url="https://blog.kakaocdn.net/dn/P8uPS/btr9AZELuz8/ZYP3GnKQeMBqRpRY2jKBYk/img.png" data-lightbox="lightbox"><img src="https://blog.kakaocdn.net/dn/P8uPS/btr9AZELuz8/ZYP3GnKQeMBqRpRY2jKBYk/img.png" onerror="this.onerror=null; this.src='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png'; this.srcset='//t1.daumcdn.net/tistory_admin/static/images/no-image-v1.png';" data-filename="Spring 설정 우선순위.png" data-origin-width="1080" data-origin-height="768"></span></figure>


<p data-ke-size="size16">매번 까먹어서 한번 재대로 정리해봄<br>default 셋업 아래에 on-profile 설정되어있는데 안먹어서 왜 안먹나 했더니 application.yaml이 우선순위가 높아서 default 옵션을 무시하고 다른 옵션이 들어가버려서 안되길래 도대체 어떤식으로 해결해야하는지 확인해봤다.<br>이경우에는 application.yaml에 profile이 있으면 됨 혹은 아예 파일이 따로 존재한다던지 여러가지 방법이 존재하니 참고<br>Application.yaml은 다음과 같은 우선순위를 가지게된다.</p>
<pre data-ke-language="bash"><code>1.  [Application properties](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files) packaged inside your jar (`application.properties` and YAML variants).

2.  [Profile-specific application properties](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files.profile-specific) packaged inside your jar (`application-{profile}.properties` and YAML variants).

3.  [Application properties](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files) outside of your packaged jar (`application.properties` and YAML variants).

4.  [Profile-specific application properties](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files.profile-specific) outside of your packaged jar (`application-{profile}.properties` and YAML variants).</code></pre>
<p data-ke-size="size16">내부 Jar이 먼저 우선시 (application.yaml) → 내부 Jar의 Profile이 다음 순위 (application-profile.yaml) → Jar 밖의 Application-yaml → Jar 외부의 Profile이 마지막 순위</p>
<h3 data-ke-size="size23"><b>1. 구체적인 내부 로직</b>은 다음과 같이 구성</h3>
<p data-ke-size="size16">Spring Boot는 애플리케이션이 시작될 때 다음 위치에서 application.properties 및 application.yaml 파일을 자동으로 우선순위를 매기게 됩니다.</p>
<ol data-ke-list-type="decimal">
<li>classpath 에서
<ol data-ke-list-type="decimal">
<li>classpath 루트</li>
<li>classpath /config 패키지</li>
</ol>
</li>
<li>현재 디렉토리에서
<ol data-ke-list-type="decimal">
<li>현재 디렉토리</li>
<li>현재 디렉터리의 config/하위 디렉터리</li>
<li>config/서브디렉토리의 바로 하위 디렉토리</li>
</ol>
</li>
</ol>
<h3 data-ke-size="size23"><b>2. Profile이 지정된 경우</b>에는 다음처럼 우선순위 구성</h3>
<p data-ke-size="size16">Spring Boot는 application.yaml만 처리하는게 아닌, application-{profile}규칙을 가진 파일도 프로파일별 파일도 로드한다.&nbsp;</p>
<p data-ke-size="size16">프로필별 속성은 표준 application.properties와 <b>동일한 위치</b>에서 로드되며, 프로필별 파일이 항상 비특정 파일보다 우선합니다. (비특정이라는 거는 아마 아예 yaml 파일인데, 이름이 완전 다른 케이스말하는듯? )<br>여러 프로필이 지정된 경우 <code>last-wins</code> 전략이 적용됩니다.<br>예를 들어, prod,live 프로파일이 spring.profiles.active 속성에 의해 지정된 경우, application-prod.properties의 값을 application-live.properties의 값으로 오버라이드(overriden)할 수 있습니다.</p>

<p data-ke-size="size16">여기서 말하는 <code>last-wins</code> 전략은 다음과 같은 예로 이뤄집니다. <code>last-wins</code> 전략은 로케이션 그룹 레벨을 적용합니다.<br><code>spring.config.location</code>에서 <b>","</b> 인 케이스와 <b>";"</b> 는 전략 적용방식이 다르니 아래 예시를 보면서 확인해봅시다.</p>

<p data-ke-size="size16">활성화 된 파일의 순서는 다음 처럼 <code>prod,live</code> 되어있고, 파일이 다음처럼 위치해있다고 가정합시다.</p>
<p data-ke-size="size16">/cfg<br>application-live.properties (or yaml)<br>/ext<br>application-live.properties<br>application-prod.properties</p>
<p data-ke-size="size16"><code>spring.config.location</code> 가 <code>classpath:/cfg/,classpath:/ext/</code> 일 경우는 무조건 /cfg가 /ext 보다 우선순위가 높습니다.</p>
<ol data-ke-list-type="decimal">
<li><code>/cfg/application-live.properties</code></li>
<li><code>/ext/application-prod.properties</code></li>
<li><code>/ext/application-live.properties</code></li>
</ol>
<p data-ke-size="size16"><code>spring.config.location</code> 가 <code>classpath:/cfg/;classpath:/ext/</code> 일 경우는 <code>/cfg</code>와 <code>/ext</code>가 동일 우선순위로 처리리 됩니다. 이 경우는 Prod가 높은 우선순위를 가집니다.</p>
<ol data-ke-list-type="decimal">
<li><code>/ext/application-prod.properties</code></li>
<li><code>/cfg/application-live.properties</code></li>
<li><code>/ext/application-live.properties</code></li>
</ol>
<p data-ke-size="size16">활성 프로필이 설정되어 있지 않은 경우 사용되는 기본 프로필 세트(기본값은 <code>default</code>)로 지정됨.</p>


<p data-ke-size="size16"><a href="https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config">https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config</a></p>
<figure id="og_1681220699503" contenteditable="false" data-ke-type="opengraph" data-ke-align="alignCenter" data-og-type="website" data-og-title="Core Features" data-og-description="Spring Boot lets you externalize your configuration so that you can work with the same application code in different environments. You can use a variety of external configuration sources including Java properties files, YAML files, environment variables, a" data-og-host="docs.spring.io" data-og-source-url="https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config" data-og-url="https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config" data-og-image=""><a href="https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config" target="_blank" rel="noopener" data-source-url="https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config">

<div>
<p data-ke-size="size16">Core Features</p>
<p data-ke-size="size16">Spring Boot lets you externalize your configuration so that you can work with the same application code in different environments. You can use a variety of external configuration sources including Java properties files, YAML files, environment variables, a</p>
<p data-ke-size="size16">docs.spring.io</p>
</div>
</a></figure></div>


<nav>
<ul>
<li></li>
<li></li>
<li></li>
</ul>
</nav>





















</article>


                    
                
</div>
</main>














                        
        

        

        
        


        

                
                









                
</div>

얇고 넓은 개발 블로그

Application.yaml 설정 파일 실행시 우선순위
 
매번 까먹어서 한번 재대로 정리해봄
default 셋업 아래에 on-profile 설정되어있는데 안먹어서 왜 안먹나 했더니 application.yaml이 우선순위가 높아서 default 옵션을 무시하고 다른 옵션이 들어가버려서 안되길래 도대체 어떤식으로 해결해야하는지 확인해봤다.
이경우에는 application.yaml에 profile이 있으면 됨 혹은 아예 파일이 따로 존재한다던지 여러가지 방법이 존재하니 참고
Application.yaml은 다음과 같은 우선순위를 가지게된다.
1.  [Application properties](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files) packaged inside your jar (`application.properties` and YAML variants).
2.  [Profile-specific application properties](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files.profile-specific) packaged inside your jar (`application-{profile}.properties` and YAML variants).
3.  [Application properties](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files) outside of your packaged jar (`application.properties` and YAML variants).
4.  [Profile-specific application properties](https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config.files.profile-specific) outside of your packaged jar (`application-{profile}.properties` and YAML variants).
내부 Jar이 먼저 우선시 (application.yaml) → 내부 Jar의 Profile이 다음 순위 (application-profile.yaml) → Jar 밖의 Application-yaml → Jar 외부의 Profile이 마지막 순위
1. 구체적인 내부 로직은 다음과 같이 구성
Spring Boot는 애플리케이션이 시작될 때 다음 위치에서 application.properties 및 application.yaml 파일을 자동으로 우선순위를 매기게 됩니다.
classpath 에서
classpath 루트
classpath /config 패키지
현재 디렉토리에서
현재 디렉토리
현재 디렉터리의 config/하위 디렉터리
config/서브디렉토리의 바로 하위 디렉토리
2. Profile이 지정된 경우에는 다음처럼 우선순위 구성
Spring Boot는 application.yaml만 처리하는게 아닌, application-{profile}규칙을 가진 파일도 프로파일별 파일도 로드한다. 
프로필별 속성은 표준 application.properties와 동일한 위치에서 로드되며, 프로필별 파일이 항상 비특정 파일보다 우선합니다. (비특정이라는 거는 아마 아예 yaml 파일인데, 이름이 완전 다른 케이스말하는듯? )
여러 프로필이 지정된 경우 last-wins 전략이 적용됩니다.
예를 들어, prod,live 프로파일이 spring.profiles.active 속성에 의해 지정된 경우, application-prod.properties의 값을 application-live.properties의 값으로 오버라이드(overriden)할 수 있습니다.
 
여기서 말하는 last-wins 전략은 다음과 같은 예로 이뤄집니다. last-wins 전략은 로케이션 그룹 레벨을 적용합니다.
spring.config.location에서 "," 인 케이스와 ";" 는 전략 적용방식이 다르니 아래 예시를 보면서 확인해봅시다.
 
활성화 된 파일의 순서는 다음 처럼 prod,live 되어있고, 파일이 다음처럼 위치해있다고 가정합시다.
/cfg
application-live.properties (or yaml)
/ext
application-live.properties
application-prod.properties
spring.config.location 가 classpath:/cfg/,classpath:/ext/ 일 경우는 무조건 /cfg가 /ext 보다 우선순위가 높습니다.
/cfg/application-live.properties
/ext/application-prod.properties
/ext/application-live.properties
spring.config.location 가 classpath:/cfg/;classpath:/ext/ 일 경우는 /cfg와 /ext가 동일 우선순위로 처리리 됩니다. 이 경우는 Prod가 높은 우선순위를 가집니다.
/ext/application-prod.properties
/cfg/application-live.properties
/ext/application-live.properties
활성 프로필이 설정되어 있지 않은 경우 사용되는 기본 프로필 세트(기본값은 default)로 지정됨.
 
 
https://docs.spring.io/spring-boot/docs/current/reference/html/features.html#features.external-config

Spring 설정파일 우선순위

댓글