terraform fmt -check
passStarted 2026-10-03T06:25:29Z · 0.181s
Terraform / IaC
Terraform for AWS: a single-EC2 Docker host, or ECS Fargate, tested offline.
Reference architecture and offline tests for a fictional Initech checkout-api. This is not a client project. No AWS account is used and nothing here is a price.
构建时记录 . Recorded when this demo was built. The page does not re-run Terraform, tflint, or checkov.
Counted with python-hcl2 from the .tf files. A module file counts once, not once per caller.
79 resource blocks, 7 module blocks.
| Resource type | Count |
|---|---|
aws_appautoscaling_policy | 1 |
aws_appautoscaling_target | 1 |
aws_cloudwatch_log_group | 3 |
aws_db_instance | 1 |
aws_db_subnet_group | 1 |
aws_default_security_group | 1 |
aws_dlm_lifecycle_policy | 1 |
aws_dynamodb_table | 1 |
aws_ecr_lifecycle_policy | 1 |
aws_ecr_repository | 1 |
aws_ecs_cluster | 1 |
aws_ecs_service | 1 |
aws_ecs_task_definition | 1 |
aws_eip | 2 |
aws_flow_log | 1 |
aws_iam_instance_profile | 1 |
aws_iam_role | 6 |
aws_iam_role_policy | 6 |
aws_iam_role_policy_attachment | 1 |
aws_instance | 1 |
aws_internet_gateway | 1 |
aws_kms_alias | 3 |
aws_kms_key | 3 |
aws_lb | 1 |
aws_lb_listener | 2 |
aws_lb_target_group | 1 |
aws_nat_gateway | 1 |
aws_route | 2 |
aws_route_table | 2 |
aws_route_table_association | 2 |
aws_s3_bucket | 2 |
aws_s3_bucket_lifecycle_configuration | 2 |
aws_s3_bucket_ownership_controls | 2 |
aws_s3_bucket_policy | 2 |
aws_s3_bucket_public_access_block | 2 |
aws_s3_bucket_server_side_encryption_configuration | 2 |
aws_s3_bucket_versioning | 2 |
aws_security_group | 5 |
aws_security_group_rule | 1 |
aws_ssm_parameter | 3 |
aws_subnet | 2 |
aws_vpc | 1 |
aws_vpc_endpoint | 2 |
| Module | Source | File |
|---|---|---|
state | ../modules/state_backend | bootstrap/main.tf |
network | ../modules/network | ecs-fargate/main.tf |
ecr | ../modules/ecr | ecs-fargate/main.tf |
alb | ../modules/alb | ecs-fargate/main.tf |
service | ../modules/ecs_service | ecs-fargate/main.tf |
network | ../modules/network | single-ec2/main.tf |
host | ../modules/ec2_docker_host | single-ec2/main.tf |
构建时记录. These cards repeat data/checks.json. Opening the page does not run Terraform.
terraform: Terraform v1.9.8 · tflint: TFLint version 0.55.1 · checkov: 3.2.449
AWS_ACCESS_KEY_ID was empty when these commands ran.
Started 2026-10-03T06:25:29Z · 0.181s
single_ec2 exit 0 · 2.04secs_fargate exit 0 · 2.431sbootstrap exit 0 · 2.007sStarted 2026-10-03T06:25:35Z · 1.058s
passed 218, failed 14, skipped 2. HIGH failures: 0.
checkov 3.2.449 leaves severity empty unless a Bridgecrew or Prisma API key is set. Each severity below is the Severity field on that check's public Prisma Cloud policy page, fetched while this file was written.
CKV_AWS_260 LOW · module.alb.aws_security_group.alb · Ensure no security groups allow ingress from 0.0.0.0:0 to port 80CKV_AWS_150 LOW · module.alb.aws_lb.this · Ensure that Load Balancer has deletion protection enabledCKV_AWS_260 LOW · module.host.aws_security_group.host · Ensure no security groups allow ingress from 0.0.0.0:0 to port 80CKV2_AWS_62 LOW · module.alb.aws_s3_bucket.logs · Ensure S3 buckets should have event notifications enabledCKV2_AWS_62 LOW · module.state.aws_s3_bucket.state · Ensure S3 buckets should have event notifications enabledCKV2_AWS_19 LOW · module.network.aws_eip.nat[0] · Ensure that all EIP addresses allocated to a VPC are attached to EC2 instancesCKV_AWS_144 LOW · module.alb.aws_s3_bucket.logs · Ensure that S3 bucket has cross-region replication enabledCKV_AWS_144 LOW · module.state.aws_s3_bucket.state · Ensure that S3 bucket has cross-region replication enabledCKV2_AWS_5 LOW · module.network.aws_security_group.endpoints[0] · Ensure that Security Groups are attached to another resourceCKV2_AWS_34 LOW · module.host.aws_ssm_parameter.cwagent · AWS SSM Parameter should be EncryptedCKV2_AWS_30 LOW · aws_db_instance.app · Ensure Postgres RDS as aws_db_instance has Query Logging enabledCKV_AWS_18 LOW · module.alb.aws_s3_bucket.logs · Ensure the S3 bucket has access logging enabledCKV_AWS_18 LOW · module.state.aws_s3_bucket.state · Ensure the S3 bucket has access logging enabledCKV2_AWS_28 LOW · module.alb.aws_lb.this · Ensure public facing ALB are protected by WAFCKV_AWS_355 HIGH · module.host.aws_iam_role_policy.session — ssmmessages, ec2messages, and ssm:UpdateInstanceInformation do not support resource-level permissions; AWS requires Resource *CKV_AWS_290 HIGH · module.host.aws_iam_role_policy.session — those Session Manager write actions cannot be constrained to a resource ARNStarted 2026-10-03T06:25:41Z · 5.071s. passed 6, failed 0, errored 0, skipped 0.
ec2_dev_sg_and_tags passec2_prod_size passecs_dev_alb_role_and_tags passecs_prod_size passecs_without_nat passecs_with_rds passNo prices. Sizes are read from envs/dev.tfvars and envs/prod.tfvars.
| Single EC2 | ECS Fargate | |
|---|---|---|
| Shape | One host, Compose, user_data | VPC, ALB, ECR, Fargate service |
| Availability | One machine in one zone | Two zones, load balancer, rolling deploy |
| Operations | Patch the OS. SSM instead of SSH. Daily EBS snapshots. | No host OS. Ship a new task definition. |
| Change in size | Replace the instance | CPU target tracking between min and max |
| Dev in the example | t3.small | 256 CPU / 512 MiB |
| Prod in the example | t3.medium | 512 CPU / 1024 MiB |
| Fits when | The service can live on one machine | A task or a zone failing should not take the service down |
modules/ecs_service/main.tflocals {
tags = {
Project = var.project
Env = var.env
Owner = var.owner
}
task_role_policy = {
Version = "2012-10-17"
Statement = [
{
Sid = "ReadAppSecret"
Effect = "Allow"
Action = [
"ssm:GetParameter",
"ssm:GetParameters",
]
Resource = var.secret_arn
},
{
Sid = "DecryptAppSecret"
Effect = "Allow"
Action = ["kms:Decrypt"]
Resource = var.kms_key_arn
},
]
}
}
resource "aws_ecs_cluster" "this" {
name = var.name
tags = local.tags
setting {
name = "containerInsights"
value = "enabled"
}
}
resource "aws_cloudwatch_log_group" "app" {
name = "/${var.project}/${var.env}/checkout-api"
retention_in_days = 365
kms_key_id = var.kms_key_arn
tags = local.tags
}
resource "aws_security_group" "tasks" {
name = "${var.name}-tasks"
description = "Accept app traffic only from the load balancer"
vpc_id = var.vpc_id
tags = merge(local.tags, { Name = "${var.name}-tasks" })
ingress {
description = "alb to app"
from_port = 8080
to_port = 8080
protocol = "tcp"
security_groups = [var.alb_security_group_id]
}
egress {
description = "https to aws apis and the registry"
from_port = 443
to_port = 443
protocol = "tcp"
cidr_blocks = ["0.0.0.0/0"]
}
}
resource "aws_iam_role" "execution" {
name = "${var.name}-execution"
tags = local.tags
assume_role_policy = jsonencode({
Version = "2012-10-17"
Statement = [{
Effect = "Allow"
Principal = { Service = "ecs-tasks.amazonaws.com" }
Action = "sts:AssumeRole"
}]
})
}
resource "aws_iam_role_policy" "execution" {
name = "${var.name}-execution"
role = aws_iam_role.execution.id
policy = jsonencode({
Version = "2012-10-17"
Statement = [
{
Sid = "EcrAuth"
Effect = "Allow"
Action = ["ecr:GetAuthorizationToken"]
Resource = "*"
},
{
Sid = "EcrPull"
Effect = "Allow"
Action = [
"ecr:BatchCheckLayerAvailability",
"ecr:GetDownloadUrlForLayer",
"ecr:BatchGetImage",
]
Resource = var.ecr_repository_arn
},
{
Sid = "WriteAppLogs"
Effect = "Allow"
Action = [
"logs:CreateLogStream",
"logs:PutLogEvents",
]
Resource = "${aws_cloudwatch_log_group.app.arn}:*"
},
{
Sid = "ReadAppSecret"
Effect = "Allow"
Action = ["ssm:GetParameters"]
Resource = var.secret_arn
},
{
Sid = "DecryptAppSecret"
Effect = "Allow"
Action = ["kms:Decrypt"]
Resource = var.kms_key_arn
},
]
})
}
resource "aws_iam_role" "task" {
name = "${var.name}-task"
tags = local.tags
assume_role_policy = jsonencode({
Version = "2012-10-17"
Statement = [{
Effect = "Allow"
Principal = { Service = "ecs-tasks.amazonaws.com" }
Action = "sts:AssumeRole"
}]
})
}
resource "aws_iam_role_policy" "task" {
name = "${var.name}-task"
role = aws_iam_role.task.id
policy = jsonencode(local.task_role_policy)
}
resource "aws_ecs_task_definition" "app" {
family = var.name
requires_compatibilities = ["FARGATE"]
network_mode = "awsvpc"
cpu = tostring(var.task_cpu)
memory = tostring(var.task_memory)
execution_role_arn = aws_iam_role.execution.arn
task_role_arn = aws_iam_role.task.arn
tags = local.tags
container_definitions = jsonencode([{
name = "checkout-api"
image = var.container_image
essential = true
user = "10001"
portMappings = [{
containerPort = 8080
protocol = "tcp"
}]
readonlyRootFilesystem = true
linuxParameters = {
capabilities = {
drop = ["ALL"]
}
}
logConfiguration = {
logDriver = "awslogs"
options = {
awslogs-group = aws_cloudwatch_log_group.app.name
awslogs-region = var.region
awslogs-stream-prefix = "checkout"
}
}
secrets = [{
name = "APP_SECRET"
valueFrom = var.secret_arn
}]
healthCheck = {
command = ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8080/healthz', timeout=2).read()"]
interval = 30
timeout = 5
retries = 3
startPeriod = 10
}
}])
}
resource "aws_ecs_service" "app" {
name = var.name
cluster = aws_ecs_cluster.this.id
task_definition = aws_ecs_task_definition.app.arn
desired_count = var.desired_count
launch_type = "FARGATE"
platform_version = "LATEST"
health_check_grace_period_seconds = 60
enable_execute_command = false
propagate_tags = "SERVICE"
tags = local.tags
deployment_minimum_healthy_percent = 50
deployment_maximum_percent = 200
deployment_circuit_breaker {
enable = true
rollback = true
}
network_configuration {
subnets = var.subnet_ids
security_groups = [aws_security_group.tasks.id]
assign_public_ip = false
}
load_balancer {
target_group_arn = var.target_group_arn
container_name = "checkout-api"
container_port = 8080
}
lifecycle {
ignore_changes = [desired_count]
}
}
resource "aws_appautoscaling_target" "app" {
max_capacity = var.max_capacity
min_capacity = var.min_capacity
resource_id = "service/${aws_ecs_cluster.this.name}/${aws_ecs_service.app.name}"
scalable_dimension = "ecs:service:DesiredCount"
service_namespace = "ecs"
tags = local.tags
}
resource "aws_appautoscaling_policy" "cpu" {
name = "${var.name}-cpu"
policy_type = "TargetTrackingScaling"
resource_id = aws_appautoscaling_target.app.resource_id
scalable_dimension = aws_appautoscaling_target.app.scalable_dimension
service_namespace = aws_appautoscaling_target.app.service_namespace
target_tracking_scaling_policy_configuration {
target_value = var.cpu_target
scale_in_cooldown = 120
scale_out_cooldown = 60
predefined_metric_specification {
predefined_metric_type = "ECSServiceAverageCPUUtilization"
}
}
}