Component

core/gateway/nginx

An NGINX reverse-proxy gateway. NGINX terminates client HTTP traffic and forwards it to an upstream service wired through its `upstream` uses-socket: the upstream host and port arrive on the injection context and are rendered into the NGINX server configuration as the proxy_pass target, so the gateway routes to whichever component the topology binds. NGINX holds no persistent state, so it renders as a stateless server with no volume. Provider-agnostic: the same component is implemented by a synthesized Helm Recipe on the official NGINX image (Kubernetes) and a Compose Recipe (local development). Exports its host and listen port to consumers via the uses topology. The optional guard socket takes the core/security/nemo-guardrails a core/prompt-injection-shield attachment sends every forwarded request through in place of the upstream; wired alone it changes no request.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:08b1ca48d3c2871ade1295b70cfb4f5b0e827172c4f0fc9c92ae8d78c02dee64
Published
2026-11-10T10:12:19Z
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:90a272f811730b256b1146c24e68d287134d443bcc2116b86a2b719f6ef9aca7

Reference at this version

oci://hub.aggrega.ai/component/core/gateway/nginx:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

NameTypeDefaultRequiredDescription
upstream_pathstring/noLocation path prefix the gateway proxies to the upstream. Requests matching this prefix are forwarded to the upstream wired on the `upstream` socket.

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
portinteger (min 1024, max 65535)8080noHTTP port NGINX listens on. Most operators should omit this and let the Recipe assign the default (8080).
engine_versionstring1.27.5-alpinenoNGINX container image tag for the official upstream nginx image. Both targets — the synthesized Helm Deployment (Kubernetes) and the Compose service (local) — run `nginx:<engine_version>`.
computeobject—no—
overridesobject (open)—noProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
hoststring—yesIn-cluster DNS name of the Service fronting the proxy. A consumer sends its client traffic here and the gateway forwards it to whichever component the topology bound to its upstream socket.
portinteger—yesTCP port that Service accepts client traffic on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default.
protocolstring—noHow the published address is spoken to — `http`, so a consumer composes an address on that scheme.

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.

upstream

Selector
component.aggrega.ai/type=server
Inject
env

This socket declares no attachment slots, so a connection through it carries no attachment.

guard

Selector
dataplane.aggrega.ai/prompt-guard=classifier
Inject
—

This socket declares no attachment slots, so a connection through it carries no attachment.

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