Open AIDoc

한국어

简体中文
繁體中文
日本語

한국어

简体中文
繁體中文
日本語

Appearance

AWS Elastic Beanstalk ​

시작 프로젝트: embedded-server 또는 engine-main

최종 프로젝트: aws-elastic-beanstalk

이 튜토리얼에서는 Ktor 애플리케이션을 준비하고 AWS Elastic Beanstalk에 배포하는 방법을 보여줍니다. Ktor 서버를 생성하는 방식에 따라 다음 시작 프로젝트 중 하나를 사용할 수 있습니다.

Java 애플리케이션 배포에 대한 자세한 내용은 Elastic Beanstalk 문서에서 확인할 수 있습니다.

사전 준비 사항 ​

이 튜토리얼을 시작하기 전에 AWS 계정을 생성해야 합니다.

샘플 애플리케이션 클론 ​

샘플 애플리케이션을 열려면 다음 단계를 따르세요.

  1. Ktor 문서 저장소를 클론하고 codeSnippets 프로젝트를 엽니다.
  2. embedded-server 또는 engine-main 샘플을 엽니다. 이 샘플들은 코드에서 직접 설정하거나 설정 파일을 사용하는 등 Ktor 서버를 생성하고 구성하는 서로 다른 접근 방식을 보여줍니다. 이러한 프로젝트를 배포할 때 유일한 차이점은 들어오는 요청을 수신하는 데 사용되는 포트를 지정하는 방식입니다.

애플리케이션 준비 ​

1단계: 포트 구성 ​

먼저, 들어오는 요청을 수신하는 데 사용되는 포트를 지정해야 합니다. Elastic Beanstalk은 포트 5000을 통해 애플리케이션으로 요청을 전달합니다. 필요에 따라 PORT 환경 변수를 설정하여 기본 포트를 오버라이드할 수 있습니다. Ktor 서버를 구성한 방식에 따라 다음 방법 중 하나로 포트를 구성할 수 있습니다.

  • 서버 구성이 코드에 지정된 embedded-server 샘플을 선택한 경우, System.getenv를 사용하여 환경 변수 값을 가져오거나 환경 변수가 지정되지 않은 경우 기본값인 _5000_을 사용하도록 할 수 있습니다. src/main/kotlin/com/example 폴더에 있는 Application.kt 파일을 열고 아래와 같이 embeddedServer 함수의 port 매개변수 값을 변경합니다.

    kotlin
    fun main() {
   embeddedServer(Netty, port = (System.getenv("PORT")?:"5000").toInt()) {
   // ...
   }.start(wait = true)
}

  • 서버 구성이 application.conf 파일에 지정된 engine-main 샘플을 선택한 경우, ${ENV} 구문을 사용하여 port 매개변수에 환경 변수를 할당할 수 있습니다. src/main/resources에 있는 application.conf 파일을 열고 아래와 같이 업데이트합니다.

    ktor {
    deployment {
        port = 5000
        port = ${?PORT}
    }
}

2단계: Ktor 플러그인 적용 ​

이 튜토리얼에서는 fat JAR를 사용하여 Elastic Beanstalk에 애플리케이션을 배포하는 방법을 보여줍니다. fat JAR를 생성하려면 Ktor 플러그인을 적용해야 합니다. build.gradle.kts 파일을 열고 plugins 블록에 플러그인을 추가합니다.

groovy
plugins {
    id("io.ktor.plugin") version "3.4.3"
}

그런 다음, 메인 애플리케이션 클래스가 구성되어 있는지 확인합니다.

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

Fat JAR 빌드 ​

Fat JAR를 빌드하려면 터미널을 열고 Ktor 플러그인에서 제공하는 buildFatJar 태스크를 실행합니다.

빌드가 완료되면 build/libs 디렉토리에 aws-elastic-beanstalk-all.jar 파일이 생성된 것을 확인할 수 있습니다.

애플리케이션 배포 ​

애플리케이션을 배포하려면 AWS 관리 콘솔(AWS Management Console)에 로그인하고 다음 단계를 따르세요.

  1. AWS 서비스 그룹에서 Elastic Beanstalk 서비스를 엽니다.
  2. 열린 페이지에서 Create Application을 클릭합니다.
  3. 다음 애플리케이션 설정을 지정합니다.
    • Application name: 애플리케이션 이름을 지정합니다 (예: Sample Ktor app).
    • Platform: 목록에서 _Java_를 선택합니다.
    • Platform branch: _Corretto 11 running on 64bit Amazon Linux 2_를 선택합니다.
    • Application code: _Upload your code_를 선택합니다.
    • Source code origin: _Local file_을 선택합니다. 그런 다음 Choose file 버튼을 클릭하고 이전 단계에서 생성한 Fat JAR를 선택합니다. 파일이 업로드될 때까지 기다립니다.
  4. Create application 버튼을 클릭하고 Beanstalk이 환경을 생성하고 애플리케이션을 게시할 때까지 몇 분 정도 기다립니다.
    INFO    Instance deployment completed successfully.
INFO    Application available at Samplektorapp-env.eba-bnye2kpu.us-east-2.elasticbeanstalk.com.
INFO    Successfully launched environment: Samplektorapp-env

Copyright © 2026 Open AIDoc.