FeatureRecipe

traffic-shadowing-nginx

Component-scope FeatureRecipe for core/traffic-shadowing on the NGINX gateway, core/gateway/nginx, under Docker Compose. The copy is a setting inside the server configuration the gateway's own Recipe writes rather than a service of its own, so this recipe emits nothing: the NGINX Recipe reads the attachment and adds the mirror to the location it forwards, sending a copy of every forwarded request, with its original URI, to the service the attachment's infra names, and discarding that service's response. NGINX copies every request it forwards and has no setting that copies a share of them — the gateway declares dataplane.aggrega.ai/request-mirroring: full-rate — so this recipe halts on a shadow_percent below 100 rather than copying more traffic than was asked for. It also halts when the attachment is carried by any component other than core/gateway/nginx, because no other component's Recipe reads it, and the attachment would render no copy at all. The service the copies go to has to resolve on the compose network when NGINX starts, as the upstream does.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:9fd4b95f884540f834a75c29cc52d87dabed58a2191d088fb8e2723f6c1a8b7d
Published
2026-11-10T10:15:01Z
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:6bb9d9c58f0d92fdb9593e173d3b01c8cd52dfda617dd54b6beccd9c9ce4a01e

Reference at this version

oci://hub.aggrega.ai/featurerecipe/compose/traffic-shadowing-nginx:1.0.0
Target
—
Implements
core/traffic-shadowing:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

No provides templates declared.

Workload

No workload template declared.

Locals

No locals declared.

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

Used by

Nothing in the catalog depends on this entity.

FeatureRecipe 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