본 Tomcat 애플리케이션은 AWS Elastic Beanstalk 환경에서 J2EE 애플리케이션이 RDS를 사용하는 방법을 보여줍니다. 이 프로젝트에는 서블릿, JSP, 심플 태그(simple tag) 지원, 태그 파일(tag file), JDBC, SQL, Log4J, 부트스트랩(Bootstrap), Jackson 과 Elastic Beanstalk 환경 파일들이 포함되어 있습니다.

• Elastic Beanstalk 학습 리스소
• 설명 영상: AWS re:Invent 2017: Manage Your Applications with AWS Elastic Beanstalk (DEV305)
• 자습서
• Github 샘플코드

Java 8 SDK 를 설치합니다. Java 컴파일러는 빌드 스크립트를 실행하기 위해 필요합니다.

리눅스에서 설치 참고

• Amazon Linux AMI 2018.03.0 (HVM) 사용시

sudo yum install -y java-1.8.0-openjdk-devel.x86_64
sudo /usr/sbin/alternatives --config java
sudo yum remove java-1.7.0-openjdk

# gradle 설치
sudo yum install gradle

• Ubuntu(16.04) 사용시

sudo apt-get install java-1.8.0-openjdk-devel.x86_64 -y

# gradle 설치
sudo apt-get install gradle -y

앱 앱을 로컬 환경에서 실행해 보려면, Tomcat 8 과 Postgresql 9.4 를 설치해야 합니다.

Tomcat 8 플랫폼을 실행하는 AWS Elastic Beanstalk 웹 서버 환경에 build.sh가 생성하는 ROOT.war 아카이브를 배포 할 수 있습니다.

프로젝트를 clone 합니다(SSH):

~$ git clone [email protected]:awskrug/eb-tomcat-snakes.git

혹은 HTTPS 로:

~$ git clone https://github.com/awskrug/eb-tomcat-snakes.git

빌드 스크립트(build.sh)를 실행하여 웹 앱과 WAR 파일을 생성합니다(OS X 나 리눅스에서):

~$ cd eb-tomcat-snakes
~/eb-tomcat-snakes$ ./build.sh

윈도우 사용자는 Git Bash 에서:

~/eb-tomcat-snakes$ ./build-windows.sh

혹은 gradle 을 사용할 경우에는:

~/eb-tomcat-snakes$ gradle build

중요 항상 build.sh 를 프로젝트 루트 디렉토리에서 실행하세요.

빌드 스크립트는 프로젝트를 컴파일하고 필요한 파일을 웹 아카이브(.WAR 파일)로 묶고, 로컬 환경 테스트를 위해 WAR 파일을 /Library/Tomcat 에 복사합니다. Tomcat을 다른 위치에 설치했다면, build.sh 에서 경로를 바꾸세요:

if [ -d "/path/to/Tomcat/webapps" ]; then
  cp ROOT.war /path/to/Tomcat/webapps

브라우저에서 localhost:8080를 열면, 로컬에서 실행되는 그 애플리케이션을 볼 수 있습니다.

AWS 관리 콘솔 이나 EB CLI 를 이용해서 컴파일한 WAR 파일을 실행할 수 있습니다. EB CLI 를 이용한 방법은 아래로 스크롤하여 보십시요.

1. Elastic Beanstalk Management Console 열기
2. Create New Application 선택
3. Application Name 에 tomcat-snakes 입력하고 Create 선택
4. 애플리케이션이 생성되면, Create One now 클릭
5. Web server environment 를 선택하고 Select 클릭
6. *Environment name" 에 tomcat-snakes 를 입력
7. Domain 에 고유한 주소(예를 들어 핸드폰번호) 입력하고 Check availability 클릭 is available 이 나오지 않으면, 다른 고유한 값으로 다시 입력한다.
8. is available 이 보이면, Platform 에 Preconfigured platform 선택하고, Choose a platform 에서 Tomcat 을 선택
9. Application code 에서 Upload your code 선택하고 Upload 클릭
10. 프로젝트 최상위 폴더에서 ROOT.war 를 업로드하고 Configure more options 클릭
11. Database 항목에서 Modify 클릭
12. Database settings 에서 아래 RDS 설정을 적용하고 Save 클릭(다른 항목은 기본값으로 남겨둡니다)
    • Engine을 postgres
    • Engine version 에 9.4.19
    • Instance class 에 db.t2.micro
    • Username 에 사용자명
    • Password 에 암호 ( 8자 이상)
    • Retension 에 Delete
