Recipe

task

The generic ephemeral compute primitive on Docker Compose: one service running infra.image to completion, with restart set to no, so Compose never starts it again when it exits. Reach for helm/task on Kubernetes, which also runs a task on a schedule. With nothing attached, the service runs once each time the stack is started with docker compose up. With core/manual-trigger attached, it carries the profile manual, so docker compose up leaves it stopped and each run is one someone starts with docker compose run --rm <service>, the service named after the component. A task with a schedule is refused by name, as Docker Compose has no scheduler. The service is sized from infra.compute and publishes no port. The developer's timeout value reaches the container as TASK_TIMEOUT by default for the application's own code to honour, as Compose sets no deadline on a run. An edge's inject block dictates what reaches the container: each env entry a variable under that name, beside TASK_TIMEOUT, which no edge may dictate while it is the default, and each file entry a file from a Compose config. The component's own inject block delivers env entries the same way, and one reading timeout alone replaces TASK_TIMEOUT, its default name. An arg entry, or any other mechanism, is refused by name: the recipe renders no command line.

Version

1.0.01.0.1

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:b723ff809d0595946b9c81b7ec63ef7254f7fa6fdad9c78516992dfde45d8bc8
Published
2026-11-10T10:20:58Z
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:d705c6452e7f47f6dd490540586565e8d8d2d79aa8028b94ccdb2745b55101cd

Reference at this version

oci://hub.aggrega.ai/recipe/compose/task:1.0.0
Target
—
Implements
core/compute/task:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

No provides templates declared.

Workload

No workload template declared.

Locals

NameTemplate
instance_id{{ .context.instance_id }}
cpu_millicores{{- $c := toString (optional (optional .infra "compute" dict) "cpu" "") -}} {{- if regexMatch `^[0-9]+m task 1.0.0 · Aggrega Catalog $c -}}{{ atoi (trimSuffix "m" $c) }} {{- else if regexMatch `^[0-9]+(\.[0-9]{1,3})? task 1.0.0 · Aggrega Catalog $c -}} {{- $p := splitList "." $c -}}{{- $f := 0 -}} {{- if eq (len $p) 2 }}{{ $f = atoi (substr 0 3 (printf "%s000" (index $p 1))) }}{{ end -}} {{- add (mul (atoi (index $p 0)) 1000) $f -}} {{- end -}}
memory_mib{{- $m := toString (optional (optional .infra "compute" dict) "memory" "") -}} {{- if regexMatch `^[0-9]+Mi task 1.0.0 · Aggrega Catalog $m -}}{{ atoi (trimSuffix "Mi" $m) }} {{- else if regexMatch `^[0-9]+Gi task 1.0.0 · Aggrega Catalog $m -}}{{ mul (atoi (trimSuffix "Gi" $m)) 1024 }} {{- end -}}
cpus{{- $mc := atoi (toString .locals.cpu_millicores) -}} {{- if mod $mc 1000 -}}{{ printf "%d.%03d" (div $mc 1000) (mod $mc 1000) | trimSuffix "0" | trimSuffix "0" }} {{- else -}}{{ div $mc 1000 }} {{- end -}}
memory_bytes{{ mul (atoi (toString .locals.memory_mib)) 1048576 }}

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

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy