배포
코드 예제: deployment-ktor-plugin
이 항목에서는 Ktor 애플리케이션을 배포하는 방법에 대해 전반적으로 살펴봅니다.
서버 Ktor 애플리케이션의 배포 프로세스를 간소화하기 위해, 다음과 같은 기능을 제공하는 Gradle용 Ktor 플러그인을 사용할 수 있습니다:
- fat JAR 빌드.
- 애플리케이션 Docker화(Dockerizing).
Ktor 배포 세부 사항
서버 Ktor 애플리케이션의 배포 프로세스는 다음과 같은 세부 사항에 따라 달라집니다:
- 애플리케이션을 독립 실행형(self-contained) 패키지로 배포할지 아니면 서블릿 컨테이너 내부에 배포할지 여부.
- 서버를 생성하고 구성하는 데 어떤 방식을 사용하는지 여부.
독립 실행형 앱 vs 서블릿 컨테이너
Ktor를 사용하면 애플리케이션 내에서 바로 원하는 네트워크 엔진(engine)(Netty, Jetty 또는 Tomcat 등)으로 서버를 생성하고 시작할 수 있습니다. 이 경우 엔진은 애플리케이션의 일부가 됩니다. 애플리케이션은 엔진 설정, 연결 및 SSL 옵션에 대한 제어 권한을 갖습니다. 애플리케이션을 배포하려면 fat JAR 또는 실행 가능한 JVM 애플리케이션으로 패키징할 수 있습니다.
위의 방식과 대조적으로, 서블릿 컨테이너(servlet container)가 애플리케이션 수명 주기와 연결 설정을 제어해야 합니다. Ktor는 애플리케이션에 대한 제어권을 서블릿 컨테이너에 위임하는 특수한 ServletApplicationEngine 엔진을 제공합니다. 서블릿 컨테이너 내부에 배포하려면 WAR 아카이브를 생성해야 합니다.
구성: 코드 vs 구성 파일
독립 실행형 Ktor 애플리케이션의 배포 설정을 구성하는 것은 코드 내에서 또는 구성 파일을 사용하여 서버를 생성하고 구성하는 방식에 따라 달라질 수 있습니다. 예를 들어, 호스팅 제공업체에서 수신 요청을 대기하는 데 사용되는 포트를 지정하도록 요구할 수 있습니다. 이 경우 코드나 application.conf/application.yaml에서 포트를 구성해야 합니다.
패키징
애플리케이션을 배포하기 전에 다음 중 한 가지 방법으로 패키징해야 합니다:
Fat JAR
fat JAR는 모든 코드 의존성을 포함하는 실행 가능한 JAR입니다. fat JAR를 지원하는 모든 클라우드 서비스에 배포할 수 있습니다. fat JAR는 GraalVM용 네이티브 바이너리(native binary)를 생성해야 하는 경우에도 필요합니다. fat JAR를 만들려면 Gradle용 Ktor 플러그인 또는 Maven용 Assembly 플러그인을 사용할 수 있습니다.
실행 가능한 JVM 애플리케이션
실행 가능한 JVM 애플리케이션은 코드 의존성과 생성된 시작 스크립트를 포함하는 패키징된 애플리케이션입니다. Gradle의 경우, Application 플러그인을 사용하여 애플리케이션을 생성할 수 있습니다.
WAR
WAR 아카이브를 사용하면 Tomcat이나 Jetty와 같은 서블릿 컨테이너 내부에 애플리케이션을 배포할 수 있습니다.
GraalVM
Ktor 서버 애플리케이션은 다양한 플랫폼을 위한 네이티브 이미지를 만들기 위해 GraalVM을 활용할 수 있습니다.
컨테이너화
애플리케이션을 패키징한 후(예: 실행 가능한 JVM 애플리케이션 또는 fat JAR), 이 애플리케이션을 포함한 Docker 이미지를 준비할 수 있습니다. 이 이미지는 Kubernetes, Swarm 또는 필요한 클라우드 서비스 컨테이너 인스턴스에서 애플리케이션을 실행하는 데 사용할 수 있습니다.
게시
아래 튜토리얼들은 Ktor 애플리케이션을 특정 클라우드 제공업체에 배포하는 방법을 보여줍니다:
SSL
Ktor 서버가 리버스 프록시(reverse proxy, Nginx 또는 Apache 등) 뒤에 위치하거나 서블릿 컨테이너(Tomcat 또는 Jetty) 내에서 실행되는 경우, SSL 설정은 리버스 프록시 또는 서블릿 컨테이너에 의해 관리됩니다. 필요한 경우 Java KeyStore를 사용하여 Ktor가 SSL을 직접 제공(serve)하도록 구성할 수 있습니다.
Ktor 애플리케이션이 서블릿 컨테이너 내부에 배포될 때는 SSL 설정이 적용되지 않음에 유의하십시오.