Skip to content

실행 ​

Ktor 서버 애플리케이션을 실행할 때는 다음과 같은 세부 사항을 고려해야 합니다.

이 문서에서는 이러한 구성 관련 세부 사항을 살펴보고, IntelliJ IDEA 및 패키징된 애플리케이션 형태로 Ktor 애플리케이션을 실행하는 방법을 설명합니다.

구성 세부 사항 ​

구성: 코드 vs 구성 파일 ​

Ktor 애플리케이션 실행 방식은 서버 생성에 사용한 방식(embeddedServer 또는 EngineMain)에 따라 달라집니다.

  • embeddedServer의 경우 호스트 주소 및 포트와 같은 서버 매개변수가 코드 내에 구성되므로 애플리케이션 실행 시 이러한 매개변수를 변경할 수 없습니다.
  • EngineMain의 경우 Ktor는 HOCON 또는 YAML 형식을 사용하는 외부 파일에서 구성을 로드합니다. 이 방식을 사용하면 명령줄에서 패키징된 애플리케이션을 실행하고 해당 명령줄 인수를 전달하여 필요한 서버 매개변수를 재정의할 수 있습니다.

EngineMain 시작: Gradle 및 Maven 세부 사항 ​

EngineMain을 사용하여 서버를 생성하는 경우, 원하는 엔진으로 서버를 시작하기 위한 main 함수를 지정해야 합니다. 아래 예제는 Netty 엔진으로 서버를 실행하는 데 사용되는 main 함수를 보여줍니다.

kotlin
fun main(args: Array<String>): Unit = io.ktor.server.netty.EngineMain.main(args)

main 함수 내에서 엔진을 구성하지 않고 Gradle/Maven을 사용하여 Ktor 서버를 실행하려면 빌드 스크립트에 메인 클래스 이름을 다음과 같이 지정해야 합니다.

kotlin
application {
    mainClass.set("io.ktor.server.netty.EngineMain")
}
groovy
mainClassName = "io.ktor.server.netty.EngineMain"
xml
<properties>
    <main.class>io.ktor.server.netty.EngineMain</main.class>
</properties>

WAR 관련 세부 사항 ​

Ktor를 사용하면 애플리케이션 내부에서 직접 원하는 엔진(예: Netty, Jetty, Tomcat)으로 서버를 생성하고 시작할 수 있습니다. 이 경우 애플리케이션이 엔진 설정, 연결 및 SSL 옵션을 직접 제어합니다.

이 방식과 달리, 서블릿 컨테이너를 사용할 때는 서블릿 컨테이너가 애플리케이션의 수명 주기와 연결 설정을 제어해야 합니다. Ktor는 애플리케이션에 대한 제어권을 서블릿 컨테이너에 위임하는 특수 엔진인 ServletApplicationEngine을 제공합니다. 애플리케이션을 구성하는 방법은 War 플러그인 구성에서 확인할 수 있습니다.

애플리케이션 실행 ​

개발 중에 서버를 재시작하는 데 시간이 다소 걸릴 수 있습니다. Ktor에서는 코드 변경 시 애플리케이션 클래스를 다시 로드하여 빠른 피드백 루프를 제공하는 Auto-reload를 사용하여 이러한 제약을 극복할 수 있습니다.

Gradle/Maven을 사용하여 애플리케이션 실행 ​

Gradle 또는 Maven을 사용하여 Ktor 애플리케이션을 실행하려면 해당 플러그인을 사용합니다.

IntelliJ IDEA에서 Ktor 애플리케이션을 실행하는 방법은 IntelliJ IDEA 문서의 Ktor 애플리케이션 실행 섹션을 참조하세요.

패키징된 애플리케이션 실행 ​

애플리케이션을 배포하기 전에 패키징 섹션에 설명된 방법 중 하나로 패키징해야 합니다. 결과 패키지에서 Ktor 애플리케이션을 실행하는 방법은 패키지 유형에 따라 다르며 다음과 같습니다.

  • Fat JAR로 패키징된 Ktor 서버를 실행하고 구성된 포트를 재정의하려면 다음 명령을 실행합니다.

    Bash
    java -jar sample-app.jar -port=8080
  • Gradle Application 플러그인을 사용하여 패키징된 애플리케이션을 실행하려면 해당 실행 파일을 실행합니다.

    ./ktor-sample
    ktor-sample.bat
  • 서블릿 Ktor 애플리케이션을 실행하려면 Gretty 플러그인의 run 작업을 사용합니다.