Open AIDoc

한국어

简体中文
繁體中文
日本語

한국어

简体中文
繁體中文
日本語

Appearance

WAR ​

코드 예제: jetty-war, tomcat-war, tomcat-war-ssl

Tomcat이나 Jetty와 같은 서블릿 컨테이너(Servlet container) 내에서 Ktor 애플리케이션을 실행할 수 있습니다. 이를 위해 애플리케이션을 WAR 아카이브(WAR archive)로 패키징하고 WAR 배포를 지원하는 서버나 클라우드 서비스에 배포해야 합니다.

이 주제에서는 다음 방법을 배웁니다:

서블릿 애플리케이션에서 Ktor 구성 ​

Ktor를 사용하면 애플리케이션에서 직접 특정 엔진(Netty, Jetty 또는 Tomcat 등)을 사용하여 서버를 생성하고 시작할 수 있습니다. 이 설정에서는 애플리케이션이 엔진 구성, 연결 및 SSL 설정을 제어합니다.

서블릿 컨테이너에 배포할 때는 컨테이너가 애플리케이션 생명 주기(Lifecycle)와 연결 구성을 제어합니다. 이를 위해 Ktor는 애플리케이션의 제어권을 서블릿 컨테이너에 위임하는 ServletApplicationEngine 엔진을 제공합니다.

서블릿 컨테이너 내에서 실행할 때는 구성 파일에 정의된 Ktor 연결 및 SSL 설정이 적용되지 않습니다.

Tomcat에서 SSL을 구성하는 방법은 tomcat-war-ssl 샘플을 참조하세요.

의존성 추가 ​

서블릿 애플리케이션에서 Ktor를 사용하려면 빌드 스크립트에 ktor-server-servlet-jakarta 아티팩트를 추가하세요.

Kotlin
Groovy
XML

서블릿 컨테이너에 배포할 때는 별도의 Jetty 또는 Tomcat 엔진 의존성을 추가할 필요가 없습니다.

서블릿 구성 ​

애플리케이션에 Ktor 서블릿을 등록하려면 WEB-INF/web.xml 파일을 열고 servlet-class 속성에 ServletApplicationEngine을 할당하세요.

xml
<servlet>
    <display-name>KtorServlet</display-name>
    <servlet-name>KtorServlet</servlet-name>
    <servlet-class>io.ktor.server.servlet.jakarta.ServletApplicationEngine</servlet-class>
    <init-param>
        <param-name>io.ktor.ktor.config</param-name>
        <param-value>application.conf</param-value>
    </init-param>
    <async-supported>true</async-supported>
</servlet>
XML

그런 다음, 이 서블릿에 대한 URL 패턴을 구성합니다.

xml
<servlet-mapping>
    <servlet-name>KtorServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

Gretty 플러그인 구성 ​

Gretty 플러그인을 사용하면 Jetty 및 Tomcat에서 서블릿 애플리케이션을 실행할 수 있습니다.

플러그인을 적용하려면 build.gradle.kts 파일을 열고 plugins 블록에 다음 항목을 추가하세요.

groovy
plugins {
    id("org.gretty") version "5.0.1"
}

그런 다음, 다음과 같이 gretty 블록에서 구성할 수 있습니다.

groovy
gretty {
    servletContainer = "jetty12"
    contextPath = "/"
}
groovy
gretty {
    servletContainer = "tomcat10"
    contextPath = "/"
}

마지막으로 run 태스크를 구성합니다.

groovy
afterEvaluate {
    tasks.getByName("run") {
        dependsOn("appRun")
    }
}

War 플러그인 구성 ​

War 플러그인을 사용하면 서블릿 컨테이너 배포를 위한 WAR 아카이브를 생성할 수 있습니다.

플러그인을 적용하려면 build.gradle.kts 파일을 열고 plugins 블록에 다음 항목을 추가하세요.

groovy
plugins {
    id("war")
}

애플리케이션 실행 ​

run 태스크를 사용하여 구성된 Gretty 플러그인과 함께 서블릿 애플리케이션을 실행할 수 있습니다. 예를 들어, jetty-war 샘플 프로젝트를 실행하려면 다음 명령을 실행하세요.

Bash
./gradlew :jetty-war:run

WAR 아카이브 생성 및 배포 ​

War 플러그인을 사용하여 WAR 아카이브를 생성하려면 war 태스크를 실행하세요. jetty-war 샘플 프로젝트의 경우 명령은 다음과 같습니다.

Bash
./gradlew :jetty-war:war

태스크가 완료되면 해당 모듈의 build/libs 디렉토리에서 jetty-war.war 파일을 확인할 수 있습니다.

생성된 아카이브를 배포하려면 파일을 서블릿 컨테이너의 jetty/webapps 디렉토리에 복사하세요.

다음 Dockerfile 예제는 Jetty 또는 Tomcat 서블릿 컨테이너 내에서 생성된 WAR 파일을 실행하는 방법을 보여줍니다.

Docker
FROM jetty:12.0.29
EXPOSE 8080:8080
COPY ./build/libs/jetty-war.war/ /var/lib/jetty/webapps
WORKDIR /var/lib/jetty
CMD ["java","-jar","/usr/local/jetty/start.jar"]
Docker
FROM tomcat:10.1.50
EXPOSE 8080:8080
COPY ./build/libs/tomcat-war.war/ /usr/local/tomcat/webapps
WORKDIR /usr/local/tomcat
CMD ["catalina.sh", "run"]

전체 예제는 jetty-war 및 tomcat-war를 참조하세요.

Copyright © 2026 Open AIDoc.