QuickStart: Elastic Beanstalk에 Java 애플리케이션 배포

QuickStart 자습서에서는 AWS Elastic Beanstalk 환경을 대상으로 Java 애플리케이션을 생성해 배포하는 절차를 안내합니다.

AWS 계정

아직 AWS 고객이 아닌 경우 AWS 계정을 만듭니다. 가입하면 Elastic Beanstalk는 물론 필요한 다른 AWS 서비스에도 액세스할 수 있습니다.

AWS 계정이 이미 있는 경우 사전 조건 단계로 건너뛸 수 있습니다.

사전 조건

이 설명서의 절차를 수행하기 위해서는 실행 명령줄을 입력할 쉘 또는 터미널이 필요합니다. 명령은 프롬프트 기호($)와 해당하는 경우 현재 디렉터리 이름 뒤에 리스트로 표시됩니다.

~/eb-project$ this is a command
this is output

Linux 및 macOS의 경우 선호하는 쉘과 패키지 관리자를 사용할 수 있습니다. Windows의 경우 Linux용 Windows Subsystem을 설치하여 Ubuntu 및 Bash의 Windows 통합 버전을 가져옵니다.

EB CLI

또한 본 자습서는 Elastic Beanstalk 명령줄 인터페이스(EB CLI)를 사용합니다. EB CLI 설치 및 구성에 대한 자세한 내용은 Elastic Beanstalk 명령줄 인터페이스 설치 및 EB CLI 구성 단원을 참조하세요.

Java 및 Maven

로컬 시스템에 Amazon Corretto가 설치되어 있지 않은 경우 Amazon Corretto 사용 설명서의 설치 지침에 따라 설치할 수 있습니다.

다음 명령을 실행하여 Java 설치를 확인합니다.

~$ java -version 

이 자습서에서는 Maven을 사용합니다. Apache Maven Project 웹 사이트의 다운로드 및 설치 지침을 따릅니다. Maven에 관한 자세한 내용은 Apache Maven Project 웹 사이트에서 Maven 사용자 센터를 참조하세요.

다음 명령을 실행하여 Maven 설치를 확인합니다.

~$ mvn -v

1단계: Java 애플리케이션 생성

프로젝트 디렉터리를 만듭니다.

~$ mkdir eb-java
~$ cd eb-java

그 다음 Elastic Beanstalk를 사용하여 배포할 애플리케이션을 만듭니다. "Hello World" RESTful 웹 서비스를 만듭니다.

이 예제에서는 Spring Boot 프레임워크를 사용합니다. 이 애플리케이션은 포트 5000에서 리스너를 엽니다. 기본적으로 Elastic Beanstalk는 요청을 포트 5,000의 애플리케이션에 전달합니다.

다음 파일을 생성합니다.

이 파일은 간단한 Spring Boot 애플리케이션을 생성합니다.

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

이 파일은 여기에서 정의하는 문자열을 반환하는 매핑을 생성합니다.

package com.example;
    
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
    
@RestController
public class Controller {
    
    @GetMapping("/")
    public String index() {
       return "Hello Elastic Beanstalk!";
    }
}

이 파일은 Maven 프로젝트 구성을 정의합니다.

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.3</version>
  </parent>

  <groupId>com.example</groupId>
  <artifactId>BeanstalkJavaExample</artifactId>
  <version>1.0-SNAPSHOT</version>

  <properties>
    <java.version>21</java.version>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-rest</artifactId>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>

</project>

이 속성 파일은 기본 포트를 5000으로 재정의합니다. 이 포트는 Elastic Beanstalk가 Java 애플리케이션을 위해 트래픽을 전송하는 기본 포트입니다.

server.port=5000

2단계: 로컬에서 애플리케이션 실행

다음 명령을 사용하여 Spark 애플리케이션을 패키징합니다.

~/eb-java$ mvn clean package

다음 명령을 실행하여 로컬에서 애플리케이션을 실행합니다.

~/eb-java$ java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar

애플리케이션이 실행되는 동안 브라우저에서 http://127.0.0.1:5000/으로 이동합니다. ‘Hello Elastic Beanstalk!’라는 텍스트가 표시됩니다.

3단계: EB CLI를 사용하여 Java 애플리케이션 배포

Java 애플리케이션을 Elastic Beanstalk에 배포하기 전에 사용자 디렉터리에서 빌드 애플리케이션을 정리하고 Buildfile 및 Procfile을 생성하여 애플리케이션이 Elastic Beanstalk 환경에서 빌드되고 실행되는 방식을 제어해 보겠습니다.

이제 애플리케이션을 빌드하고 시작할 구성 파일을 설정했으므로 애플리케이션을 배포할 준비가 되었습니다.

4단계: Elastic Beanstalk에서 애플리케이션 실행

환경 생성 프로세스가 완료되면 eb open으로 웹 사이트를 엽니다.

~/eb-java eb open

축하합니다! Elastic Beanstalk를 사용하여 Java 애플리케이션을 배포했습니다! 그러면 애플리케이션에 대해 생성된 도메인 이름을 사용하여 브라우저 창이 열립니다.

5단계: 정리

애플리케이션 작업을 완료하면 환경을 종료할 수 있습니다. Elastic Beanstalk에서 환경과 연결된 모든 AWS 리소스를 종료합니다.

EB CLI를 사용하여 Elastic Beanstalk 환경을 종료하려면 다음 명령을 실행하세요.

~/eb-java$ eb terminate

애플리케이션을 위한 AWS 리소스

단일 인스턴스 애플리케이션을 생성했습니다. 이 애플리케이션은 단일 EC2 인스턴스를 사용하는 간단한 샘플 애플리케이션 역할을 하므로 로드 밸런싱이나 오토 스케일링이 필요하지 않습니다. 단일 인스턴스 애플리케이션의 경우 Elastic Beanstalk는 다음 AWS 리소스를 생성합니다.

이러한 모든 리소스는 Elastic Beanstalk에서 관리합니다. 사용자가 환경을 종료하면 Elastic Beanstalk는 환경에 있는 모든 리소스를 종료합니다.

다음 단계

애플리케이션을 실행하는 환경이 있으면 언제든 다른 애플리케이션 또는 애플리케이션의 새 버전을 배포할 수 있습니다. EC2 인스턴스를 프로비저닝하거나 다시 시작할 필요가 없기 때문에 새 애플리케이션 버전을 매우 빠르게 배포할 수 있습니다. Elastic Beanstalk 콘솔을 사용하여 새 환경을 탐색할 수도 있습니다. 자세한 단계는 이 가이드의 시작하기 장의 환경 탐색을 참조하세요.

샘플 애플리케이션을 하나 이상 배포하고 Java 애플리케이션을 로컬로 개발하고 실행할 준비가 되면 Java 개발 환경 설정 단원을 참조하세요.

Elastic Beanstalk 콘솔을 사용하여 배포

Elastic Beanstalk 콘솔을 사용하여 샘플 애플리케이션을 시작할 수도 있습니다. 자세한 단계는 이 가이드의 시작하기 장의 예제 애플리케이션 생성을 참조하세요.