Spring Boot 프로젝트의 jar 배포 테스트를 위해 구동 테스트를 했다.

1. bootRun (O)
2. cmd - bootJar 실행 (X)
3. docker - bootJar 실행 (O)

bootRun 을 통과하고 bootJar 를 만들어 cmd 에서 실행을 했는데 db connection 타이밍에 에러가 발생했다.

ㅋㅋ 아니 뭐 요점만 간단히 알려주든가, '왜' 에러 났는지를 알려줘야지 거참...

bootRun 은 되는데, jar 실행에서 db 연결이 안된다? ... ㅡㅡ;; 우선 구글을 겁나 뒤졌다. 하... 그 많은 게시물들 중 DB 연결해 놓고 jar 실행한 사람이 하나 없냐... 다들 톰캣 띄운 Hello World... 나도 헬로월드 좋아하긴 하지만... 개발군 헬창들... 저 에러메시지는 너무 광범위하고, 내 상황을 검색어로 표현하기는 더 어려웠다. 구글 검색 페이지를 넘기다넘기다 중국말까지 나오기 시작했다. 아니... 이 아이러니한 상황이 납득이가 안갔다. 이렇게 시간을 낭비할 수는 없어 docker 를 일단 돌려봤다. 엥... 도커는 또 잘됨; 최종 목적이 도커라 로컬은 그냥 넘겨도 되지만 또또... 오늘한 삽질이 아까워 그 끝을 보기로 했다.

spring-boot-starter-web
spring-boot-starter-data-jdbc
mysql-connector-java:8.0.25

우선 톰캣만 띄웠더니 문제없다. 바로 dataSource 연결했더니 똑같은 오류...! 아니 원래 로컬에서 DB 연결이 안됐었나; 더 해볼게 없었지만 마지막으로, 혹시나 하는 마음에 connector 버전을 바꿔보았다.

mysql-connector-java:5.1.49

당연히 같은 자리에서 오류가 발생하기는 했는데, 해결책이 나왔다!

Mysql 5.5.45+, 5.6.26+, 5.7.6+ 부터는 ssl 접속이 default 라서, useSSL=false 를 명시하지 않으면 자동으로 ssl 접속을 시도한다는 것이다.

jdbc:mysql://example.ap-northeast-2.rds.amazonaws.com:3306/example?...&useSSL=false

설마 이거 때문일 줄은 몰랐다. 이렇게 해결되니, 그래도 편히 눈을 감을 수 있게 됐다. 친절한 mysql connector 구버전에게 감사를 표한다.하지만 여전히 황당하기는 하다. ssl 이유라면 bootRun 으로도 되지 말았어야지. 도커에서도 되지 말았어야지...ㅜ

지금 보니 처음 발생했던 에러의 저 마지막 줄이 힌트긴 했네...

Spring Boot

Spring Boot 는 production 급의 독립형 Spring 어플리케이션을 쉽게 만들 수 있으며, spring 설정이 거의 필요없다.(고 하지만 이거슨 거짓말! ㅜ)

아래는 간략한 Spring Boot 의 특징이다.

• 독립 실행형 Spring 어플리케이션 생성.
• Tomcat, Jetty, Undertow 등의 WAS 포함. (WAR 파일 배포 불필요)
• 자동으로 Spring 설정.
• 상태 확인, 측정 및 외부 구성과 같은 production 기능을 제공.
• 코드를 생성하거나, XML 설정 파일이 불필요.

Spring Boot Gradle Plugin

Spring Boot 2.0 이상에서 gradle 로 시작하려 할 때, Spring Boot Gradle Plugin 을 사용하려면 Gradle 4.0 이상이 필요하며 다음과 같은 잇점이 있다.

• Spring-boot-dependencies 가 제공하는 종속성 관리 가능
• 실행 가능한 jar 또는 war 아카이브를 패키지화
• Spring Boot 어플리케이션 실행

1. Spring-boot-gradle-plugin 시작

Spring Boot Gradle Plugin 은 간단하게 plugins 블럭을 사용하여 프로젝트에 적용할 수 있다.

buildscript 블럭을 사용할 경우 다음과 같이 사용한다.

2. Spring-boot-dependencies 가 제공하는 종속성 관리

dependency-management 플러그인을 사용하면 특정 Spring boot 버전에 호환되는 종속성을 자동으로 가져오며 각 버전을 관리해 주기 때문에, 종속성 마다 버전을 기입할 필요가 없다. 아래처럼 최소한의 플러그인을 적용한다.

implementation 에는 종속성만 기입할 뿐 버전을 정의하지 않았다.

종속성의 다른 버전을 사용하고 싶은 경우 properties 를 지정하여 사용자 정의할 수 있으며, 호환성 문제를 꼭 체크하도록 한다.

