AWS Elastic Beanstalk
개발자 안내서

AWS Elastic Beanstalk Tomcat 플랫폼 사용

AWS Elastic Beanstalk Tomcat 플랫폼은 Tomcat 웹 컨테이너에서 실행할 수 있는 Java 웹 애플리케이션을 위한 환경 구성 집합입니다. 각 구성은 Java 8 with Tomcat 8 등과 같은 메이저 Tomcat 버전에 대한 것입니다.

AWS Management 콘솔에서 실행 환경의 구성 수정을 위해 플랫폼별 구성 옵션을 사용할 수 있습니다. 환경 종료 시 구성이 손실되지 않도록 하려면 저장된 구성을 이용해 설정을 저장하고 나중에 다른 환경에 적용할 수 있습니다.

소스 코드에 설정을 저장하기 위해 구성 파일을 포함할 수 있습니다. 구성 파일의 설정은 환경을 만들거나 애플리케이션을 배포할 때마다 적용됩니다. 구성 파일을 사용해 패키지를 설치하고, 스크립트를 실행하고, 배포 중에 다른 인스턴스 사용자 지정 작업을 수행할 수도 있습니다.

Elastic Beanstalk Tomcat 플랫폼 구성에는 요청을 애플리케이션으로 전달하는 역방향 프록시가 포함되어 있습니다. 기본 서버는 Apache HTTP Server Version 2.4입니다. 구성 옵션을 사용하여 기존 Apache HTTP Server Version 2.2를 대신 사용하도록 또는 nginx를 사용하도록 Elastic Beanstalk를 구성할 수 있습니다. 또한 Elastic Beanstalk에서는 애플리케이션에 대한 로드를 줄이기 위해 소스 코드의 폴더에서 정적 자산을 제공하도록 프록시 서버를 구성하는 구성 옵션을 제공합니다. 고급 시나리오의 경우 소스 번들에 고유한 include your own .conf 파일을 포함시켜 Elastic Beanstalk의 프록시 구성을 확장하거나 완전히 덮어쓸 수 있습니다.

Java 애플리케이션을 특정 구조로 웹 애플리케이션 아카이브(WAR) 파일에 패키지로 묶어야 합니다. 필요한 구조 및 이 구조가 프로젝트 디렉터리의 구조와 연결되는 방법에 대한 자세한 내용은 프로젝트 폴더 구성 단원을 참조하십시오.

동일한 웹 서버에서 애플리케이션을 여러 개 실행하기 위해 단일 소스 번들로 여러 WAR 파일을 묶을 수 있습니다. 여러 WAR 소스 번들의 각 애플리케이션은 WAR의 이름에 따라 루트 경로에서 실행되거나(myapp.elasticbeanstalk.com/에서 ROOT.war 실행), 루트 경로 바로 아래에 있는 경로에서 실행(myapp.elasticbeanstalk.com/app2/에서 app2.war 실행)됩니다. 단일 WAR 소스 번들에서 애플리케이션은 항상 루트 경로에서 실행됩니다.

AWS Management 콘솔에 적용된 설정은 구성 파일의 동일한 설정(있는 경우)을 재정의합니다. 그러면 구성 파일에서 기본 설정을 사용하고 콘솔에서 환경별 설정으로 이 설정을 재정의할 수 있습니다. 우선 적용 및 설정을 변경하는 다른 방법에 대한 자세한 내용은 구성 옵션 단원을 참조하십시오.

Tomcat 환경 구성

Elastic Beanstalk의 Tomcat 플랫폼 구성의 경우 Elastic Beanstalk에서는 모든 환경에 대해 제공하는 표준 옵션 이외에도 플랫폼별 옵션 몇 가지를 제공합니다. 이러한 옵션을 사용하면 환경의 웹 서버에서 실행되는 Java 가상 머신(JVM)을 구성하고, 애플리케이션에 정보 구성 문자열을 제공하는 시스템 속성을 정의할 수 있습니다.

