Component

core/compute/task

A generic ephemeral compute primitive. Its operational type is `task` — ephemeral compute that runs to completion and dies, such as a database migration — with two optional fields of its own, `schedule` and `timeout`. An Aggregate declares this for work that ends, rather than `server` or `worker`, which are both long-running. helm/task runs it on Kubernetes, on its `schedule` as a CronJob and once at deploy without one. compose/task runs it on Docker Compose once at each `docker compose up`, and refuses a `schedule`. terraform/task-ecs and cloudformation/task-ecs run it as an Amazon ECS task on Fargate, on its schedule through EventBridge Scheduler, and refuse it with none, as nothing on AWS would start it. With no `schedule`, `core/manual-trigger` holds it until someone starts a run, with the command each realization's description names. Nothing renders until the Release sets `infra.image`. The image is the Release's own code, so an edge delivers what its `inject:` block dictates, and no declared socket narrows the mechanism: `env` entries become variables beside `TASK_TIMEOUT`, `timeout`'s default name, which the component's own `env` entries may replace and, while it is the default, no edge may dictate; `file` entries files, read-only on Kubernetes, and none on Amazon ECS; and `arg` or any other mechanism is refused by name, as no realization renders a command line. A `core/secret-value` attachment's value is written into the rendered workload in the clear; no realization delivers `core/referenced-secret` or `core/random-password` to it, and the helm realization refuses either by name.

Version

1.0.01.0.1

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:dbcdf6051b686ddd8192ca016c4c9d0d1fa9eca3bc6f5f2d970e2cf9acf01afa
Published
2026-11-10T10:10:18Z
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:4bc801a725e11fd739d1d227b8f19c81a12c696cd20e65cc3500cc2b83d0b7d0

Reference at this version

oci://hub.aggrega.ai/component/core/compute/task:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

Extends BaseComponents#/schemas/BaseComponentParameter

NameTypeDefaultRequiredDescription
schedulestring—noA cron expression of five fields — minute, hour, day of the month, month and day of the week — such as 30 2 * * 1-5. Kubernetes runs it in its controller manager's time zone; Amazon ECS runs it through EventBridge Scheduler, in UTC unless the Release names a time zone, and refuses one the scheduler cannot carry exactly, such as one restricting both the day of the month and the day of the week. Docker Compose has no scheduler and refuses a schedule.
timeoutstring—noHow long a run may take, delivered to the container as TASK_TIMEOUT, or under the name an env entry of the component's own inject block reading it alone gives it, for the application's own code to honour: no realization sets a deadline at which the platform stops a run.

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
imagestring—noContainer image the run executes.
computeobject—no—
overridesobject (open)—noProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads: the Amazon ECS realizations read the cluster, subnets, security groups and roles the task runs and is started under, and the schedule's time zone, each under its target's own spelling (subnet_ids on terraform, Subnets on CloudFormation), and the Kubernetes and Docker Compose realizations read none of its keys.

Output contract

Values this component publishes to consumers over the uses topology.

No output values declared.

Uses sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

No uses sockets declared.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

No attachment slots declared.

Self-inject allowlist

env

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

Component 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