Component
core/compute/function
A generic event-driven compute primitive. Its operational type is `function` — event-driven compute that scales to zero — and it adds a required `runtime` value to the shared base schema's optional `display_name` and `description` knobs. An Aggregate whose work is event-triggered and idles at no capacity declares this rather than `server`, which expects inbound application traffic, or `task`, which runs once and ends. Declaring no `provides`, it publishes nothing across an edge. On Kubernetes it is realized two ways, chosen in the Manifest: as a Knative Service, or as a Deployment paired with a KEDA scaling resource; either control plane is a prerequisite the operator affirms in the Release, and the build halts while it is unaffirmed. Where the target is an AWS account, terraform/function-lambda and cloudformation/function-lambda run it as an AWS Lambda function from a container image in Amazon ECR, and emit no trigger and no URL: what invokes it is the operator's. 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 `FUNCTION_RUNTIME`, `runtime`'s default name, which the component's own `env` entries may replace and, while it is the default, no edge may dictate; `file` entries read-only files on Kubernetes only; 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 rendered in the clear; no realization delivers `core/referenced-secret` or `core/random-password` to it, and the two helm realizations refuse either by name.
Provenance
- Content digest
- sha256:f213d8a7c94a54aea28b7cbb39bfbe193bbce0cd92d917b2dfe76e2b7490bf1f
- Published
- 2026-11-10T10:10:08Z
- 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:a90266cb64063dbddda57b7aa49abfc3e0c13c7bc94ebcd420f5c198eb7243c6
Reference at this version
oci://hub.aggrega.ai/component/core/compute/function:1.0.0Developer parameters
Values the developer sets in the Aggregate.
Extends BaseComponents#/schemas/BaseComponentParameter
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| runtime | string | — | yes | — |
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| image | string | — | no | Container image serving the function. On AWS Lambda it is an image in Amazon ECR, in the function's Region, that implements Lambda's runtime API. |
| port | integer (min 1024, max 65535) | 8080 | no | Port the function's container listens on. Read on Kubernetes only: Lambda hands each invocation to the image through its runtime API rather than over a port. |
| compute | object | — | no | — |
| min_replicas | integer (min 0) | 0 | no | Replica floor. Zero is what lets the function occupy no compute between the events that invoke it. On Lambda a floor above zero is provisioned concurrency on the function's published version. |
| max_replicas | integer (min 1) | 5 | no | Replica ceiling the realization's autoscaler may reach. On Lambda it is the function's reserved concurrency. |
| control_plane_present | boolean | false | no | Operator affirmation that the control plane the chosen realization needs is installed in the target cluster. The build halts unless this is set true, so a custom resource is never emitted as an orphan into a cluster that cannot reconcile it. Read on Kubernetes only: Lambda needs no control plane of the operator's. |
| scaler | object | — | no | — |
| overrides | object (open) | — | no | Realization-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads: the AWS Lambda realizations read the function's execution role and the log group, time limit and VPC placement it runs with, each under its target's own spelling (lambda_role on terraform, Role on CloudFormation). |
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
implements
implements
implements
implements