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.
Procedencia
- Digest del contenido
- sha256:7896bcb47bca03de146ac91792d3dcd4611f2e5f6e486cc4e8e82b62f6eb7690
- Publicado
- 2026-11-10T10:11:46Z
- Identidad de firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- Oficialapplication/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
Referencia en esta versión
oci://hub.aggrega.ai/component/core/gateway/envoy-ai-gateway-operator:1.0.0Parámetros del desarrollador
Valores que el desarrollador establece en el Aggregate.
No se declararon parámetros del desarrollador.
Dimensionamiento del operador
Dimensionamiento de la infraestructura que el operador ajusta para cada entorno.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| image | string | docker.io/envoyproxy/ai-gateway-controller:v1.1.0 | no | Envoy AI Gateway controller image the control-plane Deployment runs. |
| mcp_session_seed_secret | string | — | no | Name 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_secret | string | — | no | Name 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. |
Contrato de salida
Valores que este componente publica para los consumidores a través de la topología uses.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| host | string | — | sí | In-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. |
| port | integer | — | sí | TCP port that Service serves the extension server on, which Envoy Gateway calls over gRPC. |
| metrics_endpoint | string | — | no | The 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. |
Sockets uses
Los sockets de dependencia a través de los cuales se conecta este componente. El destino de cada conexión cableada a través de un socket debe satisfacer su selector de etiquetas, y cada conexión puede llevar un acoplamiento en los slots que declara el socket. Cada conexión que el Aggregate o la Release cablea a través del socket debe llenar los slots obligatorios.
No se declararon sockets uses.
Slots de acoplamiento
Puntos de enlace con nombre en los que una Feature se acopla a este componente. El selector de un slot restringe qué Feature puede llenarlo y su lista inject indica cómo puede entregarse el material de la Feature. Un slot obligatorio debe estar enlazado en cada instancia, mediante un acoplamiento en la instancia o en un ámbito superior, y un slot sensible se declara para manejar material secreto. Una Feature también puede acoplarse con un nombre que ningún slot declara.
No se declararon slots de acoplamiento.
Lista de permitidos de autoinyección
No se declararon canales de autoinyección.
Relaciones
Aristas tipadas hacia y desde otras entidades publicadas. Una referencia sin un destino publicado se muestra como una arista rota en lugar de como un enlace.
Usa
Esta entidad no usa nada del catálogo.
Usado por
usa el socket «extension»
usa el socket «upstream»
usa el socket «forward_target»
usa el socket «scrape_target»
usa el socket «store»
se aplica a
se aplica a
se aplica a
se aplica a
se aplica a
se aplica a
se aplica a
se aplica a
implementa