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, and on Docker Compose so is a `core/referenced-secret` attachment's origin; no other realization delivers `core/referenced-secret`, none delivers `core/random-password`, and the helm realization refuses either by name.
Version
Provenance
- Content digest
- sha256:03cf624d2ae77e9ac8b0ad1c9a2a15ef81253d582ce2d53758e2a0ea5632afa3
- Published
- 2026-11-15T08:09:01Z
- 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:2a329698f512d71016a645fb928c74351d20be091ac3ac5cdb035a33021f9dff
Reference at this version
oci://hub.aggrega.ai/component/core/compute/task:1.0.1Developer parameters
Values the developer sets in the Aggregate.
Extends BaseComponents#/schemas/BaseComponentParameter
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| schedule | string | — | no | A 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. |
| timeout | string | — | no | How 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.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| image | string | — | no | Container image the run executes. |
| compute | object | — | no | — |
| overrides | object (open) | — | no | Provider-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
- $refextends schema (values)
BaseComponents#/schemas/BaseComponentParameter
Used by
applies to
applies to
implements
implements
implements
implements