Recipe
worker-ecs
The generic background-worker primitive as one Amazon ECS service on Fargate, running infra.replicas tasks of the Release's image, rendered as a CloudFormation fragment the provider assembles into the boundary's stack. Reach for it where the target is an AWS account with an ECS cluster and a VPC; reach for helm/worker on a Kubernetes cluster. The cluster, subnets, security groups and execution role come from the operator, under infra.overrides, and each is required; a task role, a public IP and a log group are optional, and nothing is emitted for one left unset. Only a task definition and a service are emitted — no cluster, role, security group, log group or load balancer, each of which the operator already runs — and the container maps no port, so nothing connects to the worker. No container health check is declared, because ECS runs one inside an image this Recipe does not name. Each env entry an edge's inject block, or the component's own, dictates becomes an entry of the container's environment under that name, its value written whole, so a neighbour's address arrives as an Fn::GetAtt in the same stack and as an Fn::ImportValue from another; concurrency and queue_depth_hint arrive by default as WORKER_CONCURRENCY and WORKER_QUEUE_DEPTH_HINT, which no edge may dictate while they are the defaults. File, arg and other entries are refused by name: Fargate writes no file, and no command line is rendered. The task runs at the smallest Fargate size meeting both infra.compute.cpu and infra.compute.memory, so the Component's defaults run at 0.25 vCPU and 512 MiB. It is written as a fragment, as the catalog writes its CloudFormation Recipes, rather than sourced from a published template.
Provenance
- Content digest
- sha256:3e679cf938fe547e303129087293f62f8aef6720c6b9aebd3a6be677245a00ac
- Published
- 2026-11-10T10:18:07Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:c94f9b5f94f259cbfb801d921e1bf1bd33224be0fe89a4303f03d7b5714c46e1
Reference at this version
oci://hub.aggrega.ai/recipe/cloudformation/worker-ecs:1.0.0- Target
- —
- Implements
- core/compute/worker:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
No provides templates declared.
Workload
No workload template declared.
Locals
| Name | Template |
|---|---|
| logical_id | {{ capitalizedWords .context.instance_id }} |
| cpu_millicores | {{- $c := toString (optional (optional .infra "compute" dict) "cpu" "") -}} {{- if regexMatch `^[0-9]+m
|
| memory_mib | {{- $m := toString (optional (optional .infra "compute" dict) "memory" "") -}} {{- if regexMatch `^[0-9]+Mi
|
| task_size | {{- $found := "" -}} {{- if and .locals.cpu_millicores .locals.memory_mib -}} {{- $mc := atoi .locals.cpu_millicores -}}{{- $mib := atoi .locals.memory_mib -}} {{- range list (list 256 (list 512 1024 2048)) (list 512 (untilStep 1024 4097 1024)) (list 1024 (untilStep 2048 8193 1024)) (list 2048 (untilStep 4096 16385 1024)) (list 4096 (untilStep 8192 30721 1024)) (list 8192 (untilStep 16384 61441 4096)) (list 16384 (untilStep 32768 122881 8192)) (list 32768 (list 61440 122880 249856)) -}} {{- $cpu := index . 0 -}} {{- if and (not $found) (ge (mul $cpu 1000) (mul $mc 1024)) -}} {{- range index . 1 }}{{ if and (not $found) (ge . $mib) }}{{ $found = printf "%d/%d" $cpu . }}{{ end }}{{ end -}} {{- end -}} {{- end -}} {{- end -}} {{- $found -}} |
| task_cpu | {{ if .locals.task_size }}{{ index (splitList "/" .locals.task_size) 0 }}{{ end }} |
| task_memory | {{ if .locals.task_size }}{{ index (splitList "/" .locals.task_size) 1 }}{{ end }} |
Values mapping
No values mapping declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
- implementsimplements
core/compute/worker:1.0.0
Used by
Nothing in the catalog depends on this entity.