AWS Elastic Beanstalk에 Ktor 애플리케이션 배포하기
시작 프로젝트: embedded-server 또는 engine-main
최종 프로젝트: aws-elastic-beanstalk
이 튜토리얼에서는 Ktor 애플리케이션을 준비하고 Amazon Web Services(AWS) Elastic Beanstalk에 배포하는 방법을 알아봅니다. Ktor 서버를 생성한 방식에 따라 다음 시작 프로젝트 중 하나를 사용할 수 있습니다.
AWS Elastic Beanstalk에 Java 애플리케이션을 배포하는 방법에 대한 자세한 내용은 Elastic Beanstalk 문서를 참조하세요.
사전 준비 사항
이 튜토리얼을 시작하기 전에 AWS 계정을 생성해야 합니다.
샘플 애플리케이션 복제하기
샘플 애플리케이션을 열려면 다음 단계를 따르세요.
- Ktor 문서 저장소를 복제(clone)하고 codeSnippets 프로젝트를 엽니다.
- 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매개변수 값을 변경합니다.kotlinfun 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를 사용하여 AWS Elastic Beanstalk에 애플리케이션을 배포하는 방법을 보여줍니다. fat JAR를 생성하려면 Ktor 플러그인을 적용해야 합니다.
build.gradle.kts 파일을 열고 plugins {} 블록에 플러그인을 추가합니다.
plugins {
alias(ktorLibs.plugins.ktor)
}그런 다음 메인 애플리케이션 클래스가 구성되어 있는지 확인합니다.
application {
mainClass.set("io.ktor.server.netty.EngineMain")
}Fat JAR 빌드하기
Fat JAR를 빌드하려면 터미널을 열고 Ktor 플러그인에서 제공하는 buildFatJar 작업을 실행합니다.
./gradlew :aws-elastic-beanstalk:buildFatJargradlew.bat :aws-elastic-beanstalk:buildFatJar이 빌드가 완료되면 build/libs 디렉터리에 aws-elastic-beanstalk-all.jar 파일이 생성된 것을 확인할 수 있습니다.
애플리케이션 배포하기
애플리케이션을 배포하려면 AWS Management Console에 로그인하고 다음 단계를 진행하세요.
- AWS services 그룹에서 Elastic Beanstalk 서비스를 엽니다.
- 열린 페이지에서 Create Application을 클릭합니다.
- 다음과 같이 애플리케이션 설정을 지정합니다.
- 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를 선택합니다. 파일이 업로드될 때까지 기다립니다.
- 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