3. 실행 가능한 jar 또는 war 아카이브 패키지화

Spring Boot Gradle Plugin 은 어플리케이션의 모든 종속성을 포함하는 실행 가능한 jar / war 파일을 생성하고 실행할 수 있다.

• 실행 가능한 jar : java 플러그인이 적용될 때 bootJar task 가 생성되며 이를 사용하여 jar 파일을 빌드할 수 있다. build task 를 실행하면 bootJar task 도 실행된다.
• 실행 가능한 war : war 플러그인이 적용될 때 bootWar task 가 생성되며 이를 사용하여 war 파일을 빌드할 수 있다. build task 를 실행하면 bootWar task 도 실행된다.

BootJar / BootWar task 는 Jar / War task 의 하위 클래스이다.

외부 컨테이너에서 java -jar 를 사용하여 war 파일을 실행하고 배포할 수 있도록 패키지화 하려면 서블릿 컨테이너 종속성을 providedRuntime 에 추가해야 한다.

기본적으로 bootJar / bootWar task 가 구성되면, jar / war task 는 비활성화 되는데 이를 활성화 시켜 실행 가능한 아카이브와 일반 아카이브를 동시에 빌드하도록 구성할 수 있다. 두 아카이브가 겹치지 않도록 둘 중 하나의 분류자(classfier) 를 구성할 수 있다.

실행 가능한 아카이브의 main 클래스는 task 의 classpath 에서 public static void main(String[]) 메소드를 가진 클래스를 찾아 자동으로 구성되는데 mainClassName 속성을 사용하여 명시적으로 구성할 수도 있다.

처음에 아카이브를 빌드하지 않고도 bootRun task 를 사용하여 어플리케이션을 실행할 수 있다.

또는 Spring Boot DSL 의 mainClassName 속성을 사용하여 프로젝트 전체에서 기본 클래스 이름을 구성할 수도 있다.

application 플러그인이 적용된 경우 mainClassName 프로젝트 속성을 사용하여 동일한 목적으로 사용할 수도 있다.

task 의 manifest 에 Start-Class 속성을 구성할 수 있다.

Spring Boot 프로젝트에 java plugin 이 함께 쓰이면, Spring boot plugin 은 다음과 같이 동작한다.

• bootJar task 생성. jar 파일은 main 소스셑의 런타임 클래스패스 상의 모든 소스를 포함하며, 클래스는 BOOT-INF/classes 에 패키징되고 jar 파일들은 BOOT-INF/lib 에 패키징 됨.
• jar task 비활성화.
• 어플리케이션을 실행하는 bootRun task 생성.
• bootJar task 에 의해 생성된 아티팩트를 포함하도록 bootArchives 를 생성.
• JavaCompile task 가 UTF-8 을 사용하도록 구성.
• JavaCompile task 가 파라미터(-parameters) 를 사용하도록 구성.

Spring Boot 프로젝트에 war plugin 이 함께 쓰이면, Spring boot plugin 은 다음과 같이 동작한다.

• bootWar task 생성. 표준 구성에 더하여 providedRuntime 구성이 WEB-INF/lib-provided 에 패키징 됨
• war task 비활성화.
• bootArchives 구성에 bootWar task 에 의해 생성된 아티팩트를 포함하도록 구성.

Spring Boot 프로젝트에 application plugin 이 함께 쓰이면, Spring boot plugin 은 다음과 같이 동작한다.

• main 속성 규칙으로 mainClassName 속성을 사용하도록 booRun task 구성.
• manifest 의 Start-Class 규칙으로 mainClassName 속성을 사용하도록 bootJar / bootWar task 구성.

gradle library 추가 후 bootrun 실행시 발생한 오류. 뭔 파일 이름이나 확장명이 길다는건지; --debug 는 봐도 모르겠고...

검색 결과 클래스패스 종족성이 너무 길다는거 같은데, 클래스패스를 찍어 봤더니 약 33000자가 넘었다.ㅋㅋ;

Windows 에 CreateProcess 의 limit 가 32767 인거 같음.

Bootrun 시작 명령이 java -jar MyApp.jar -classpath a.jar,b.jar,c.jar,... 처럼 나열되는데 그럼 라이브러리를 몇 개 빼야하나;

해결책은 하나의 jar 파일에 저 종속성들을 나열하는 manifest 파일을 만들고 명령문에는 그 jar 파일 하나만을 호출하면 끝!

Gradle.build 코드는 다음과 같다.

이제 bootrun 을 실행하면 아래와 같이 manifest 파일이 담긴 pathing.jar 파일로 모든 종속성을 실행하게 된다.