How reticent93/aws_vpc works
This repository provisions AWS networking and a containerized FastAPI service, then deploys it through GitHub Actions using OIDC. The principal user path is Internet traffic through the ALB to an ECS Fargate task and its health endpoint. Terraform also provisions two VPCs and peering, while the documented deployment builds and pushes an image before applying infrastructure changes. Infrastructure-module internals were not sampled, so relationships not described in the README are omitted; the graph reflects documented connections rather than inferred Terraform wiring.
Main entry points: main.tf Terraform root · ecs/main.tf ECS Fargate service · deploy.yml GitHub Actions deploy · alb/main.tf Application Load Balancer
Components 16
Application
- FastAPI endpoints
app/main.py
Service Runtime
- Application Load Balancer
modules/alb/main.tf - ECS Fargate service
modules/ecs/main.tf - Container registry
modules/ecr/main.tf - CloudWatch Logs
modules/ecs/main.tf
AWS Networking
- VPCs
modules/vpc/main.tf - Subnets
modules/subnets/main.tf - VPC peering
modules/vpc_peering/main.tf
Provisioning and Deployment
- Terraform root
main.tf - IAM roles
modules/iam/main.tf - S3 module
modules/s3/main.tf - Terraform state bucket
- GitHub Actions deploy
.github/workflows/deploy.yml - GitHub OIDC
github_actions.tf - Docker image build
app/Dockerfile
Other components
- Internet client
Connections 18
- Internet client → Application Load Balancer: sends HTTP
README.md - Application Load Balancer → ECS Fargate service: routes traffic
README.md - ECS Fargate service → FastAPI endpoints: runs container
README.md - ECS Fargate service → Container registry: pulls image
README.md - ECS Fargate service → CloudWatch Logs: writes logs
README.md - Terraform root → VPCs: provisions
README.md - Terraform root → Subnets: provisions
README.md - Terraform root → VPC peering: provisions
README.md - Terraform root → Application Load Balancer: provisions
README.md - Terraform root → ECS Fargate service: provisions
README.md - Terraform root → Container registry: provisions
README.md - Terraform root → IAM roles: provisions
README.md - Terraform root → S3 module: provisions
README.md - Terraform root → Terraform state bucket: stores state
README.md - GitHub Actions deploy → GitHub OIDC: assumes role
README.md - GitHub Actions deploy → Docker image build: builds image
README.md - GitHub Actions deploy → Container registry: pushes image
README.md - GitHub Actions deploy → Terraform root: applies changes
README.md