13. Create environment 클릭

이 과정은 약 15분 정도 소요됩니다. 초기 환경 설정 중에 시간을 절약하려면 데이터베이스없이 환경을 생성한 다음, Configuration 페이지에서 추가할 수 있습니다. RDS DB 인스턴스를 시작하는데 약 10분 정도 걸립니다.

EB CLI는 Python 2.7 이나 3.4(권장)과 패키지 관리자인 pip 이 필요합니다. EB CLI 설치에 관한 자세한 설명은 AWS Elastic Beanstalk 개발자 가이드에서 Install the EB CLI를 참고하십시요.

EB CLI 설치하기:

~$ pip install awsebcli

프로젝트 저장소 초기화하기:

~/eb-tomcat-snakes$ eb init

.elasticbeanstalk/config.yml에 아래 내용 추가:

deploy:
  artifact: ROOT.war

RDS 데이터베이스를 포함한 환경 생성:

~/eb-tomcat-snakes$ eb create tomcat-snakes --sample --single --timeout 20 -i t2.micro -db.engine postgres -db.i db.t2.micro -db.user *사용자명* -db.pass *암호*

프로젝트 WAR 파일을 새 환경에 배포:

~/eb-tomcat-snakes$ eb deploy --staged

브라우저에서 생성된 환경 열어 보기:

~/eb-tomcat-snakes$ eb open

이 앱은 심플 태그, 태그 파일과 Amazon RDS(Amazon Relational Database Service)의 외부 데이터베이스에서 호스팅되는 SQL 데이터베이스를 이용하는 간단한 J2EE 사이트입니다.

첫 페이지는 자바스크립트를 이용한 매우 기본적인 소개입니다. 모든 페이지는 헤더용 심플 태그와 태그 파일을 이용하고, 모바일 친화적인 화면을 위해 부트스트랩 CSS를 이용하였습니다.

Browse Movies 페이지는 심플 태그로 생성된 데이터베이스의 영화 목록을 보여줍니다.

Add a Movie 페이지는 사용자가 데이터베이스에 영화를 추가하는 입력 양식입니다. 영화 제목, IMDB 나 tt0118615와 같은 IMDB 영화 ID, 영화에서 뱀이 나오는지 여부를 나타내는 불린 값을 입력받습니다. movies model의 정규식으로 입력 값을 검증합니다.

Search 페이지는 전체 일치방식으로만 영화 이름을 검색할 수 있습니다.

이 애플리케이션은 Elastic Beanstalk 환경의 일부인 RDB DB 인스턴스나 Elastic Beanstalk 외부의 독립적인 RDS DB 인스턴스에 접속할 수 있습니다. 외부 DB 인스턴스에 연결하려면 접속 변수(RDS_HOST 등)를 Environment Properties에서 설정하거나, Amazon S3에 JSON 파일로 접속 정보(connecton string 등)을 저장하십시요.

후자의 방법은 src/.ebextensions/inactive에 있는 설정 파일을 수정하여 S3 에서 접속정보를 다운로드할 수 있습니다. 환경설정 파일에 S3 버킷과 개체 주소를 가르키도록 수정하고 src/.ebextensions 폴더에 옮겨 놓으면, Elastic Beastalk 은 배포 중에 애플리케이션을 실행하는 EC2 인스턴스로 S3에서 접속정보를 다운로드합니다. 애플리케이션이 데이터베이스에 접속할 때에 환경변수 읽어오는 것보다 보다 우선적으로 이 값을 접속할 데이터 베이스를 지정하는 접속 문자열(connection string)로 사용합니다.

애플리케이션은 movies 테이블을 찾고, 없으면 새로 생성하고 소스에 포함된 JSON 파일에서 읽은 몇 개의 항목을 테이블에 넣어 둡니다.

RDS DB 인스턴스를 관리하려면 먼저 SSH로 사용자 환경의 인스턴스에 접속합니다. 환경을 생성할 때에 SSH 키를 선택하지 않았다면, EB CLI 를 이용해서 지정할 수 있습니다. eb config 실행하여 settings 아래 EC2KeyName 필드에 키 이름을 입력합니다. SSH 키가 없다면, eb init -i를 실행해서 프롬프트가 나오면 SSH 키를 생성하도록 합니다.

