How corymhall/example-terraform-project works
Project type and purpose
• This is a Terraform-based “infrastructure as code” mono-repo.
• Purpose: define, organize, and test AWS infrastructure in multiple environments (prod/non-prod) and regions using Terraform workspaces and reusable modules.
File structure
• Top-level folders:
• meta – environment‐to‐account mappings
• app-infrastructure – per-application ECS/ALB infrastructure, one Terraform workspace per env+region
• core-infrastructure – shared infra (VPC, ACM, etc.), one workspace per account+region
• modules – reusable Terraform modules (alb, ecs_service, ecs_task, s3-iam)
• modules/tests – Terratest suite for module validation
• Common patterns:
• Layered architecture: modules at bottom → core/app infra at mid → AWS as deployment target
• Workspace isolation: separate state per environment
• CI tests invoking real AWS provisioning via Terratest
Key README insights
• Separation of core vs. app infra to limit blast radius
• One workspace per environment OR region/account
• Modules abstract AWS resource details for safety and reusability
• Terratest for end-to-end module testing
Main components
1. Terraform Modules
– alb, ecs_service, ecs_task, s3-iam
2. Core Infrastructure Workspaces
– core-infrastructure: prd-useast1, prd-useast2, nonprd-useast1, nonprd-useast2
3. App Infrastructure Workspaces
– app-infrastructure: prd-useast1/2, dev-useast1/2, stg-useast1/2
4. Meta
– environment→AWS account mapping
5. Terratest CI
– invokes modules/tests, provisions sample infra, validates, then tears down
6. AWS Accounts & Regions
– prod account, non-prod account, each in us-east-1 & us-east-2
b. Relationships and data flow
• Modules�←─used by─ Core Infra & App Infra workspaces
• Workspaces�←─import─ Meta mappings
• Workspaces�→─provision─ AWS (accounts/regions)
• Terratest CI�→─runs Terraform on modules, orchestrates AWS provisioning & tests
c. Architectural patterns
• Layered composition (modules → infra layers)
• Workspace isolation for environment management
• Infrastructure modularization for reusability & safety
• CI testing of actual infrastructure
d. Key technologies & frameworks
• Terraform v0.12+ (HCL code, workspaces)
• AWS (ECS, ALB, VPC, IAM, ACM, S3)
• Terratest (Go) for end-to-end infra tests