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.
Nguồn gốc
- Digest nội dung
- sha256:7896bcb47bca03de146ac91792d3dcd4611f2e5f6e486cc4e8e82b62f6eb7690
- Đã xuất bản
- 2026-11-10T10:11:46Z
- Danh tính ký
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Chữ ký
- Chính thứcapplication/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
Tham chiếu ở phiên bản này
oci://hub.aggrega.ai/component/core/gateway/envoy-ai-gateway-operator:1.0.0Tham số của nhà phát triển
Các giá trị mà nhà phát triển đặt trong Aggregate.
Chưa khai báo tham số nào của nhà phát triển.
Định cỡ của người vận hành
Định cỡ hạ tầng mà người vận hành tinh chỉnh theo từng môi trường.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| image | string | docker.io/envoyproxy/ai-gateway-controller:v1.1.0 | không | Envoy AI Gateway controller image the control-plane Deployment runs. |
| mcp_session_seed_secret | string | — | không | 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 | — | không | 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. |
Hợp đồng đầu ra
Các giá trị mà thành phần này xuất bản cho bên tiêu thụ qua cấu trúc liên kết uses.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| host | string | — | có | 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 | — | có | TCP port that Service serves the extension server on, which Envoy Gateway calls over gRPC. |
| metrics_endpoint | string | — | không | 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. |
Các socket uses
Các socket phụ thuộc mà thành phần này kết nối qua. Đích của mọi kết nối được nối qua một socket phải thỏa mãn bộ chọn nhãn của socket đó, và mỗi kết nối có thể mang theo phần đính kèm trong các slot mà socket khai báo. Một slot bắt buộc phải được đáp ứng bởi mỗi kết nối mà Aggregate hoặc Release nối qua socket.
Chưa khai báo socket uses nào.
Slot đính kèm
Các điểm liên kết có tên mà tại đó một Feature được gắn vào thành phần này. Bộ chọn của một slot giới hạn Feature nào có thể lấp đầy nó, và danh sách tiêm của slot nêu cách nội dung của Feature có thể được chuyển giao. Một slot bắt buộc phải được liên kết trên mọi thể hiện, bằng một phần đính kèm trên thể hiện đó hoặc ở một phạm vi phía trên nó, và một slot nhạy cảm được khai báo để xử lý nội dung bí mật. Một Feature cũng có thể được gắn dưới một tên mà không slot nào khai báo.
Chưa khai báo slot đính kèm nào.
Danh sách cho phép tự tiêm
Chưa khai báo đường ống tự tiêm nào.
Quan hệ
Các cạnh có kiểu đi tới và đi từ các thực thể đã xuất bản khác. Một tham chiếu không có đích đã xuất bản được hiển thị là một cạnh bị đứt thay vì một liên kết.
Sử dụng
Thực thể này không sử dụng gì trong danh mục.
Được sử dụng bởi
sử dụng socket «extension»
sử dụng socket «upstream»
sử dụng socket «forward_target»
sử dụng socket «scrape_target»
sử dụng socket «store»
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
áp dụng cho
triển khai