AWS Management 콘솔을 사용하여 Amazon S3에 대한 로그 순환을 활성화하고, 애플리케이션이 환경에서 읽을 수 있는 환경 변수를 구성할 수 있습니다.

Elastic Beanstalk 콘솔에서 Tomcat 환경을 구성하려면

  1. Elastic Beanstalk 콘솔을 엽니다.

  2. 해당 환경의 관리 페이지로 이동합니다.

  3. [Configuration]을 선택합니다.

  4. [Software] 구성 카드에서 [Modify]를 선택합니다.

JVM 컨테이너 옵션

Java 가상 머신(JVM)의 힙 크기는 가비지 수집이 수행되기 전에 애플리케이션이 메모리 내에서 생성할 수 있는 객체 수를 결정합니다. [Initial JVM Heap Size (-Xms argument)] 및 [Maximum JVM Heap Size (-Xmx argument)]를 수정할 수 있습니다. 초기 힙 크기가 클수록 가비지 수집이 수행되기 전에 생성되는 객체 수가 늘어나지만 가비지 수집기가 힙을 압축하는 데 더 오랜 시간이 걸립니다. 최대 힙 크기는 로드가 많이 발생하는 작업 중 힙을 확장하는 경우 JVM에서 할당할 수 있는 최대 메모리 양을 지정합니다.

참고

사용 가능한 메모리는 Amazon EC2 인스턴스 유형에 따라 달라집니다. Elastic Beanstalk 환경에서 사용할 수 있는 EC2 인스턴스 유형에 대한 자세한 내용은 Linux 인스턴스용 Amazon Elastic Compute Cloud 사용 설명서인스턴스 유형을 참조하십시오.

영구 생성은 클래스 정의 및 연결된 메타데이터를 저장하는 JVM 힙의 섹션입니다. 영구 생성의 크기를 수정하려면 [Maximum JVM PermGen Size (-XX:MaxPermSize argument)] 필드에 새 크기를 입력합니다. 이 설정은 Java 7 및 그 이전 버전에만 적용됩니다.

로그 옵션

로그 옵션 섹션에는 다음 두 가지 설정이 있습니다.

  • [Instance profile]– 애플리케이션과 연결된 Amazon S3 버킷에 액세스할 권한이 있는 인스턴스 프로파일을 지정합니다.

  • [Enable log file rotation to Amazon S3]–애플리케이션에 연결된 Amazon S3 버킷에 애플리케이션의 Amazon EC2 인스턴스에 대한 로그 파일을 복사해야 하는지 지정합니다.

정적 파일

성능을 향상하려면 웹 애플리케이션 내부의 디렉터리 집합에서 정적 파일(예: HTML 또는 이미지)을 제공하도록 프록시 서버를 구성할 수 있습니다. 프록시 서버가 지정된 경로에서 파일 요청을 수신하면 요청을 애플리케이션으로 라우팅하는 대신 파일을 직접 제공합니다. Modify software(소프트웨어 수정) 구성 페이지의 Static Files(정적 파일) 섹션에서 가상 경로 및 디렉터리 매핑을 설정할 수 있습니다. 매핑을 추가하면 다른 항목을 추가할 수 있도록 별도의 행이 나타납니다. 매핑을 제거하려면 [Remove]를 클릭합니다.

 Elastic Beanstalk 콘솔의 소프트웨어 수정 구성 페이지에서 정적 파일 구성

Static Files(정적 파일) 섹션이 표시되지 않는 경우 구성 옵션을 사용하여 최소 하나 이상의 매핑을 추가해야 합니다. 예를 들어, 다음 구성 파일은 소스 번들의 최상위 디렉터리를 사용하여 두 개의 가상 경로 및 디렉터리 매핑을 추가합니다.

예 .ebextensions/java-tomcat-static-files.config

