FeatureRecipe

traffic-shadowing-nginx

Component-scope FeatureRecipe for core/traffic-shadowing on the NGINX gateway, core/gateway/nginx, on Kubernetes. The copy is a setting inside the server configuration the gateway's own Recipe writes rather than a resource of its own, so this recipe emits no file: 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 when NGINX starts, as the upstream does.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:96fae0fd3dc8ee54ca832366f76e14faefeffba286fb18cbeb798506b46309e4
Published
2026-11-10T10:16:36Z
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:70f6f5b17084eb1e575abe86c2a374e54a9bda70a13a351f25d1f8a3e82be112

Reference at this version

oci://hub.aggrega.ai/featurerecipe/helm/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