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
Provenance
- Content digest
- sha256:baaf8284d6cf1104ca197652d4dcd6047566c5b3fb2817d6f46251e7fb6f9ec4
- Published
- 2026-11-15T08:09:27Z
- 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:33a125ed04eb543644e4a3becdccfa48d18cf528cc6b7a0cffd0cbaf502efa63
Reference at this version
oci://hub.aggrega.ai/recipe/compose/nginx:1.0.1- Target
- —
- Implements
- core/gateway/nginx:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
| Name | Template |
|---|---|
| host | {{ .context.instance_id }} |
| port | {{ .infra.port }} |
| protocol | http |
Workload
Workload · containers: main
Locals
| Name | Template |
|---|---|
| upstream_host_variable | NGINX_UPSTREAM_HOST |
| upstream_port_variable | NGINX_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.