option_settings: aws:elasticbeanstalk:environment:proxy:staticfiles: /html: statichtml /images: staticimages

환경 속성

환경 속성 섹션에서, 애플리케이션을 실행하는 Amazon EC2 인스턴스에서 환경 속성 설정을 지정할 수 있습니다. 환경 속성은 카-값 페어로 애플리케이션에 전달됩니다.

Tomcat 플랫폼은 연결 문자열을 외부 데이터베이스에 전달하기 위한 Tomcat 환경의 자리 표시자 속성인 JDBC_CONNECTION_STRING을 정의합니다.

참고

RDS DB 인스턴스를 환경에 연결하는 경우 Elastic Beanstalk에서 제공하는 Amazon RDS(Amazon Relational Database Service) 환경 속성에서 JDBC 연결 문자열을 동적으로 구성합니다. JDBC_CONNECTION_STRING은 Elastic Beanstalk을 사용하여 프로비저닝되지 않은 데이터베이스 인스턴스에만 사용합니다.

Java 애플리케이션에서 Amazon RDS 사용에 대한 자세한 내용은 Amazon RDS DB 인스턴스를 Java 애플리케이션 환경에 추가 단원을 참조하십시오.

Elastic Beanstalk에서 실행하는 Tomcat 환경에서 System.getProperty()를 사용하여 환경 변수에 액세스할 수 있습니다. 예를 들어 다음 코드로 변수에 대한 API_ENDPOINT이라는 속성을 읽을 수 있습니다.

String endpoint = System.getProperty("API_ENDPOINT");

자세한 내용은 환경 속성 및 기타 소프트웨어 설정를 참조하십시오.

Tomcat 구성 네임스페이스

구성 파일을 사용하여 구성 옵션을 설정하고 배포 중 기타 인스턴스 구성 작업을 수행할 수 있습니다. 구성 옵션은 Elastic Beanstalk 서비스 또는 사용 중인 플랫폼에서 정의할 수 있으며 네임스페이스로 구성할 수 있습니다.

Tomcat 플랫폼에서는 모든 Elastic Beanstalk 환경에 대해 지원되는 옵션 이외에도 다음 네임스페이스의 옵션을 지원합니다.

  • aws:elasticbeanstalk:container:tomcat:jvmoptions – JVM 설정을 수정합니다. 이 네임스페이스의 옵션은 다음과 같이 관리 콘솔의 옵션에 해당합니다.

    • XmsJVM 명령줄 옵션

    • XmxJVM 명령줄 옵션

    • XX:MaxPermSize최대 JVM 영구 생성 크기

    • JVM OptionsJVM 명령줄 옵션

  • aws:elasticbeanstalk:environment:proxy – 프록시 서버를 선택하고 응답 압축을 구성합니다.

  • aws:elasticbeanstalk:environment:proxy:staticfiles – 소스 번들의 경로에서 정적 자산을 제공하도록 프록시를 구성합니다.

다음 예제 구성 파일에서는 Tomcat 관련 구성 옵션의 사용을 보여 줍니다.

예 .ebextensions/tomcat-settings.config

option_settings: aws:elasticbeanstalk:container:tomcat:jvmoptions: Xms: 512m Xmx: 512m JVM Options: '-Xmn128m' aws:elasticbeanstalk:application:environment: API_ENDPOINT: mywebapi.zkpexsjtmd.us-west-2.elasticbeanstalk.com aws:elasticbeanstalk:environment:proxy: GzipCompression: 'true' ProxyServer: nginx aws:elasticbeanstalk:environment:proxy:staticfiles: /pub: public

Elastic Beanstalk는 환경을 사용자 지정할 수 있는 다양한 구성 옵션을 제공합니다. 구성 파일 외에 콘솔, 저장된 구성, EB CLI 또는 AWS CLI를 사용하여 구성 옵션을 설정할 수도 있습니다. 자세한 내용은 구성 옵션를 참조하십시오.