실행

Ktor 서버 애플리케이션을 실행할 때 다음의 세부 사항을 고려해야 합니다:

• 서버를 생성하는 방식에 따라 패키징된 Ktor 애플리케이션을 실행할 때 명령줄 인수를 전달하여 서버 파라미터를 재정의(override)할 수 있는지 여부가 결정됩니다.
• Gradle/Maven 빌드 스크립트는 EngineMain을 사용하여 서버를 시작할 때 메인 클래스 이름을 지정해야 합니다.
• 서블릿 컨테이너 내에서 애플리케이션을 실행하려면 특정 서블릿 구성이 필요합니다.

이 주제에서는 이러한 구성 세부 사항을 살펴보고 IntelliJ IDEA 및 패키징된 애플리케이션으로 Ktor 애플리케이션을 실행하는 방법을 보여줍니다.

구성 세부 사항

구성: 코드 vs 구성 파일

Ktor 애플리케이션을 실행하는 방법은 서버를 생성할 때 사용한 방식인 embeddedServer 또는 EngineMain에 따라 다릅니다:

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

EngineMain 시작: Gradle 및 Maven 세부 사항

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

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

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

application {
    mainClass.set("io.ktor.server.netty.EngineMain")
}

mainClassName = "io.ktor.server.netty.EngineMain"

<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 애플리케이션을 실행하려면 해당 플러그인을 사용하세요:

• Gradle용 Application 플러그인. 네이티브 서버의 경우, Kotlin Multiplatform 플러그인을 사용하세요.
• Maven용 Exec 플러그인.

IntelliJ IDEA에서 Ktor 애플리케이션을 실행하는 방법을 알아보려면 IntelliJ IDEA 문서의 Run a Ktor application 섹션을 참조하세요.

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

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

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

  java -jar sample-app.jar -port=8080

• Gradle Application 플러그인을 사용하여 패키징된 애플리케이션을 실행하려면 해당 실행 파일을 실행하세요:

  Linux/macOSWindows

• 서블릿 Ktor 애플리케이션을 실행하려면 Gretty 플러그인의 run 태스크를 사용하세요.

  ./gradlew appRun