README.md

Terraform with Terratest Example Project

This repository demonstrates how to set up an AWS instance using Terraform and how to test it using Terratest.

Prerequisites

• Terraform >= 0.14
• Go >= 1.15
• AWS CLI configured with Admin-level credentials
• GitHub Account (Optional, if you wish to set up CI/CD)

Project Structure

.
├── .github
│   └── workflows
│       └── ci.yml
├── Makefile
├── README.md
├── terraform
│   ├── main.tf
│   ├── outputs.tf
│   └── variables.tf
└── tests
    ├── go.mod
    └── main_test.go

How to Run

Terraform Setup

1. Navigate to the terraform directory:

cd terraform

2. Initialize Terraform:

terraform init

3. Apply the Terraform code:

terraform apply

Test Setup

1. Navigate to the tests directory:

cd tests

2. Run the tests:

go test

Or you can use the provided Makefile to run the tests:

make test