Diese Seite wurde maschinell übersetzt. Englisches Original lesen.

Component

core/gateway/envoy-ai-gateway-operator

The Envoy AI Gateway control plane: a controller that turns the project's AI routes, model backends and policies into Envoy configuration, which Envoy Gateway takes from it by calling the controller's extension server, and a mutating webhook that adds the AI external processor to each data-plane pod Envoy Gateway creates. It publishes the address of its extension server for Envoy Gateway to call, and as `metrics_endpoint` the one its own metrics are served at. Its Helm Recipe installs the project's own chart and, beside it, the six AI Gateway custom-resource definitions. The controller runs under the cluster role the project's chart grants, and that grant spans the whole cluster: the controller may read, create, change and delete every Secret, Pod, Service, Deployment and DaemonSet in every namespace, and every resource of the Gateway API, Envoy Gateway, AI Gateway and inference-pool API groups. The webhook's serving certificate is a cert-manager Certificate, signed by a self-signed Issuer the Recipe renders, so cert-manager must already run in the cluster, unless infra.webhook_tls_secret names a Secret holding the certificate, in which case cert-manager is not needed. The controller expects the Envoy Gateway it extends in the `envoy-gateway-system` namespace. A QuotaPolicy applied by hand is not enforced: its rate-limit service is installed by nothing here; a token budget on this path is core/period-budget on Envoy Gateway. MCP session identifiers are encrypted under a key derived from the seed in the Secret infra.mcp_session_seed_secret names; with none named it is the chart's published default seed, a public value, so name one before an MCP route is served through this controller.

Herkunft

OffiziellSigniert von einer Signaturidentität, die dieser Katalog als offiziellen Herausgeber anerkennt.
Inhalts-Digest
sha256:7896bcb47bca03de146ac91792d3dcd4611f2e5f6e486cc4e8e82b62f6eb7690
Veröffentlicht
2026-11-10T10:11:46Z
Signaturidentität
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signatur

  • Offiziellapplication/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:ef61e1d8cce20dbff501db5bec5f4647b80c4aadfd11c7f2bff5bca214427c16

Referenz zu dieser Version

oci://hub.aggrega.ai/component/core/gateway/envoy-ai-gateway-operator:1.0.0

Entwicklerparameter

Werte, die der Entwickler im Aggregate festlegt.

Keine Entwicklerparameter deklariert.

Dimensionierung durch den Operator

Infrastrukturdimensionierung, die der Operator pro Umgebung anpasst.

NameTypStandardwertErforderlichBeschreibung
imagestringdocker.io/envoyproxy/ai-gateway-controller:v1.1.0neinEnvoy AI Gateway controller image the control-plane Deployment runs.
mcp_session_seed_secretstring—neinName of an existing Secret the controller reads its MCP session-encryption seed from. The Secret lives in the controller's own namespace and carries a `seed` entry holding a long random string. Set, the cluster passes the seed from that Secret to the controller's argument, through an environment variable, when it starts the container, so no rendered file carries it, and the controller does not start while the Secret or the entry is missing. Unset, the controller runs with the project chart's published default seed, which anyone reading the chart knows, so an MCP route served through this controller has its session identifiers encrypted under a key derived from a public value; set this before serving an MCP route. The Secret is referenced and never created here.
webhook_tls_secretstring—neinName of an existing Secret holding the certificate the controller's webhook serves. The Secret lives in the controller's own namespace and carries three entries: `tls.crt`, a certificate valid for `<host>.<namespace>.svc`, the name the cluster's API server calls the webhook at, where `<host>` is the Service name this component publishes and `<namespace>` the controller's namespace; `tls.key`, its private key; and `ca.crt`, the CA certificate it is signed by. Set, the controller's pod mounts that Secret and the controller, when it starts, writes `ca.crt` into the webhook configuration as the CA bundle the API server verifies the webhook against, and cert-manager is not needed. It writes that bundle only when it starts, so after the Secret's CA changes, restart the controller for the API server to trust the webhook's new certificate. Unset, the certificate is a cert-manager Certificate the Recipe renders, and cert-manager must already run in the cluster. The Secret is referenced and never created here.

Ausgabevertrag

Werte, die diese Komponente über die uses-Topologie an Konsumenten veröffentlicht.

NameTypStandardwertErforderlichBeschreibung
hoststring—jaIn-cluster DNS name of the controller's Service, the name alone without a namespace; a consumer in another namespace qualifies it with the namespace the controller is placed in. Envoy Gateway calls the controller's extension server here.
portinteger—jaTCP port that Service serves the extension server on, which Envoy Gateway calls over gRPC.
metrics_endpointstring—neinThe full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:8080/metrics` on the controller's Service, whose metrics port is not the published `port`. Empty where the component serves none reachable.

uses-Sockets

Die Abhängigkeits-Sockets, über die sich diese Komponente verbindet. Das Ziel jeder über einen Socket verdrahteten Verbindung muss dessen Label-Selektor erfüllen, und jede Verbindung kann in den Slots, die der Socket deklariert, eine Anbindung tragen. Einen erforderlichen Slot muss jede Verbindung füllen, die das Aggregate oder das Release über den Socket verdrahtet.

Keine uses-Sockets deklariert.

Anbindungs-Slots

Benannte Bindungspunkte, an denen ein Feature an diese Komponente angebunden wird. Der Selektor eines Slots schränkt ein, welches Feature ihn füllen darf, und seine inject-Liste benennt, wie das Feature sein Material liefern darf. Ein erforderlicher Slot muss auf jeder Instanz gebunden sein, durch eine Anbindung an der Instanz oder in einem darüberliegenden Geltungsbereich, und ein sensibler Slot ist für den Umgang mit geheimem Material deklariert. Ein Feature kann auch unter einem Namen angebunden werden, den kein Slot deklariert.

Keine Anbindungs-Slots deklariert.

Zulassungsliste für Selbstinjektion

Keine Selbstinjektions-Pipes deklariert.

Beziehungen

Typisierte Kanten zu und von anderen veröffentlichten Entitäten. Eine Referenz ohne veröffentlichtes Ziel wird als unterbrochene Kante statt als Link dargestellt.

Verwendet

Diese Entität verwendet nichts aus dem Katalog.

Verwendet von

Konzeptreferenz zu Component →

Der Aggrega-Katalog — ein offener Index von Komponenten, Funktionen, Rezepten und den Plugins, die sie rendern.

Erstellt mit dem gemeinsamen Aggrega-Designsystem.

Datenschutz