메뉴
AWS Elastic Beanstalk
개발자 안내서

AWS Elastic Beanstalk Tomcat 플랫폼 사용

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

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

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

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

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

동일한 웹 서버에서 애플리케이션을 여러 개 실행하기 위해 단일 원본 번들로 여러 WAR 파일을 묶을 수 있습니다. 여러 WAR 원본 번들의 각 애플리케이션은 루트 경로에서 실행되거나(myapp.elasticbeanstalk.com/에서 ROOT.war 실행) 루트 경로 바로 아래에 있는 경로에서 실행됩니다(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에서 할당할 수 있는 최대 메모리 양을 지정합니다.

참고

사용 가능한 메모리는 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 인스턴스에 대한 로그 파일을 복사해야 하는지 지정합니다.

환경 속성

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

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

참고

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

Java 애플리케이션에서 Amazon Relational Database Service(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를 사용하여 구성 옵션을 설정할 수도 있습니다. 자세한 내용은 구성 옵션를 참조하십시오.