Terraform AWS Free Tier

Getting started with the Terraform for managing a base free-tier AWS resources.

Project description

This is a Terraform project for managing AWS resources.

It can build the next infrastructure:

• VPC
• Public Subnet in the VPC
• IGW to enable access to or from the Internet for VPC
• Route Table to associate IGW, VPC and Subnet
• EC2 Instance in the public Subnet with the HTTP(s) & SSH access

Pre steps

1. Install Terraform
2. Create AWS account
3. If the file ~/.aws/credentials does't exist, create it and add you Terraform profile to the file. For example:

   [terraform]
   aws_access_key_id = Your access key
   aws_secret_access_key = Your secret access key 
   

4. Create S3 bucket to store Terraform state
5. Create config file ./src/free-tier/backend/config.tf that will contain information how to store state in a given bucket. See example.
6. Create SSH key pair to connect to EC2 instance:

   cd ./src/free-tier/provision/access
   
   # it creates "free-tier-ec2-key" private key and "free-tier-ec2-key.pub" public key
   ssh-keygen -f free-tier-ec2-key

Build infrastructure

1. cd ./src/free-tier
2. terraform init -backend-config="./backend/config.tf"
3. terraform plan
4. terraform apply

Post steps

After building the infrastructure you can try to connect to you EC2 instance via SSH:

1. cd ./src/free-tier
2. ssh -i ./provision/access/free-tier-ec2-key ubuntu@[EC2 public IP]

To check HTTP access you can install apache2 on your EC2 instance:

1. sudo apt update && sudo apt install apache2 (on EC2 machine)
2. sudo service apache2 start (on EC2 machine)
3. Check in browser: http://[EC2 public IP]/. You can see Apache2 Default Page (something like this)

To destroy infrastructure:

1. cd ./src/free-tier
2. terraform destroy