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

1.0.01.1.0

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
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.0

Developer parameters

Values the developer sets in the Aggregate.

Extends BaseComponents#/schemas/BaseComponentParameter

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
imagestring—noContainer image serving the application.
portinteger (min 1024, max 65535)8080noPort 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_portinteger (min 1024, max 65535)—noPort 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.
replicasinteger (min 1)1noReplica 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.
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 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

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