Component
core/compute/server
A generic long-running server primitive. It adds no fields of its own; what it contributes is its operational type, `server` — long-running, stateless compute that expects inbound application traffic. An Aggregate declares this for a component that stays up and serves requests, rather than `worker`, with zero inbound application ports, or the run-once `task`. On a Kubernetes cluster it is a Deployment behind a ClusterIP Service. In an AWS account with an ECS cluster and a VPC, terraform/server-ecs and cloudformation/server-ecs run it as an Amazon ECS service on Fargate. In a Google Cloud project with a VPC network, terraform/server-cloud-run runs it as a Cloud Run service; in an Azure subscription with a Container Apps environment, terraform/server-container-apps as a container app. On Docker Compose, compose/server runs it, publishing no host port unless asked. The catalog pins no image, so nothing renders until the Release sets `infra.image`. The image is the Release's own code, so an edge from this component delivers what its `inject:` block dictates, and no declared socket narrows the mechanism: `env` entries become variables on every realization, `file` entries files everywhere but on Amazon ECS and Cloud Run, and `arg` or any other mechanism is refused by name, as no realization renders a command line. The component's own `inject:` block takes `env` entries too. A `core/secret-value` attachment's value is written into the rendered workload in the clear on every realization, and on Docker Compose so is a `core/referenced-secret` attachment's origin; no other realization delivers one, none delivers `core/random-password`, and the helm realization refuses either by name.
Version
Provenance
- Content digest
- sha256:bdaffb56584849a2e4ed1b7edba2e16d2b319fbfb8f5d37e768d2205c78784b4
- Published
- 2026-11-15T08:08:59Z
- 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:3b0acfa932096664bbb18ab36bf510be96a8e8e8ff1ab77c1ce948f7b7dec212
Reference at this version
oci://hub.aggrega.ai/component/core/compute/server:1.1.0Developer parameters
Values the developer sets in the Aggregate.
Extends BaseComponents#/schemas/BaseComponentParameter
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| image | string | — | no | Container image serving the application. |
| port | integer (min 1024, max 65535) | 8080 | no | Port the container listens on. On Kubernetes the fronting Service carries inbound traffic to it; on Amazon ECS it is the container port a load balancer target group the Release names sends traffic to; on Cloud Run it is the port requests are sent to, which the container is also handed as PORT; on Container Apps it is the ingress's target port, which the container is also handed as CONTAINER_APP_PORT; on Docker Compose it is the port the service answers at on the Compose network, and the one infra.published_port forwards to. |
| published_port | integer (min 1024, max 65535) | — | no | Port published on the host's loopback address, 127.0.0.1, on Docker Compose, forwarding to infra.port inside the container; any process on this machine can reach it there. Unset, nothing is published. Kubernetes realizations refuse it; reach the Service with kubectl port-forward, or attach core/public-ingress. |
| replicas | integer (min 1) | 1 | no | Replica count, the number of tasks on Amazon ECS, of instances on Cloud Run and of replicas on Container Apps, up to 300 there. The floor is one, because a server that expects inbound traffic has nothing to hold a request while it is at zero. Docker Compose runs one container and refuses a count above one. |
| 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 service runs under, each under its target's own spelling (subnet_ids on terraform, Subnets on CloudFormation), the Cloud Run realization the project, region, VPC network and service account the service runs in, the Container Apps realization the environment and resource group the app runs in and the identities and registry it pulls with, 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
uses socket «upstream»
uses socket «forward_target»
uses socket «scrape_target»
uses socket «store»
applies to
applies to
applies to
applies to
applies to
applies to
applies to
implements
implements
implements
implements
implements
implements