jgomezve/aws-terraform

AWS & Terraform sample project

AWS Terraform & Terratest

Use Cases

• EC2 Instance and S3 Bucket
• Application Load Balance and EC2 Instances
• Validation with Terratest

Prerequisites

• Make sure to have Go 1.17 installed on your computer

  • Install Go

• Set your AWS credentials as environmental variables

    export AWS_ACCESS_KEY_ID="anaccesskey"
    export AWS_SECRET_ACCESS_KEY="asecretkey"
  

NOTE:: More information here AWS Terraform provider

EC2 Instance & S3 Bucket

• Go to the EC2 Instance & S3 Bucket folder

    cd ec2-s3
  

• Initialize Terraform and the AWS provider

    terraform init
  

• Setup the EC2 Intances, Network and S3 Bucket configuration in the file ec2-s3/variables.auto.tfvars. Here an example:

networks = [
  {
    network = "172.16.0.0/16"
    subnets = [
      {
        cidr = "172.16.1.0/24"
        az   = "us-east-2a"
      }
    ]
  }
]

instances = [
  {
    name   = "VM1"
    ami    = "ami-089c6f2e3866f0f14"
    type   = "t2.micro"
    subnet = "172.16.1.0/24"
    ips    = ["172.16.1.10"]
    tags = {
      Name  = "Flugel"
      Owner = "InfraTeam"
    }
  }
]

storage = [
  {
    name = "my-aws-bucket"
    acl  = "private"
    tags = {
      Name  = "Flugel"
      Owner = "InfraTeam"
    }
  }
]

NOTE:: See the ec2-s3/variables.tf file to check the supported schema

• Execute Terraform

    terraform apply -auto-approve
  

• Destroy Terraform Resources (Optional)

    terraform destroy -auto-approve
  

ALB and EC2 Instances

• Go to the ALB and EC2 Instances folder

    cd alb-ec2
  

• Initialize Terraform and the AWS provider

    terraform init
  

• Setup the EC2 Intances and Networks configuration in the file alb-ec2/variables.auto.tfvars. Here an example:

alb = {
  servers = [
    {
      name   = "VM1"
      subnet = "172.16.0.0/24"
      ami    = "ami-089c6f2e3866f0f14"
      type   = "t2.micro"
    },
    {
      name   = "VM2"
      subnet = "172.16.1.0/24"
      ami    = "ami-089c6f2e3866f0f14"
      type   = "t2.micro"
    }
  ]
  network = "172.16.0.0/16"
  subnets = [
    {
      cidr = "172.16.0.0/24"
      az   = "us-east-2a"
    },
    {
      cidr = "172.16.1.0/24"
      az   = "us-east-2b"
    }
  ]
}

NOTE:: See the alb-ec2/variables.tf file to check the supported schema

• Execute Terraform

    terraform apply -auto-approve
  

• Destroy Terraform Resources (Optional)

    terraform destroy -auto-approve
  

Terratest

• Go to the terratest folder and download the Go dependencies

    cd terratest
    go get -v -d
  

• Execute the test file terraform_test.go

    go test -v