aws-poc

The purpose of this repository is to test the deployment of infrastructure in AWS and keep learning.

Overview

This project builds a global network architecture using AWS Transit Gateway spanning multiple regions. The infrastructure is managed using Terraform modules with environment-specific configurations.

Architecture

In our first iteration, we will build a Global Network based on the diagram below:

Project Structure

├── docs/              # Documentation
├── modules/           # Reusable Terraform modules
│   └── create-vpc/    # VPC creation module
├── envs/              # Environment-specific configurations
│   └── dev/           # Development environment
│       └── euw2/      # EU West 2 region
├── vars/              # Shared variable definitions
└── resources/         # Documentation assets

Quick Start

For detailed setup and deployment instructions, see:

• Getting Started Guide - Prerequisites, initial setup, and development workflow
• Deployment Instructions - Step-by-step deployment guide and troubleshooting

CI/CD Pipeline

The project includes a GitHub Actions pipeline that:

• Runs on pushes to main and pull requests
• Generates cost estimates using Infracost
• Posts cost analysis comments on pull requests

Modules

• create-vpc: Creates VPC with public/private subnets, route tables, and NAT gateways

See the Deployment Guide for detailed module usage examples.

Build Sequence

• create-key-pair: This will create an SSH key pair and save it to the ssh-keys/ directory. Each region will have its own set of keys to be able to SSH into the instances. Best Practice would be to use AWS Systems Manager Session Manager to connect to the machine without keys.
• create-vpc: This will create a VPC with public and private subnets, route tables, and NAT gateways.
• create-ec2: This will create EC2 instances in the public and private subnets.