Files
acdl/modules/l1/ecs-service/interface.json
T
Jon Chery cec34abc22 fix(P04 W1): ecs-service execution_role_arn + task_role_arn wiring (live apply gap)
The live terraform apply (P4) uncovered a P2 module-completeness gap: the
ecs-service L1 aws_ecs_task_definition was missing execution_role_arn +
task_role_arn, and the microservice L2 composition did not wire
roles.outputs.role_arn to the service. Fargate requires an execution role
for ECR image pull. Fixed: interface.json + variables.tf + main.tf +
composition.json wires. The iam-role assume-policy trusts ecs-tasks +
the inline policy grants ECR pull + CW logs.

A second live gap surfaced once the task definition applied: the ALB
aws_lb had no security group (AWS rejects an ALB with an empty SG list).
The platform VPC only outputs an ECS SG; the composition now wires
platform_vpc.outputs.ecs_security_group_id to alb.inputs.security_group
(the ECS SG opens port 80 to 0.0.0.0/0 — acceptable for an internet-facing
ALB + dev pilot per D-020). No iam-role module changes were needed — its
locals.tf already trusts ecs-tasks.amazonaws.com and grants ECR pull +
CloudWatch logs by default.

Live apply now succeeds: Apply complete! Resources: 0 added, 1 changed, 0
destroyed (task def + ECS service created on the first re-apply; ALB SG
updated in-place on the second). Full suite: 844 passed.

---ci---
project: acdl
phase: 4
milestone: v1.26
status: execute
wave: W1
---
2026-08-19 03:01:47 +00:00

156 lines
4.1 KiB
JSON

{
"name": "ecs-service",
"version": "1.0.0",
"kind": "l1",
"type": "aws:ecs:task_definition",
"description": "ECS Fargate service primitive (engine-agnostic stack types aws:ecs:task_definition + aws:ecs:service; the Terraform adapter translates to aws_ecs_task_definition/aws_ecs_service).",
"inputs": {
"image": {
"type": "string",
"description": "ECR image URL for the task container.",
"required": true
},
"port": {
"type": "number",
"description": "Container port the service listens on.",
"required": true
},
"cpu": {
"type": "number",
"description": "Task CPU units (Fargate).",
"required": false,
"default": 256
},
"memory": {
"type": "number",
"description": "Task memory (MiB, Fargate).",
"required": false,
"default": 512
},
"env": {
"type": "string",
"description": "Environment variables as a JSON map string (optional).",
"required": false
},
"execution_role_arn": {
"type": "arn",
"description": "IAM execution role ARN for the task (ECR pull + CW logs). Ref to iam-role.",
"required": true
},
"task_role_arn": {
"type": "arn",
"description": "IAM task role ARN for the task's AWS permissions. Ref to iam-role.",
"required": false
},
"cluster_arn": {
"type": "arn",
"description": "ECS cluster ARN (ref to ecs-cluster).",
"required": true
},
"subnets": {
"type": "string",
"description": "Comma-separated subnet ids (ref to vpc).",
"required": true
},
"security_group": {
"type": "string",
"description": "Security group id for the service ENIs.",
"required": true
},
"lb_target_group_arn": {
"type": "arn",
"description": "Optional ALB target group ARN (ref to alb).",
"required": false
},
"region": {
"type": "string",
"description": "AWS region the service is created in.",
"required": true
},
"kms_key_arn": {
"type": "string",
"description": "ARN of the CMK for CloudWatch log group encryption; if absent, uses managed key.",
"required": false
},
"desired_count": {
"type": "number",
"description": "Desired number of ECS task replicas (Fargate).",
"required": false,
"default": 1
},
"launch_type": {
"type": "string",
"description": "ECS launch type (FARGATE or EC2).",
"required": false,
"default": "FARGATE"
},
"family": {
"type": "string",
"description": "ECS task definition family name.",
"required": false,
"default": "app"
},
"enabled": {
"type": "boolean",
"default": true,
"description": "Feature flag: enable/disable this module. Set to false to skip resource creation."
}
},
"outputs": {
"service_arn": {
"type": "arn",
"description": "The ECS service ARN."
},
"task_def_arn": {
"type": "arn",
"description": "The ECS task definition ARN."
}
},
"nfrs": {
"encryption_enabled": {
"type": "boolean",
"description": "Enable CloudWatch log group encryption.",
"default": true
},
"deletion_protection": {
"type": "boolean",
"description": "Prevent resource destruction via Terraform lifecycle prevent_destroy",
"default": true
}
},
"resources": [
{
"type": "aws:ecs:task_definition",
"description": "Fargate task definition; the adapter jsonencodes image/port/env into container_definitions.",
"inputs": [
"image",
"port",
"cpu",
"memory",
"env",
"family",
"execution_role_arn",
"task_role_arn"
],
"outputs": [
"task_def_arn"
]
},
{
"type": "aws:ecs:service",
"description": "Fargate service running the task definition in the cluster + subnets.",
"inputs": [
"cluster_arn",
"subnets",
"security_group",
"lb_target_group_arn",
"desired_count",
"launch_type"
],
"outputs": [
"service_arn"
]
}
]
}