Spring profile VS Gradle(Maven) profile
Spring profile? :: @Profile()
- Spring profile은 빌드 결과물 내에서 스프링이 어떤 profile을 사용할지 선택하는 것
- 런타임 프로파일 설정
Gradle(Maven) profile? :: .properties, .yml
- 빌드 시 어떤 profile을 리소스에 포함 시킬지 선택하는 것
- 빌드타임 프로파일 설정
- Maven profile
-----
- 즉, Gradle profile이 더 큰 파일 개념이고, 선택한 파일 이외는 jar에 포함하지 않을 수 있음.
- Spring profile의 장점은 아예 빈 자체를 특정 프로파일에만 활성화 하는 등 좀 더 유연하게 사용할 수 있다는 점
- 근데 해당 파일의 profile이 모두 jar에 포함된다는건 단점.
- jar가 유출되면 뜯어서 리얼 서버에서 사용하는 Key 등등을 확인할 수 있으니까
- 그래서 Gradle profile과 Spring profile을 둘 다 사용하는 것이 좋음!
- 어차피 공통으로 사용할 `` application.yml``을 하나 두고, 빌드 환경에 따라 추가적으로 `` application-${profile}.yml``을 불러오도록 구성하려면 Spring profile이 꼭 필요하다.
- 빌드시점에 Gradle profile로 `` application-${profile}.yml``을 포함하도록 하더라도, 스프링에서 여기있는 변수를 불러오는건 별개의 문제이기 때문
Gradle Profile 구성하기
build.gradle.kts
```kt
val profile = if (project.hasProperty("profile"))
project.property("profile").toString() else "local"
sourceSets {
main {
resources {
srcDirs(listOf("src/main/resources", "src/main/resources-$profile"))
}
}
}
```
- 여기서 주의할 점
- 같은 파일명의 `` application.yml``이 각 dir 마다 존재한다면, 가장 마지막에 명시된 dir의 `` application.yml``만을 사용하게 됨.
- 그래서 폴더를 `` resources``, `` resources-alpha`` 등으로 나누더라도 내부에 들어가는 파일 이름을 다르게 지정해 주어야 한다.
- 폴더를 `` resources``, `` resources-alpha`` 등으로 나누는 이유?
- 폴더 분리 안하고 `` resources/`` 하위에 `` application-beta.yml`` 등을 모두 함께 넣어버리면, 해당 dir의 모든 리소스가 같이 포함되어 jar로 묶인다.
- jar가 유출되면 뜯어서 리얼 서버에서 사용하는 Key 등등을 알아낼 수 있음.
- 따라서 폴더를 분리하여 필요한 리소스만 포함해서 빌드하도록 하는 것이 좋다.
- 이런 식으로 위치시키고 빌드하면, `` resources/application.yml, resources-local/application-local.yml``이 포함되어 빌드된다
- 근데 막상 런타임에는 `` application-local.yml``에 있는 상수 이름은 못찾는다고 에러가 발생한다.
- Spring Profile을 설정해줘야 여기 있는 상수도 찾을 수 있음!
- 어떤 Spring profile을 빌드 시 포함하도록 할 것인지는 다음 옵션으로 지정
- `` gradle clean build -Pprofile=beta``
- intelliJ 에서는 Run Configurations에서
- Before launch - Run Gralde task
- Task : `` clean build``
- Arguments : `` -Pprofile=$profile``
- Before launch - Run Gralde task
Spring Profile 구성하기
application.yml
```
spring:
profiles:
active: local
```
- 이렇게 설정해줘야 `` application-local.yml``에 있는 상수도 불러올 수 있다.
- 스프링은 프로필로 설정된 문자열에 해당하는 `` application-${profile}.yml``가 있는지 뒤져보고, 있다면 불러온다.
- 이 경우 `` application-local.yml``이 있는지 찾아보고, 없으면 넘어가고 있다면 불러옴.
- 어떤 Spring profile을 사용할 것인지는 다음 세 가지 방법으로 설정 가능
- application.yml에 active로 명시
- argument로 전달
- RUN_ARGS : `` --spring.profiles.active=xx,yy``
- JAVA_OPTS : `` -Dspring.profiles.active=xx,yy``
- 환경변수 : `` SPRING_PROFILES_ACTIVE=xx``로 명시
build.gradle.kts의 profile 변수를, gradle Task 실행 시 전달
- gradle_system_properties 란?
- 위에서 [argument로 전달:JAVA_OPTS] 부분을, build.gradle.kts에 명시해서 자동으로 넣어준다고 보면 될 것 같다.
```kt
// Test task를 실행할 때 profile 전달
tasks.getByName<Test>("test") {
systemProperty("spring.profiles.active", profile)
}
```
IntelliJ에서 실행할 때?
- intelliJ에서는 Run Configurations에서 다음 두 가지 모두 설정해줄 것.
- Active Profiles
- 이 설정은 launch하면서 쓰는 설정이다.
- clean build 라는 Gradle task를 실행하면서 적용되는 환경변수는 따로 설정해주어야 한다
- Gradle task(bootRun, Test, ...)를 실행할 때 선택할 profile 지정
- 방법1 ) 위의 build.gradle.kts의 profile 변수를 gradle Task 실행 시 전달
- 방법2 ) Before launch: Gradle task에 환경변수 명시
- Gradle task 실행시 선택할 profile을 명시 안하면 Test 돌릴 때 Profile이 default로 설정돼서 실패뜬다.
- Active Profiles
반대로 application-core.yml을 구성하는 방법은?
- [1] 위 방식은 공통으로 사용할 `` resources/application.yml``과 선택에 따라 `` resources-${profile}/application-${profile}.yml``을 불러오는 방법.
- [2] 반대로 공통으로 사용할 `` resources/application-core.yml``을 두고, 선택에 따라 `` resources-${profile}/application.yml``을 불러오도록 하는 방법도 있다.
- 어느 쪽이 되었건 `` application.yml``이 먼저 로드되고, `` application-xxx.yml``이 더 늦게 로드 된다.
- 같은 이름 상수가 정의되어 있는 경우, 늦게 로드 되는 쪽이 overwrite 한다!
- 그래서 [1] 방식을 사용하는 편이 좋아 보인다. 실수로 같은 이름 상수를 정의한 경우에도, 더 specific한 설정으로 덮어 써지므로.
참고
https://perfectacle.github.io/2017/09/23/Spring-boot-gradle-profile/
'Languages & Frameworks > Spring' 카테고리의 다른 글
RestTemplate은 어떻게 response Object를 DataType <T>로 변환하는가 (0) | 2020.03.27 |
---|---|
[Spring] DB 관련 : Mybatis (0) | 2020.03.04 |
[Spring] profile로 beta, real 빌드 구분하기 (0) | 2020.03.03 |
[Spring] Controller에서 사용하는 애너테이션 (0) | 2019.09.25 |
Spring AOP / @annotation resolve (0) | 2019.07.30 |
Hystrix with Spring ( Circuit Breaker ) 를 사용할 때 주의해야 할 점. (0) | 2019.07.30 |