Link

Deploy BuildVu on Amazon Web Services (AWS)

Table of contents

  1. Download the WAR file
  2. Getting Started
  3. Enabling HTTPS
  4. Wrapping up
  5. Running BuildVu from different language clients

The easiest way to run a BuildVu on AWS is to run our Docker image in a container on an Elastic Container Service (ECS) cluster.

Download the WAR file

Before getting started, you first want to download the WAR file. This is required for the image to work.

For trial users:

  1. If you haven’t already, sign up for BuildVu trial.

  2. Open the email you recieve when you signed up.

  3. Follow the download link found in the Docker section.

For customers:

  1. Visit the Customer download page.

  2. Click on ‘Download Latest Customer WAR’.

  3. Submit your username and password.

Getting Started

Head over to https://console.aws.amazon.com and log in.
Open the ‘All Services’ section and click on EC2(Elastic Compute Cloud). 1

You need to ensure you have a key pair to be able to SSH into your instance.
Click on ‘key pairs’: 2

Click on ‘Create key pair’, give it a name and select pem as the file format: 3

Now go to the services tab and click on Elastic Container Service(ECS) under ‘Containers’: 4

On the ‘Clusters’ page click ‘Create Cluster’. This lets you load your own EC2(Elastic Compute Cloud) that you can ssh into: 5

Choose ‘EC2 Linux + Networking’: 6

Enter the name you’d like to give your Cluster, select the instance type you want to use for your container instance (this will depend on the amount of resources you require).
Select the key pair you created earlier, then scroll down and click create: 7

Once it has loaded, click ‘View Cluster’ then go to the ‘ECS Instances’ tab.
Click on the ECs Instance ID ( it may take a moment to show): 8

Click on the ‘Instance ID’: 9

Go to the ‘Security’ tab and click on the ‘Security groups’ id. 10

Click on ‘Edit inbound rules’. 11

Click ‘Add rule’ and enter as show below then click ‘save rules’: 12

Go back to your EC2 instance, click on ‘Connect’ then go to the ‘SSH client’ tab and copy the public DNS: 13

Open a terminal and copy in this code, replacing with your information(the default username here is ‘ec2-user’, unless the AMI Owner has changed it):

scp -i <path/to/key.pem> path/to/war/buildvu-microservice.war ec2-user@<YourPublicDNS>:~

SSH into the instance:

 ssh -i <path/to/key.pem> ec2-user@<YourPublicDNS>

Once in, run the docker image:

docker run -p 80:80 --mount "source=/home/ec2-user/buildvu-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/BuildVu

Now go to your ECS and click on the ‘ECS instances’ tab and click on the ‘Container Instance’ id and copy your public ip address 14

Enabling HTTPS

To enable HTTPS, you need to open up the HTTPS port in the firewall, then you need a valid SSL certificate and key mounted at /opt/ssl in the virtual machine. Go to your EC2 instance and Go to the ‘Security’ tab and click on the ‘Security groups’ id. 15

On this page click the “Edit inbound rules” button. 16

Next use your terminal to upload the required SSL certificates. First you need to connect to the instance (as detailed above). Once connected create the directory /opt/ssl.

mkdir /opt/ssl

Next upload the sll certificates to this directory.

scp -i <path/to/key.pem> <path/to/server.crt> ec2-user@<YourPublicDNS>:/opt/ssl/server.crt
scp -i <path/to/key.pem> <path/to/server.key> ec2-user@<YourPublicDNS>:/opt/ssl/server.key

Now the virtual machine will allow HTTPS connections through you need to start docker with the port as well.

docker run -p 80:80 -p 433:433 --mount "source=/home/ec2-user/buildvu-microservice.war,target=/usr/local/tomcat/webapps/ROOT.war,type=bind" idrsolutions/buildvu

Wrapping up

If you no longer need your cluster, hit the ‘Delete Cluster’ button, so you stop getting billed for it: 37

Running BuildVu from different language clients

Now that you have the docker server running, you can choose from these different language clients to begin your conversions.