Maven Assembly 플러그인을 사용하여 Fat JAR 생성하기

샘플 프로젝트: tutorial-server-get-started-maven

Maven Assembly 플러그인은 프로젝트 결과물을 의존성, 모듈, 사이트 문서 및 기타 파일을 포함하는 단일 배포 가능한 아카이브로 결합하는 기능을 제공합니다.

Assembly 플러그인 구성

어셈블리를 빌드하려면 먼저 Assembly 플러그인을 구성해야 합니다:

1. pom.xml 파일로 이동하여 메인 애플리케이션 클래스가 지정되었는지 확인합니다.

   <properties>
       <main.class>com.example.ApplicationKt</main.class>
   </properties>

   EngineMain을 명시적인 main() 함수 없이 사용하는 경우, 애플리케이션의 메인 클래스는 사용된 엔진에 따라 io.ktor.server.netty.EngineMain과 같이 보일 수 있습니다.

2. maven-assembly-plugin을 plugins 블록에 다음과 같이 추가합니다.

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-assembly-plugin</artifactId>
       <version>2.6</version>
       <configuration>
           <descriptorRefs>
               <descriptorRef>jar-with-dependencies</descriptorRef>
           </descriptorRefs>
           <archive>
               <manifest>
                   <addClasspath>true</addClasspath>
                   <mainClass>${main.class}</mainClass>
               </manifest>
           </archive>
       </configuration>
       <executions>
           <execution>
               <id>assemble-all</id>
               <phase>package</phase>
               <goals>
                   <goal>single</goal>
               </goals>
           </execution>
       </executions>
   </plugin>

Assembly 빌드

애플리케이션용 어셈블리를 빌드하려면 터미널을 열고 다음 명령어를 실행합니다.

mvn package

이 명령어는 어셈블리용 새 target 디렉터리를 생성하며, 이 디렉터리에는 .jar 파일이 포함됩니다.

결과 패키지를 사용하여 Docker로 애플리케이션을 배포하는 방법을 알아보려면 Docker 도움말 항목을 참조하세요.

애플리케이션 실행

빌드된 애플리케이션을 실행하려면 다음 단계를 따릅니다.

1. 새 터미널 창에서 java -jar 명령어를 사용하여 애플리케이션을 실행합니다. 샘플 프로젝트의 경우 다음과 같습니다.

   java -jar target/tutorial-server-get-started-maven-0.0.1-jar-with-dependencies.jar

2. 앱이 실행되면 다음과 같은 확인 메시지가 표시됩니다.

   [main] INFO  Application - Responding at http://0.0.0.0:8080

3. URL 링크를 클릭하여 기본 브라우저에서 애플리케이션을 엽니다.