Recipe

nginx

NGINX reverse-proxy gateway for local development via Docker Compose. Synthesized-mode Workload — the compose provider translates the Workload into a service entry. The upstream host and port arrive on .context.inject.env under the two variables the locals name, which the `upstream` edge's inject block names, and are written into a minimal NGINX server configuration whose proxy_pass forwards matching requests to that upstream. With an edge wired on any socket but guard and either variable missing from the pipe, the build halts naming the edge and its socket; with neither on the pipe and no such edge, the location answers 503. A core/prompt-injection-shield attachment's realization (prompt-injection-shield-nginx) writes the two variables with the address of the guard wired to the guard socket. provides.host is the bare service name, resolved on the compose network. Each core/traffic-shadowing attachment on the component adds a mirror to that location, sending a copy of every forwarded request, with its original URI, to the service the attachment's infra names, whose response NGINX discards. NGINX cannot copy a share of the requests, so the FeatureRecipe realizing the attachment (traffic-shadowing-nginx) halts on a share below 100, and this Recipe halts on an attachment to a gateway that forwards nothing. With no such attachment the configuration carries no mirror. Each core/concurrency-limit attachment adds a cap, one total across NGINX's worker processes, and a request past it is answered 503; concurrency-limit-nginx refuses scope model.

Version

1.0.01.0.1

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:ce4db597a882cd5bddf07e7ef3b4be221dfbedeaf5f4ae26a8b32afe72784b25
Published
2026-11-10T10:19:58Z
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:9021371e888bf09f71b0478b71fce790f7ac8ca2157f0ef0a4e8246c022fc1d7

Reference at this version

oci://hub.aggrega.ai/recipe/compose/nginx:1.0.0
Target
—
Implements
core/gateway/nginx:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}
port{{ .infra.port }}
protocolhttp

Workload

Workload · containers: main

Locals

NameTemplate
upstream_host_variableNGINX_UPSTREAM_HOST
upstream_port_variableNGINX_UPSTREAM_PORT

Values mapping

No values mapping declared.

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

  • implementsimplementscontract compatible

    core/gateway/nginx:1.0.0

    All required outputs are satisfied and every provided output is named in the contract.

Used by

Nothing in the catalog depends on this entity.

Recipe 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