Elastic Beanstalk Tomcat 플랫폼 사용

이 항목에서는 Elastic Beanstalk Tomcat 플랫폼에서 실행되는 자바 애플리케이션을 구성, 빌드 및 실행하는 방법을 설명합니다.

AWS Elastic Beanstalk Tomcat 플랫폼은 Tomcat 웹 컨테이너에서 실행할 수 있는 Java 웹 애플리케이션을 위한 플랫폼 버전 세트입니다. Tomcat은 nginx 프록시 서버 뒤에서 실행됩니다. 각 플랫폼 브랜치는 Tomcat의 메이저 버전에 해당합니다.

실행 환경 구성을 수정하기 위해 Elastic Beanstalk 콘솔의 구성 옵션을 사용할 수 있습니다. 저장된 구성을 사용해 설정을 저장하면 환경 종료 시 구성이 훼손되지 않도록 할 수 있으며, 추후 기타 환경에서도 적용할 수 있습니다.

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

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

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

동일한 웹 서버에서 여러 애플리케이션을 실행하려면 여러 WAR 파일을 단일 소스 번들로 번들링하면 됩니다. 다중 WAR 소스 번들의 각 응용 프로그램은 의 이름에 따라 루트 경로 (ROOT.war에서 실행myapp.elasticbeanstalk.com/) 또는 바로 아래 경로 (app2.war실행 위치myapp.elasticbeanstalk.com/app2/) 에서 실행됩니다. WAR 단일 WAR 소스 번들에서는 애플리케이션이 항상 루트 경로에서 실행됩니다.

Elastic Beanstalk 콘솔에 적용된 설정이 구성 파일에 적용된 동일한 설정(있는 경우)을 덮어씁니다. 이렇게 함으로써 구성 파일은 기본 설정을 갖는 동시에 콘솔에서 환경 특정 설정으로 설정을 덮어 쓸 수 있습니다. 우선 적용 및 설정을 변경하는 다른 방법에 대한 자세한 내용은 구성 옵션 단원을 참조하십시오.

Elastic Beanstalk Linux 기반 플랫폼을 확장할 수 있는 다양한 방법에 대한 자세한 내용은 Elastic Beanstalk Linux 플랫폼 확장 단원을 참조하세요.

Tomcat 환경 구성

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

Elastic Beanstalk 콘솔을 사용하여 Amazon S3에 대한 로그 교체를 활성화하고, 애플리케이션이 환경에서 읽을 수 있도록 변수를 구성할 수 있습니다.

컨테이너 옵션

다음과 같은 플랫폼별 옵션을 지정할 수 있습니다.

JVM컨테이너 옵션

Java 가상 머신 (JVM) 의 힙 크기에 따라 가비지 컬렉션이 발생하기 전에 애플리케이션이 메모리에 생성할 수 있는 객체 수가 결정됩니다. 초기 JVM 힙 크기 (-Xms option) 및 최대 JVM 힙 크기 (-Xmx옵션) 를 수정할 수 있습니다. 초기 힙 크기가 클수록 가비지 수집이 수행되기 전에 생성되는 객체 수가 늘어나지만 가비지 수집기가 힙을 압축하는 데 더 오랜 시간이 걸립니다. 최대 힙 크기는 작업량이 많은 동안 힙을 확장할 때 JVM 할당할 수 있는 최대 메모리 양을 지정합니다.

영구 생성은 클래스 정의 및 관련 메타데이터를 저장하는 JVM 힙의 한 부분입니다. 영구 생성의 크기를 수정하려면 최대 크기 (-XX:MaxPermSize) 옵션에 새 JVM PermGen 크기를 입력합니다. 이 설정은 Java 7 및 그 이전 버전에만 적용됩니다. 이 옵션은 JDK 8에서 더 이상 사용되지 않으며 MaxMetaspace크기 () 옵션으로 대체되었습니다. -XX:MaxMetaspaceSize

Elastic Beanstalk 플랫폼 및 그 구성 요소에 대한 자세한 내용은 AWS Elastic Beanstalk  플랫폼 가이드의 지원되는 플랫폼을 참조하십시오.

로그 옵션

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

정적 파일

성능을 향상시키려면 Static files 섹션을 사용하여 웹 애플리케이션 내의 디렉터리 집합에서 정적 파일 (예: 이미지) 을 제공하도록 프록시 서버를 구성할 수 있습니다. HTML 각 디렉터리의 디렉터리 매핑 가상 경로를 설정합니다. 지정된 경로에서 프록시 서버가 파일 요청을 수신받으면 요청을 애플리케이션으로 라우팅하지 않고 파일을 직접 제공합니다.

구성 파일 또는 Elastic Beanstalk 콘솔을 사용하여 정적 파일을 구성하는 방법에 대한 자세한 내용은 정적 파일 제공 단원을 참조하세요.

환경 속성

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

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

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

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

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

Tomcat 구성 네임스페이스

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

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

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

option_settings:
  aws:elasticbeanstalk:container:tomcat:jvmoptions:
    Xms: 512m
    JVM Options: '-Xmn128m'
  aws:elasticbeanstalk:application:environment:
    API_ENDPOINT: mywebapi.zkpexsjtmd.us-west-2.elasticbeanstalk.com
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache

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

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    GzipCompression: 'true'
    ProxyServer: nginx

zip -ur your_application.war .ebextensions