Files
acdl/modules/l2/microservice
Jon Chery 895a2f3806 docs(P20): specify phase 20 — consumer happy path + reusable deploy workflow (v1.5)
---ci---
project: acdl
phase: 20
milestone: v1.5
status: specify
---/ci---

Add v1.5 milestone to ROADMAP.md + REQUIREMENTS.md. Phase 20 covers
REQ-46 (README consumer model + mermaid + L3B/spike scrub), REQ-47
(generic CONSUMER_GUIDE.md + versioned uses: + consumer-scoped prereqs
+ run-time platform fetch), REQ-48 (zero-trust OIDC/ABAC credentials +
static-key override + daily rotation), REQ-49 (reusable byte-identical
deploy.yml Gitea+GitHub implementing pipelines/deploy.yaml), REQ-50
(contracts/static-asset.yaml @v1.4), REQ-51 (deploy-workflow conformance
tests). Update config.json milestone to v1.5.
2026-07-22 17:09:23 +00:00
..

l2-microservice — ECS Fargate microservice (composition being redesigned)

Module kind: L2 composition | Version: TBD | Status: Under redesign

A composition that references multiple L1 primitives to deploy an ECS Fargate microservice end-to-end (VPC, cluster, ECR, IAM role, ALB, ECS service).

The composition layer is being redesigned. The previous thin-composition implementation (a composition.json with children + wires) has been removed. A new composition mechanism will be designed in a later phase.

Resources

TBD — the composition will reference these L1 primitives:

L1 module Purpose README
l1-vpc VPC, subnets, routing README
l1-ecs-cluster ECS Fargate cluster README
l1-ecr ECR image repository README
l1-iam-role IAM task execution role README
l1-alb Application Load Balancer README
l1-ecs-service ECS task definition + service README

Inputs

TBD — will be defined when the composition mechanism is redesigned.

Outputs

TBD — will be defined when the composition mechanism is redesigned.

Usage

TBD — the composition mechanism is being redesigned. Until then, use the L1 primitives directly. See each L1 module's README for usage examples.

Compliance extension points

The composition will need to wire compliance resources across L1s when the compliance milestone (GDPR, SOX, SOC2, HIPAA, DORA) lands:

  • KMS key — shared encryption key referenced by S3, ECR, CloudWatch Logs, and Secrets Manager.
  • CloudTrail — management-plane audit trail for the entire stack.
  • VPC Flow Logs — network audit trail.
  • Security groups — proper network segmentation between ALB, service, and data tiers.
  • Private subnets — ECS tasks in private subnets with NAT egress.

See each L1 module's README for per-module compliance extension points.

Versioning

Versioning will be defined when the composition mechanism is redesigned.