기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # QuickStart: Elastic Beanstalk에 Java 애플리케이션 배포 이 QuickStart 자습서에서는 Java 애플리케이션을 생성하고 AWS Elastic Beanstalk 환경에 배포하는 프로세스를 안내합니다. **프로덕션용으로 사용 불가** 예제는 설명용으로만 제공됩니다. 예제 애플리케이션을 프로덕션 환경에서 사용하지 마세요. **Topics** + [내 AWS 계정](#java-quickstart-aws-account) + [사전 조건](#java-quickstart-prereq) + [1단계: Java 애플리케이션 생성](#java-quickstart-create-app) + [2단계: 로컬에서 애플리케이션 실행](#java-quickstart-run-local) + [3단계: EB CLI를 사용하여 Java 애플리케이션 배포](#java-quickstart-deploy) + [4단계: Elastic Beanstalk에서 애플리케이션 실행](#java-quickstart-run-eb-ap) + [5단계: 정리](#java-tutorial-cleanup) + [AWS 애플리케이션을 위한 리소스](#java-quickstart-eb-resources) + [다음 단계](#java-quickstart-next-steps) + [Elastic Beanstalk 콘솔을 사용하여 배포](#java-quickstart-console) ## 내 AWS 계정 아직 AWS 고객이 아닌 경우 AWS 계정을 생성해야 합니다. 가입하면 Elastic Beanstalk 및 필요한 기타 AWS 서비스에 액세스할 수 있습니다. 이미 AWS 계정이 있는 경우 로 이동할 수 있습니다[사전 조건](#java-quickstart-prereq). ### AWS 계정 생성 #### 에 가입 AWS 계정 이 없는 경우 다음 단계를 AWS 계정완료하여 생성합니다. **에 가입하려면 AWS 계정** 1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)을 엽니다. 1. 온라인 지시 사항을 따르세요. 등록 절차 중 전화 또는 텍스트 메시지를 받고 전화 키패드로 확인 코드를 입력하는 과정이 있습니다. 에 가입하면 AWS 계정*AWS 계정 루트 사용자*이 생성됩니다. 루트 사용자에게는 계정의 모든 AWS 서비스 및 리소스에 액세스할 권한이 있습니다. 보안 모범 사례는 사용자에게 관리 액세스 권한을 할당하고, 루트 사용자만 사용하여 [루트 사용자 액세스 권한이 필요한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)을 수행하는 것입니다. AWS 는 가입 프로세스가 완료된 후 확인 이메일을 보냅니다. 언제든지 [https://aws.amazon.com/](https://aws.amazon.com/)으로 이동하고 **내 계정**을 선택하여 현재 계정 활동을 확인하고 계정을 관리할 수 있습니다. #### 관리자 액세스 권한이 있는 사용자 생성 에 가입한 후 일상적인 작업에 루트 사용자를 사용하지 않도록 관리 사용자를 AWS 계정보호 AWS IAM Identity Center, AWS 계정 루트 사용자활성화 및 생성합니다. **보안 AWS 계정 루트 사용자** 1. **루트 사용자를** 선택하고 AWS 계정 이메일 주소를 입력하여 계정 소유자[AWS Management Console](https://console.aws.amazon.com/)로에 로그인합니다. 다음 페이지에서 비밀번호를 입력합니다. 루트 사용자를 사용하여 로그인하는 데 도움이 필요하면 *AWS Sign-In 사용 설명서*의 [루트 사용자로 로그인](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial)을 참조하세요. 1. 루트 사용자의 다중 인증(MFA)을 활성화합니다. 지침은 *IAM 사용 설명서*의 [AWS 계정 루트 사용자(콘솔)에 대한 가상 MFA 디바이스 활성화를 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html). **관리자 액세스 권한이 있는 사용자 생성** 1. IAM Identity Center를 활성화합니다. 지침은 *AWS IAM Identity Center 사용 설명서*의 [AWS IAM Identity Center설정](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html)을 참조하세요. 1. IAM Identity Center에서 사용자에게 관리 액세스 권한을 부여합니다. 를 자격 증명 소스 IAM Identity Center 디렉터리 로 사용하는 방법에 대한 자습서는 사용 *AWS IAM Identity Center 설명서*[의 기본값으로 사용자 액세스 구성을 IAM Identity Center 디렉터리](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html) 참조하세요. **관리 액세스 권한이 있는 사용자로 로그인** + IAM IDentity Center 사용자로 로그인하려면 IAM Identity Center 사용자를 생성할 때 이메일 주소로 전송된 로그인 URL을 사용합니다. IAM Identity Center 사용자를 사용하여 로그인하는 데 도움이 필요하면 *AWS Sign-In 사용 설명서*[의 AWS 액세스 포털에 로그인](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html)을 참조하세요. **추가 사용자에게 액세스 권한 할당** 1. IAM Identity Center에서 최소 권한 적용 모범 사례를 따르는 권한 세트를 생성합니다. 지침은 *AWS IAM Identity Center 사용 설명서*의 [Create a permission set](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html)를 참조하세요. 1. 사용자를 그룹에 할당하고, 그룹에 Single Sign-On 액세스 권한을 할당합니다. 지침은 *AWS IAM Identity Center 사용 설명서*의 [그룹 추가](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html)를 참조하세요. ## 사전 조건 이 설명서의 절차를 수행하기 위해서는 실행 명령줄을 입력할 쉘 또는 터미널이 필요합니다. 명령은 프롬프트 기호(\$1)와 해당하는 경우 현재 디렉터리 이름 뒤에 리스트로 표시됩니다. ``` ~/eb-project$ this is a command this is output ``` Linux 및 macOS의 경우 선호하는 쉘과 패키지 관리자를 사용할 수 있습니다. Windows의 경우 [Linux용 Windows Subsystem을 설치](https://docs.microsoft.com/en-us/windows/wsl/install-win10)하여 Ubuntu 및 Bash의 Windows 통합 버전을 가져옵니다. ### EB CLI 또한 본 자습서는 Elastic Beanstalk 명령줄 인터페이스(EB CLI)를 사용합니다. EB CLI 설치 및 구성에 대한 자세한 내용은 [설정 스크립트를 사용하여 EB CLI 설치(권장)](eb-cli3.md#eb-cli3-install) 및 [EB CLI 구성](eb-cli3-configuration.md) 단원을 참조하세요. ### Java 및 Maven 로컬 시스템에 Amazon Corretto가 설치되어 있지 않은 경우 *Amazon Corretto 사용 설명서*의 [설치 지침](https://docs.aws.amazon.com/corretto/latest/corretto-21-ug/amazon-linux-install.html)에 따라 설치할 수 있습니다. 다음 명령을 실행하여 Java 설치를 확인합니다. ``` ~$ java -version ``` 이 자습서에서는 Maven을 사용합니다. Apache Maven Project 웹 사이트의 [다운로드](https://maven.apache.org/download.cgi) 및 [설치](https://maven.apache.org/install.html) 지침을 따릅니다. Maven에 관한 자세한 내용은 Apache Maven Project 웹 사이트에서 [Maven 사용자 센터](https://maven.apache.org/users/index.html)를 참조하세요. 다음 명령을 실행하여 Maven 설치를 확인합니다. ``` ~$ mvn -v ``` ## 1단계: Java 애플리케이션 생성 프로젝트 디렉터리를 만듭니다. ``` ~$ mkdir eb-java ~$ cd eb-java ``` 그 다음 Elastic Beanstalk를 사용하여 배포할 애플리케이션을 만듭니다. "Hello World" RESTful 웹 서비스를 만듭니다. 이 예제에서는 [Spring Boot](https://spring.io/projects/spring-boot) 프레임워크를 사용합니다. 이 애플리케이션은 포트 5000에서 리스너를 엽니다. 기본적으로 Elastic Beanstalk는 요청을 포트 5,000의 애플리케이션에 전달합니다. 다음 파일을 생성합니다. 이 파일은 간단한 Spring Boot 애플리케이션을 생성합니다. **Example `~/eb-java/src/main/java/com/example/Application.java`** ``` 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); } } ``` 이 파일은 여기에서 정의하는 문자열을 반환하는 매핑을 생성합니다. **Example `~/eb-java/src/main/java/com/example/Controller.java`** ``` 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 프로젝트 구성을 정의합니다. **Example `~/eb-java/pom.xml`** ``` 4.0.0 org.springframework.boot spring-boot-starter-parent 3.2.3 com.example BeanstalkJavaExample 1.0-SNAPSHOT 21 org.springframework.boot spring-boot-starter-data-rest org.springframework.boot spring-boot-maven-plugin ``` 이 속성 파일은 기본 포트를 5000으로 재정의합니다. 이 포트는 Elastic Beanstalk가 Java 애플리케이션을 위해 트래픽을 전송하는 기본 포트입니다. **Example `~/eb-java/application.properties`** ``` 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\$1’라는 텍스트가 표시됩니다. ## 3단계: EB CLI를 사용하여 Java 애플리케이션 배포 Java 애플리케이션을 Elastic Beanstalk에 배포하기 전에 사용자 디렉터리에서 빌드 애플리케이션을 정리하고 [Buildfile](java-se-buildfile.md) 및 [Procfile](java-se-procfile.md)을 생성하여 애플리케이션이 Elastic Beanstalk 환경에서 빌드되고 실행되는 방식을 제어해 보겠습니다. **배포를 위해 애플리케이션를 준비하고 구성하려면** 1. 빌드된 애플리케이션을 정리합니다. ``` ~/eb-java$ mvn clean ``` 1. `Buildfile`을 생성합니다. **Example `~/eb-java/Buildfile`** ``` build: mvn clean package ``` 이 `Buildfile`에서는 애플리케이션을 빌드하는 데 사용되는 명령을 지정합니다. Java용 `Buildfile` 애플리케이션을 포함하지 않는 경우 Elastic Beanstalk는 애플리케이션 빌드를 시도하지 않습니다. 1. `Procfile`을 생성합니다. **Example `~/eb-java/Procfile`** ``` web: java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar ``` 이 `Procfile`에서는 애플리케이션을 실행하는 데 사용되는 명령을 지정합니다. Java용 `Procfile` 애플리케이션을 포함하지 않는 경우 Elastic Beanstalk는 소스 번들의 루트에 JAR 파일이 하나 있다고 가정하고 `java -jar` 명령으로 실행을 시도합니다. 이제 애플리케이션을 빌드하고 시작할 구성 파일을 설정했으므로 애플리케이션을 배포할 준비가 되었습니다. **환경을 생성하고 Java 애플리케이션을 배포하려면** 1. **eb init** 명령으로 EB CLI 리포지토리를 초기화합니다. ``` ~/eb-java eb init -p corretto java-tutorial --region us-east-2 Application java-tutorial has been created. ``` 이 명령은 `java-tutorial`이라는 애플리케이션을 생성하고 최신 Java 플랫폼 버전을 통해 환경을 생성하도록 로컬 리포지토리를 구성합니다. 1. (선택 사항) SSH를 통해 애플리케이션을 실행하는 EC2 인스턴스에 연결할 수 있도록 **eb init**를 다시 실행하여 기본 키 페어를 구성합니다. ``` ~/eb-java$ eb init Do you want to set up SSH for your instances? (y/n): y Select a keypair. 1) my-keypair 2) [ Create new KeyPair ] ``` 키 페어가 이미 있는 경우 이를 선택하거나, 프롬프트에 따라 키 페어를 생성합니다. 프롬프트가 보이지 않거나 나중에 설정을 변경해야 하는 경우 **eb init -i**를 실행합니다. 1. 환경을 만들고 **eb create**로 해당 환경에 애플리케이션을 배포합니다. Elastic Beanstalk는 애플리케이션에 대한 zip 파일을 자동으로 빌드하고 포트 5000에서 시작합니다. ``` ~/eb-java$ eb create java-env ``` Elastic Beanstalk에서 환경을 생성하는 데 약 5분이 걸립니다. ## 4단계: Elastic Beanstalk에서 애플리케이션 실행 환경 생성 프로세스가 완료되면 **eb open**으로 웹 사이트를 엽니다. ``` ~/eb-java eb open ``` 축하합니다\$1 Elastic Beanstalk를 사용하여 Java 애플리케이션을 배포했습니다\$1 그러면 애플리케이션에 대해 생성된 도메인 이름을 사용하여 브라우저 창이 열립니다. ## 5단계: 정리 애플리케이션 작업을 완료하면 환경을 종료할 수 있습니다. Elastic Beanstalk는 환경과 연결된 모든 AWS 리소스를 종료합니다. EB CLI를 사용하여 Elastic Beanstalk 환경을 종료하려면 다음 명령을 실행하세요. ``` ~/eb-java$ eb terminate ``` ## AWS 애플리케이션을 위한 리소스 단일 인스턴스 애플리케이션을 생성했습니다. 이 애플리케이션은 단일 EC2 인스턴스를 사용하는 간단한 샘플 애플리케이션 역할을 하므로 로드 밸런싱이나 오토 스케일링이 필요하지 않습니다. 단일 인스턴스 애플리케이션의 경우 Elastic Beanstalk는 다음 AWS 리소스를 생성합니다. + **EC2 인스턴스** - 선택한 플랫폼에서 웹 앱을 실행하도록 구성된 Amazon EC2 가상 머신입니다. 특정 언어 버전, 프레임워크, 웹 컨테이너 또는 조합을 지원하도록 각 플랫폼마다 실행하는 소프트웨어, 구성 파일 및 스크립트 세트가 다릅니다. 대부분의 플랫폼에서는 웹 앱 앞의 웹 트래픽을 처리하고, 웹 앱으로 요청을 전달하고, 정적 자산을 제공하고, 액세스 및 오류 로그를 생성하는 역방향 프록시로 Apache 또는 nginx를 사용합니다. + **인스턴스 보안 그룹** - 포트 80에서 수신 트래픽을 허용하도록 구성된 Amazon EC2 보안 그룹입니다. 이 리소스를 통해 로드 밸런서의 HTTP 트래픽이 웹 앱을 실행하는 EC2 인스턴스에 도달할 수 있습니다. 기본적으로 다른 포트에서는 트래픽이 허용되지 않습니다. + **Amazon S3 버킷(Amazon S3 bucket)** - Elastic Beanstalk 사용 시 생성된 소스 코드, 로그 및 기타 아티팩트의 스토리지 위치입니다. + **Amazon CloudWatch 경보** - 환경의 인스턴스에 대한 로드를 모니터링하는 두 개의 CloudWatch 경보로, 로드가 너무 높거나 너무 낮은 경우 트리거됩니다. 경보가 트리거되면 이에 대한 응답으로 Auto Scaling 그룹이 스케일 업 또는 축소됩니다. + **CloudFormation 스택** - Elastic Beanstalk는 CloudFormation 를 사용하여 환경에서 리소스를 시작하고 구성 변경 사항을 전파합니다. 리소스는 [CloudFormation 콘솔](https://console.aws.amazon.com/cloudformation)에서 볼 수 있는 템플릿에서 정의됩니다. + **도메인 이름(Domain name)** - **subdomain*.*region*.elasticbeanstalk.com* 형식으로 웹 앱으로 라우팅되는 도메인 이름입니다. 이러한 모든 리소스는 Elastic Beanstalk에서 관리합니다. 사용자가 환경을 종료하면 Elastic Beanstalk는 환경에 있는 모든 리소스를 종료합니다. ## 다음 단계 애플리케이션을 실행하는 환경이 있으면 언제든 다른 애플리케이션 또는 애플리케이션의 새 버전을 배포할 수 있습니다. EC2 인스턴스를 프로비저닝하거나 다시 시작할 필요가 없기 때문에 새 애플리케이션 버전을 매우 빠르게 배포할 수 있습니다. Elastic Beanstalk 콘솔을 사용하여 새로운 환경을 탐색할 수도 있습니다. 자세한 단계는 이 가이드의 *시작하기* 장의 [환경 탐색](GettingStarted.md#GettingStarted.Explore)을 참조하세요. **더 많은 자습서 보기** 다른 예제 애플리케이션으로 다른 자습서를 사용하려는 경우 [샘플 애플리케이션 및 자습서](java-getstarted.md) 단원을 참조하세요. 샘플 애플리케이션을 하나 이상 배포하고 Java 애플리케이션을 로컬로 개발하고 실행할 준비가 되면 [Java 개발 환경 설정](java-development-environment.md) 단원을 참조하세요. ## Elastic Beanstalk 콘솔을 사용하여 배포 Elastic Beanstalk 콘솔을 사용하여 샘플 애플리케이션을 시작할 수도 있습니다. 자세한 단계는 이 가이드의 *시작하기* 장의 [예제 애플리케이션 생성](GettingStarted.md#GettingStarted.CreateApp)을 참조하세요.