Prerequisites

To be able to run or test this infrastructure, you will need to get a few things up and running:

• Golang installed
• A Terraform Cloud Account
• The Terraform CLI 0.14.8+ installed.
• The AWS CLI installed.
• An AWS account.
• Your AWS credentials. You can create a new Access Key on this page.

Steps

• Launch your terminal

• Run aws configure to configure the AWS CLI from your terminal. Follow the prompts to input your AWS Access Key ID and Secret Access Key. Set the region us-east-1, then json as format.

• Open server.py file and on line 3, fill in the aws_access_key_id aws_secret_access_key fields with your acquired AWS credentials from the previous step.

ec2 = boto3.client('ec2', aws_access_key_id='<your_aws_access_key>', aws_secret_access_key='<aws_secret_access_key>', region_name=region)

• You will need to create your organization and workspace on Terraform Cloud. Follow these instructions to help you set that up.

• Open main.tf and on line 5 and 9 respectively, replace the organization and workspaces name field to the organization and workspace you created in the previous step.

terraform {
  backend "remote" {
    #         # The name of your Terraform Cloud organization.
    hostname     = "app.terraform.io"
    organization = "<your-organization>"
    #
    #         # The name of the Terraform Cloud workspace to store Terraform state files in.
    workspaces {
      name = "<your-workspace>"
    }
  }

• Create your AWS Key Pair in the AWS Console, download it, and move it to the root of this project.

• Open main.tf and on line 131 change the value of key_name to the name of your downloaded key

key_name      = "<your_key_name>"

• On line 146, edit the private_key to the path of tour key which you added to the root of this project.

private_key = file("${path.module}/<your_key_name>.pem")

• Launch your terminal and cd to the root of this project, run the following commands to deploy the infrastructure:

• • terraform init
• • • initiates terraform
• • terraform fmt
• • • formats the files to match the canonical standard
• • terraform validate
• • • ensures the files are syntactically valid and internally consistent
• • terraform apply -auto-approve
• • • creates the infrastructure

• Wait for the infrastructure to deploy. On successful deploy you should have an output as this on your terminal:

Apply complete! Resources: 10 added, 0 changed, 0 destroyed.

Outputs:

instance_id = "i-0941f1d034a2f2f6d"
instance_url = "Visit http://52.204.187.105:8080 in your browser."
public_ip = "52.204.187.105"
resource_tags = tomap({
  "Name" = "Flugel"
  "Owner" = "InfraTeam"
})

• Run terraform show to see the details of the infrastructure.
• Once you are done, you will need to destroy what you just built, so run: terraform destroy -auto-approve

Testing

To run the tests:

• Launch your terminal and cd to the root of this project
• run cd test to navigate to the test folder
• run go build -v
• run go test -v