SpringBoot 개발초기에는 Gradle이 무서운줄 알았다. 하지만 배포를 하다 보니까 Maven이 더 무섭더라.
이글은 Gradle 공식문서를 아주많이 참고했습니다!
- Gradle 공식문서 - Apache Maven에서 빌드 마이그레이션
- MacOS
- Intellij Ultimate
- Java11/SpringBoot + maven
- 그후 gradle 추가 예정
주의
자신의 프로젝트의 규모와 상황에따라 상황이 달라질 수 있습니다.
학교에 불편한순간 이라는 프로젝트가 있다. 참고
- 프로젝트를 하기전에 build tool 은 익숙한 maven을 선택했었다.
- 하지만 개발할때 익숙하고 편했지만 배포할때가 문제였다.
저희 프로젝트는 CI툴을 Jenkins를 사용하려고 합니다.
우리 Project는 CI/CD를 통한 무중단 배포가 목표이다. 그러기 위해서는 CI가 필수관문인데
하지만 아무리 검색을 해도 maven을 통한 CI에대한 Jenkins배포를 찾을 수 없었다.
아마 아직 개발 역량이 부족해서 일 수도 있지만 자료는 Gradle이 더 많았다.
기존 Maven 프로젝트에서 Gradle Project를 시작하는것은 어렵지 않았다.
다음과같이 입력하면 Gradle Project를 시작할 수 있다.
gradle initMaven프로젝트 디렉토리에서 위와같이 입력했으면
Found a Maven build. Generate a Gradle build from this? (default: yes) [yes, no]
와 같은 메세지가 나온다 Enter 혹은 yes를 입력한다.
그후
Select build script DSL:
1: Groovy
2: Kotlin
Enter selection (default: Groovy) [1..2]이런식으로 build script를 선택하는것이 나올껀데 Groovy를 선택하자. (Enter or 1 입력)
참고 : Groovy는 JVM기반에서 실행되는 스크립트 언어이다. Gralde에서 Build Script로 많이 쓰인다.
그러면 Gradle이 알아서 pom.xml에 있는 depedency및 플러그인을 가져온다.
Gradle의 의존성 관리 시스템은 Maven보다 유연하여
repository, 선언된 의존성, scope(Gradle의 의존성 구성) 및 의존성 전이의 동일한 개념을 계속 지원한다.
Maven과 달리 Gradle은 기본 저장소가 없으므로 최소한 하나를 선언 해야한다.
들어가봤자 라이브러리를 디렉토리명 및 파일을 나열해놔서 별 도움이 안된다.
굳이 라이브러리를 찾고싶으면 https://search.maven.org/ 여기에서 찾자
Before
repositories {
mavenLocal() //변경전 부분 // 의존성을 로컬에서 찾는다.
maven {
url = uri('https://repo.maven.apache.org/maven2/')
}
}After
repositories {
mavenCentral() //변경된 부분 Maven Central로 의존성 저장소를 바꿈
maven {
url = uri('https://repo.maven.apache.org/maven2/')
}
}Maven Central: 자바진영에서 개발의 필요한 의존성이 저장되어있는 저장소이다.
먼저 Gradle plugin이 설치가 되어있어야한다.
gradle init을 한후 gradle 프로젝트에 필요한 파일들이 프로젝트 폴더에 추가 되었으면,
Gradle build scripts found 이 하단에 나타날것이다.
그후 gradle build 혹은 ./gradlew build 를 입력해서 gradle project로 현제 프로젝트가 build되는지 확인하자.
Build가 되면 바로 Gradle로 migration하면 되지만,
자신에 프로젝트에 어떤 side effect가 올지모르므로 검증후 점진적으로 적용하기 바란다.
그러면 Intellij에서 intellij 하게 gradle의 depedency를 불러올것이다.
자신의 프로젝트에 최상단에서 .idea를 제거하고 Intellij를 제실행하면 해결될것이다.
나의 경우에는 compileJava FAILED가 떴다. 에러코드를 올려보니
etc...
symbol: method getAdminPwd()
/{PROJECT_ROOT}/src/main/java/com/moment/the/dto/AdminDto.java:33: error: cannot find symbol
.adminName(this.getAdminName())
^
symbol: method setCode(int)
location: variable result of type CommonResult
/{PROJECT_ROOT}/src/main/java/com/moment/the/domain/response/ResponseService.java:62: error: cannot find symbol
result.setMsg(CommonResponse.FAIL.getMsg());
^
51 errors
FAILURE: Build failed with an exception.
* What went wrong:
Execution failed for task ':compileJava'.
> Compilation failed; see the compiler error output for details.
* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.
* Get more help at https://help.gradle.org
BUILD FAILED in 1s
1 actionable task: 1 executed
getter, setter 매서드를 찾을 수 없다는 에러가 51개나 떳다.
그러면 lombok이 method를 생성하지 않았다는건데?!
그후 바로 Gradle에 lombok을 적용하는것을 구글링했다. 사랑해요 Stack Overflow
참고 링크 : https://stackoverflow.com/questions/35236104/gradle-build-fails-on-lombok-annotated-classes
build.gradle 에 dependencies에 다음과같이 추가해주면 해결이된다.
dependencies{
compileOnly 'org.projectlombok:lombok:1.18.16'
annotationProcessor 'org.projectlombok:lombok:1.18.16'
}버전명시는 자신의 프로젝트에 추가되어있는 lombok 버전과 똑같이 맞추자
그후 Build를 하여 성공했다!
> gradle build
BUILD SUCCESSFUL in 668ms
5 actionable tasks: 5 up-to-dateSpringBoot가 그래도 한국에 자료가 많아서 너무 구글링 및 블로그에 의존했던것 같다.
이번기회에 공식문서의 중요성을 알게되었다.
공식문서에는 기타 정보들도 많고 직접적으로 구글링해서 찾아야 할것을 알려준다.
다만 한국어가 아니여서 좀많이 아쉬운것같다.. 역시 영어공부를 해야겠다.
여기에서는 안나왔지만 Build Error를 해결하는 도중 에러 메세지를 재대로 안봤다 ㅜ..
왜냐하면 intellij에 있는 Terminal를 쓰고있는데(하단에 놓고 사용해서 위에가 가려진다..)
계속 빌드가 실패했다는 메시지만 보였고 가려진 진짜 에러부분을 볼 생각을 못했었다.(위에 에러메세지가 있는줄 몰랐다...)
진짜 이거 에러메세지 보고 현타가 엄청왔었다..
그래도 이번 기회에 gradle에 대한 생명주기 및 build tool에서 라이브러리를 어떻게 가져오는지에 대해 찾아볼 수 있어서 좋았다.
그리고 한층 성장한것같아 기분이 좋다.