Recipe

envoy-ai-gateway-operator

Installs the Envoy AI Gateway control plane through the project's own Helm chart, referenced as an artifact in a container registry at the release the controller image comes from. The chart's render carries the controller Deployment and its arguments, the Service Envoy Gateway, the cluster's API server and a metrics scraper reach it on, its service account, the cluster role and binding granting what the project's chart grants, a cluster role letting Envoy Gateway read inference pools, and the mutating webhook configuration that adds the AI external processor to each Envoy Gateway data-plane pod. That Service's /metrics address on 8080 is provides.metrics_endpoint. Beside the chart it emits the six AI Gateway custom-resource definitions, carried beside this Recipe exactly as the project's definitions chart publishes them at the same release. The webhook's serving certificate comes from cert-manager by default: the chart's Certificate and self-signed Issuer are rendered, so cert-manager must already run in the cluster. With infra.webhook_tls_secret set it is the certificate in the Secret that key names, which the operator creates beforehand: no Certificate or Issuer is rendered, cert-manager is not needed, and the Secret the chart would otherwise generate is left out. Every namespaced resource lands in the namespace the Release declares for the component, or in `default` where none is declared; the controller expects the Envoy Gateway it extends in `envoy-gateway-system`, the chart's own default. The controller's MCP session-encryption seed is read when it starts from the Secret infra.mcp_session_seed_secret names, and is otherwise the chart's published default.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:66aef5d000b46c703897c9fdc5789011aec9e610744d62da8e1396ac3f541594
Published
2026-11-10T10:23:23Z
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:75c102a3032306ddcd5f737a837f6d626829f61157adcb1cb3404e6e9453807b

Reference at this version

oci://hub.aggrega.ai/recipe/helm/envoy-ai-gateway-operator:1.0.0
Target
—
Implements
core/gateway/envoy-ai-gateway-operator:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.rendered_name }}
port1063
metrics_endpointhttp://{{ .context.rendered_name }}:8080/metrics

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.

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