/terraform-aws-free-tier

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

Primary LanguageHCLMIT LicenseMIT

Terraform AWS Free Tier

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

License: MIT

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