LocalStack AWS Infrastructure Prototype

This project demonstrates how to create AWS infrastructure locally using LocalStack and Terraform. It sets up a complete VPC with subnets, NAT gateways, and an EKS cluster - all running locally without incurring AWS costs.

🏗️ Infrastructure Components

• VPC: 10.0.0.0/16 CIDR with DNS support
• Subnets: 2 public and 2 private subnets across availability zones
• Networking: Internet Gateway, NAT Gateways, Route Tables
• EKS Cluster: Kubernetes cluster with managed node group
• Security Groups: Proper security configurations
• IAM Roles: Required roles and policies for EKS
• Nginx Application: Sample web application deployed in EKS

📋 Prerequisites

• Docker installed and running
• Terraform >= 1.0
• AWS CLI (optional, for testing)

🚀 Quick Start

1. Setup LocalStack and Initialize

./scripts/setup.sh

This script will:

• ✅ Check Docker and Terraform installation
• ✅ Start LocalStack container
• ✅ Initialize Terraform

2. Deploy Infrastructure

./scripts/deploy.sh

This script will:

• ✅ Plan Terraform deployment
• ✅ Apply infrastructure configuration
• ✅ Display infrastructure details
• ✅ Verify EKS cluster creation

3. Clean Up

./scripts/cleanup.sh

This script will:

• 🧹 Destroy all Terraform resources
• 🧹 Stop LocalStack container
• 🧹 Optionally remove data volumes and Terraform state

📁 Project Structure

localstack-aws-infra/
├── docker-compose.yml          # LocalStack container configuration
├── terraform/
│   ├── providers.tf           # AWS provider with LocalStack endpoints
│   ├── variables.tf           # Input variables
│   ├── vpc.tf                 # VPC, subnets, gateways, routing
│   ├── iam.tf                 # IAM roles and policies
│   ├── eks.tf                 # EKS cluster and node groups
│   └── outputs.tf             # Infrastructure outputs
├── k8s/
│   ├── nginx-namespace.yaml   # Kubernetes namespace
│   ├── nginx-configmap.yaml   # Custom nginx page content
│   ├── nginx-deployment.yaml  # Nginx deployment
│   └── nginx-service.yaml     # LoadBalancer service
├── scripts/
│   ├── setup.sh               # Environment setup
│   ├── deploy.sh              # Infrastructure deployment
│   ├── configure-kubectl.sh   # Kubectl configuration and app deployment
│   └── cleanup.sh             # Resource cleanup
├── architecture-diagram.excalidraw # Infrastructure diagram
└── README.md

⚙️ Configuration

Terraform Variables

You can customize the infrastructure by modifying variables in terraform/variables.tf:

Variable	Default	Description
project_name	localstack-demo	Name prefix for resources
vpc_cidr	10.0.0.0/16	VPC CIDR block
public_subnet_count	2	Number of public subnets
private_subnet_count	2	Number of private subnets
cluster_name	localstack-eks	EKS cluster name
cluster_version	1.27	Kubernetes version
node_group_instance_type	t3.medium	Worker node instance type

LocalStack Services

The setup enables these LocalStack services:

• EC2 (for VPC and subnets)
• EKS (for Kubernetes cluster)
• IAM (for roles and policies)
• STS (for token service)
• CloudWatch Logs
• EFS (Elastic File System)
• ELB (Elastic Load Balancing)

🔍 Testing and Verification

Check LocalStack Health

curl http://localhost:4566/_localstack/health

List AWS Resources

# Set AWS CLI to use LocalStack
export AWS_ENDPOINT_URL=http://localhost:4566
export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
export AWS_DEFAULT_REGION=us-east-1

# List VPCs
aws ec2 describe-vpcs

# List EKS clusters
aws eks list-clusters

# Describe EKS cluster
aws eks describe-cluster --name localstack-eks

Check Kubernetes Resources

# Set kubeconfig for LocalStack
export KUBECONFIG=~/.kube/config-localstack

# Check cluster info
kubectl cluster-info

# View nginx pods
kubectl get pods -n demo

# View services
kubectl get services -n demo

# Check deployment status
kubectl get deployments -n demo

Access Nginx Application

# Port forward to access nginx
kubectl port-forward -n demo service/nginx-service 8080:80

# Then visit: http://localhost:8080

View Terraform Outputs

cd terraform
terraform output

🛠️ Manual Steps

1. Start LocalStack Manually

docker-compose up -d

2. Deploy with Terraform

cd terraform
terraform init
terraform plan
terraform apply

3. Verify Deployment

terraform output

🌐 LocalStack Dashboard

Access the LocalStack web interface at: http://localhost:4566

📝 Notes

• Local Development: All resources are created locally in LocalStack
• No AWS Costs: No actual AWS resources are created
• Data Persistence: LocalStack data persists in Docker volumes
• Resource Limits: LocalStack Community edition has some limitations
• Security: Uses dummy AWS credentials for local development

🚨 Troubleshooting

LocalStack Not Starting

# Check Docker status
docker ps
# Check LocalStack logs
docker-compose logs localstack

Terraform Issues

# Refresh Terraform state
terraform refresh
# Force unlock if needed
terraform force-unlock LOCK_ID

Port Conflicts

If port 4566 is in use, modify the port mapping in docker-compose.yml:

ports:
  - "4567:4566"  # Change external port

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Test your changes locally
4. Submit a pull request

📄 License

This project is provided as-is for demonstration purposes.

---

Happy Local AWS Development! 🚀# localstack-aws-cloud-infra