teraform_aws/README.md

Terraform AWS EC2 Deployment

A Terraform project that automates the deployment of EC2 instances on AWS with custom initialization scripts. This showcases Infrastructure as Code best practices using Terraform to provision and configure cloud resources.

Prerequisites

• Terraform >= 1.0 (download from terraform.io)
• AWS Account with appropriate IAM permissions
• AWS CLI configured with valid credentials
• Basic understanding of Terraform and AWS EC2

Project Structure

.
├── README.md
├── main.tf              # Primary Terraform configuration
├── variables.tf         # Variable definitions
├── outputs.tf          # Output values
└── terraform.tfvars    # Variable values (create this file)

Quick Start

1. Clone or navigate to the project directory

   cd teraform_aws
   

2. Initialize Terraform

   terraform init
   

3. Create terraform.tfvars with your configuration:

   aws_region = "us-east-1"
   instance_type = "t2.micro"
   # Add other variables as needed
   

4. Plan the deployment

   terraform plan
   

5. Apply the configuration

   terraform apply
   

6. Retrieve outputs

   terraform output
   

Features

• Automated EC2 instance provisioning
• Custom initialization scripts (user data) for post-launch configuration
• Configurable instance types and regions
• Security group management
• Infrastructure state management with Terraform

Configuration

Edit terraform.tfvars to customize:

• AWS region
• Instance type
• Number of instances
• Custom initialization commands
• Security group rules

Outputs

After successful deployment, Terraform will output:

• EC2 instance IDs
• Public/Private IP addresses
• Security group information

Cleanup

To destroy all resources:

terraform destroy

Notes

• Ensure your AWS credentials are properly configured before running Terraform
• Review the plan output before applying changes
• Some resources may incur AWS charges
• Use appropriate AMI IDs for your chosen region