RMIT University Vietnam

Course: COSC2767 Systems Deployment and Operations

Semester: 2022B

Assessment: Assignment 1

Author: Du Duc Manh

ID: 3878480

Created date: 12/07/2022

Last modified: 26/07/2022

Acknowledgement: AWS, AWS Java OpenJDK 11, Maven 3.8.6, Tomcat 10.0.22, fontawesome, font-mfizz-2.4.1.

About this project

This project aims to practice deploying a Java Webapp to an AWS EC2 instance through port 8080 using the Tomcat service. The tool for building the WAR file is Maven. The project use AWS CloudFormation to create resources:

• An EC2 instance with a bash script in the UserData property. The instance will run that script in the first launch. The VPC and subnet is not declared so AWS will assign the default VPC and a public subnet inside it.
• A key to be associated with the EC2 instance. Since it is created by using CloudFormation, the private key will be stored as a secure string in AWS System Manager Parameter Store.
• A security group that allows inbound data to port 22 for SSH and port 8080 for Tomcat.

To launch the template from a CLI, put the access key, secret access key, and session token in the credentials file under .aws directory. The region to launch the resources could be put there too. Else, you can use "aws configure" to input the mentioned information.

In the script, there is a "git clone" command to download the remote private repo. Therefore, there is a parameter called Token to access the Github access token stored in AWS System Manager Parameter Store. The token must be saved in AWS System Manager Parameter Store before running the AWS CloudFormation template as CloudFormation will check for it and will not start if it cannot find the parameter.

In the first launch, the script will be executed. Initially, it downloads Java OpenJDK 11 version by AWS and git. It will install Tomcat and Maven from official websites of them and unarchive the files in "/opt". Then, the paths for Java OpenJDK and Maven will be added to the environment PATH so Maven can run in the webapp root folder to build the WAR artifact. With all needed services installed, the repo will be cloned and Maven will package the webapp. The artifact will be moved to "webapps" folder under the Tomcat directory. Finally, the instance run a script called "startup.sh" of tomcat to run the server. The website will be hosted under this URL: "URI of the EC2 Instance":8080/"name of the project directory"

Behind this website:

• Maven 3.8.6
• Tomcat 10.0.22
• AWS EC2

Image of the website