Эта страница переведена автоматически. Читать английский оригинал.

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.

Происхождение

ОфициальныйПодписано идентичностью подписи, которую этот каталог признаёт официальным издателем.
Дайджест содержимого
sha256:7896bcb47bca03de146ac91792d3dcd4611f2e5f6e486cc4e8e82b62f6eb7690
Опубликовано
2026-11-10T10:11:46Z
Идентичность подписи
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Подпись

  • Официальныйapplication/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

Ссылка на эту версию

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

Параметры разработчика

Значения, которые разработчик задаёт в сущности Aggregate.

Параметры разработчика не объявлены.

Размеры, задаваемые оператором

Размеры инфраструктуры, которые оператор настраивает для каждого окружения.

ИмяТипПо умолчаниюОбязательныйОписание
imagestringdocker.io/envoyproxy/ai-gateway-controller:v1.1.0нетEnvoy AI Gateway controller image the control-plane Deployment runs.
mcp_session_seed_secretstring—нет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_secretstring—нет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.

Контракт выходных значений

Значения, которые этот компонент публикует для потребителей через топологию uses.

ИмяТипПо умолчаниюОбязательныйОписание
hoststring—да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.
portinteger—даTCP port that Service serves the extension server on, which Envoy Gateway calls over gRPC.
metrics_endpointstring—нет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.

Сокеты uses

Сокеты зависимостей, через которые подключается этот компонент. Цель каждого соединения, проведённого через сокет, должна удовлетворять его селектору меток, и каждое соединение может нести подключение в слотах, которые объявляет сокет. Обязательный слот должен заполнить каждое соединение, которое сущность Aggregate или сущность Release проводит через сокет.

Сокеты uses не объявлены.

Слоты подключения

Именованные точки привязки, в которых Feature подключается к этому компоненту. Селектор слота ограничивает, какая сущность Feature может его заполнить, а его список внедрения указывает, как могут доставляться материалы сущности Feature. Обязательный слот должен быть привязан в каждом экземпляре — подключением в самом экземпляре или в области выше него, — а конфиденциальный слот объявляется для работы с секретными материалами. Feature также может подключаться под именем, которое не объявляет ни один слот.

Слоты подключения не объявлены.

Список разрешённых самовнедрений

Каналы самовнедрения не объявлены.

Связи

Типизированные рёбра к другим опубликованным сущностям и от них. Ссылка без опубликованной цели отображается как разорванное ребро, а не как ссылка.

Использует

Эта сущность ничего не использует из каталога.

Используется в

Справочник по понятию Component →

Каталог Aggrega — открытый указатель компонентов, функций, рецептов и плагинов, которые их рендерят.

Создано на общей дизайн-системе Aggrega.

Конфиденциальность