만약 movies 테이블을 지우거나, 테이블 초기화 코드의 변경사항을 시험하려면 사용자 환경 인스턴스에서 DB 인스턴스에 연결해서 관리자 명령을 실행합니다.

eb ssh 실행해서 인스턴스에 접속합니다:

~\eb-tomcat-snakes$ eb ssh

PostgresSQL 클라이언트 설치:

[ec2-user@ip-555-55-55-555 ~]$ sudo yum install postgresql94

RDS DB 인스턴스 접속:

[ec2-user@ip-555-55-55-555 ~]$ psql --dbname=ebdb --host=*DB_INSTANCE_HOSTNAME* --username=*DB_USERNAME*

movies 테이블 보기:

ebdb=> SELECT * FROM movies;

movies 테이블 삭제(주의: movies 테이블을 삭제한다)

ebdb=> DROP TABLE Movies;

psql 종료:

ebdb=> \q

SSH 종료:

[ec2-user@ip-555-55-55-555 ~]$ exit

이 애플리케이션은 Log4j 를 이용하여 snakes.log라는 이름의 로그 파일을 생성한다. 이 프로젝트는 자세한 로그 필요시에, snakes.log를 포함하도록 Elastic Beanstalk 를 설정하는 환경 설정 파일이 src/.ebextensions에 포함되어 있습니다.

이 프로젝트는 다음과 같이 구성되어 있습니다(일부 파일은 제외):

├── LICENSE             - License
├── README.md           - 이 파일
├── build.sh            - 빌드 스크립트
└── src
    ├── .ebextensions   - Elastic Beanstalk 환경 설정 파일
    ├── 404.jsp         - 404 오류 JSP
    ├── add.jsp         - 영화 추가 JSP
    ├── default.jsp     - 홈 페이지 JSP
    ├── movies.jsp      - 영화 목록 JSP
    ├── search.jsp      - 영화 검색 JSP
    ├── WEB-INF
    │   ├── lib         - 라이브러리(.JAR 파일. JSP, Servlet API, Jasper, Log4J, PostgreSQL)
    │   ├── tags        - 헤더 태그 파일
    │   │   └── header.tag
    │   ├── tlds        - ListMovies 심플 태그를 위한 테그 라이브러리 디스크립터
    │   │   └── movies.tld
    │   ├── log4j2.xml  - Log4J 환경설정 파일
    │   └── web.xml     - 배포 설명 파일
    ├── com
    │   └── snakes
    │       ├── model   - 모델 클래스
    │       │   ├── Media.java
    │       │   └── Movie.java
    │       └── web     - 서블릿, 단순 태그 클래스들
    │           ├── AddMovie.java
    │           ├── ListMovies.java
    │           └── SearchMovies.java
    ├── css             - 스타일 시트
    │   ├── movies.html - 스타일 변화를 테스트 하기 위한 HTML 페이지
    │   └── snakes.css  - 사용자 스타일
    ├── images          - 헤더와 프론트를 위한 무료 사용 이미지
    └── js              - 부트스트랩과 시차 효과를 위한 자바 스크립트

빌드 스크립트는 자바 컴파일러(javac)로 각 클래스를 컴파일하고 컴파일된 클래스와 다른 파일들을 ROOT.war라는 이름으로 웹 아카이브로 묶습니다. ROOT 는 이 앱이 tomcat 에서 서비스하는 사이트의 루트 경로에서 실행된다는 의미입니다.

참고 Elastic Beanstalk 환경에 WAR 파일을 배포하면, 배포 중에 풀어져서 파일명에 상관없이 최상위 로투 경로로서 실행됩니다. 여러 WAR 파일을 ZIP 파일로 묶어 배포하는 경우에 Elastic Beanstalk은 다른 경로의 앱들을 실행합니다.

WAR 파일에는 해당 앱의 실행에 필요한 파일들만 포함됩니다. 컴파일하지 않은 java 클래스나 .ebextensions/inactive 에 있는 설정 파일은 제외됩니다.

윈도우 버전 스크립트(build-windows.sh)도 포함되어 있다. classpath 인자들이 콜론(:)이 아니라 세미콜론(;)으로 구분되어 있다.