Component
core/gateway/envoy-gateway
An Envoy Gateway ingress gateway, programmed through the Gateway API. Its control plane watches the cluster's GatewayClass, Gateway and route resources and configures an Envoy data plane, which terminates client HTTP traffic — and HTTPS too, where the Release names a certificate Secret through tls_secret — and load-balances it to the Services those routes name. This Component installs the control plane and claims the gateway class and the gateway itself. An application reaches it by declaring a route naming the gateway as its parent, and the gateway is named after the component the Aggregate declares. Realized on Kubernetes through a Helm Recipe; it has no standalone local-container form, so no Compose Recipe is provided. It publishes the pod label, port name and path a scraper discovers its proxies' metrics by. It also serves models through Envoy AI Gateway. Wired to the AI gateway controller on its extension socket, it calls that controller as its extension server, and the Release must place it in envoy-gateway-system or the build halts. Each model on its models socket is served under /v1 at the gateway's address to a request naming the connection's alias, with that connection's credential. The gateway publishes that address as its endpoint, qualified with envoy-gateway-system so an agent in any namespace reaches it, and values.model as its model. While a model is wired, every route on the gateway takes the 50Mi per-connection request buffer Envoy AI Gateway configures. It realizes core/period-budget in tokens, core/retry-policy, core/concurrency-limit per model, and core/audit-logging with no cost or verified caller.
출처
- 콘텐츠 다이제스트
- sha256:3afd79abd963d7eaaa6fc702d5c2288b28bb3c6485a5a4bbb604d919aa3cfe95
- 게시일
- 2026-11-10T10:11:47Z
- 서명 ID
- 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:d14ea54a288890aca449abf7e0af2ac73fddc7e25fa4ecbdb660e071f92f71bd
이 버전의 참조
oci://hub.aggrega.ai/component/core/gateway/envoy-gateway:1.0.0개발자 매개변수
개발자가 Aggregate에서 설정하는 값입니다.
| 이름 | 타입 | 기본값 | 필수 | 설명 |
|---|---|---|---|---|
| gateway_class_name | string | envoy-gateway | 아니요 | Name of the gateway class this install claims. The gateway declares this class, and the class is cluster-scoped, so two installs sharing a cluster need two different names. |
| allowed_route_namespaces | string (Same | All) | Same | 아니요 | Which namespaces may attach a route to the gateway's listeners. `Same` accepts routes from the gateway's own namespace only, which is what the routing API assumes when nothing says otherwise; `All` accepts routes from every namespace. Stated explicitly so the narrower of the two is a choice a reader can see rather than a default they meet later. |
| model | string | — | 아니요 | The alias of a connection on the models socket that this gateway publishes as its model, the model name a component wired to the gateway sends. It must be an alias a models connection carries, and the build halts naming this value otherwise; it is required while the models socket holds a connection, and omitted while it holds none. |
운영자 사이징
운영자가 환경별로 조정하는 인프라 사이징입니다.
| 이름 | 타입 | 기본값 | 필수 | 설명 |
|---|---|---|---|---|
| image | string | docker.io/envoyproxy/gateway:v1.9.1 | 아니요 | Control-plane container image the gateway's controller runs. Set this to pull the same release from a mirror or a private registry. |
| controller_name | string | gateway.envoyproxy.io/gatewayclass-controller | 아니요 | Controller name the gateway class is claimed under. The control plane is configured to answer for this same name, so the two halves cannot disagree; change it only where a second control plane in the cluster already answers for the default. |
| port | integer (min 1, max 65535) | 80 | 아니요 | HTTP port the gateway's plain HTTP listener accepts client traffic on. Most operators should omit this and let the Recipe assign the default (80). |
| tls_secret | string | — | 아니요 | Name of an existing Secret of type kubernetes.io/tls, in the gateway's own namespace, holding the certificate and private key the gateway presents to clients. Set, the gateway gains a second listener named `https`, on port 443 with protocol HTTPS, which terminates TLS with that certificate beside the plain HTTP listener; a route attaches to it alone by naming that listener, and to both by naming none. Left unset, the gateway carries its plain HTTP listener alone. The Secret is referenced and never created here; it is the operator's, or a certificate controller's, to provide. |
| install_crds | boolean | true | 아니요 | Whether this Release installs the custom-resource definitions the gateway and its routes are written against, together with the upgrade-safety policy that guards them. Set false where the cluster manages those definitions separately, and affirm control_plane_present when you do. |
| control_plane_present | boolean | false | 아니요 | Affirms that the custom-resource definitions this Release does not install are already present in the target cluster. The compiler runs ahead of time and cannot inspect a cluster, so it asks rather than checks. With install_crds set false and this left unaffirmed, the build halts rather than emitting a gateway class and a gateway that nothing would reconcile. |
| source_version | string | — | 아니요 | Source artifact version (Helm chart). Overrides the Recipe's default source version. Changing from default does not guarantee value mapping compatibility. |
| compute | object | — | 아니요 | — |
| overrides | object (open) | — | 아니요 | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
출력 계약
이 컴포넌트가 uses 토폴로지를 통해 소비자에게 게시하는 값입니다.
| 이름 | 타입 | 기본값 | 필수 | 설명 |
|---|---|---|---|---|
| host | string | — | 아니요 | In-cluster DNS name of the Service Envoy Gateway creates for this gateway's data plane, in the gateway's own namespace, the name alone without a namespace; a consumer in another namespace qualifies it with envoy-gateway-system, where the gateway sits while a model is wired, as endpoint already does. A consumer sends its client traffic here rather than to the service behind the gateway. Empty while nothing is wired to the models socket. |
| port | integer | — | 예 | TCP port that Service accepts the gateway's plain HTTP listener on, infra.port. |
| protocol | string | — | 아니요 | How the published address is spoken to — `http`, so a consumer composes an address on that scheme. |
| endpoint | string | — | 아니요 | Full base URL of the OpenAI-compatible API the gateway serves for the models wired to its models socket, with the host, the port and the /v1 path already composed. The host is qualified with envoy-gateway-system, the namespace the build requires the gateway to sit in whenever a model is wired, so the URL resolves from any namespace. A caller hands it to a client library as its base URL and names values.model as its model; every other wired model is served at the same URL under its own alias as the model name. Empty while nothing is wired to the models socket. |
| model | string | — | 아니요 | The alias a consumer wired to the gateway sends as its model name: values.model. The gateway's route sends a request naming it to the model wired under that alias, asking for the model name that model publishes. Empty while nothing is wired to the models socket. |
| metrics_pod_selector | string | — | 아니요 | Kubernetes label selector matching this gateway's Envoy proxy pods, for a scraper that discovers those pods directly rather than scraping one address. Published beside `metrics_pod_port` and `metrics_path`. |
| metrics_pod_port | string | — | 아니요 | Name of the container port on those pods that carries the metrics, `metrics`. |
| metrics_path | string | — | 아니요 | Path the metrics are served at on that port, `/stats/prometheus`. |
uses 소켓
이 컴포넌트가 연결에 사용하는 의존성 소켓입니다. 소켓을 통해 배선되는 모든 연결의 대상은 해당 소켓의 레이블 셀렉터를 충족해야 하며, 각 연결은 소켓이 선언한 슬롯에 첨부를 전달할 수 있습니다. 필수 슬롯은 Aggregate 또는 Release가 해당 소켓을 통해 배선하는 각 연결이 채워야 합니다.
extension
- 셀렉터
- gateway.aggrega.ai/extension-server=envoy-gateway
- 주입
- —
이 소켓은 첨부 슬롯을 선언하지 않으므로 이 소켓을 통한 연결은 첨부를 전달하지 않습니다.
models
- 셀렉터
- component.aggrega.ai/category=ai-model
- 주입
- —
이 소켓을 통한 각 연결이 채울 수 있는 슬롯
| 슬롯 | 셀렉터 | 필수 | 주입 | 민감 | 설명 |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | 아니요 | — | 예 | Optional credential the gateway presents to the model this connection reaches, as a bearer token. When attached, the connection's backend security policy names the Secret the credential publishes, and the AI gateway controller reads the key from that Secret, in the gateway's namespace, under the data key apiKey, which the credential must publish: any other data key halts the build. The key appears in no rendered file. Unattached, the gateway adds no credential. |
cache
- 셀렉터
- datastore.aggrega.ai/engine=kv
- 주입
- —
이 소켓을 통한 각 연결이 채울 수 있는 슬롯
| 슬롯 | 셀렉터 | 필수 | 주입 | 민감 | 설명 |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | 아니요 | — | 예 | Optional password the gateway's rate-limit service presents to the Redis-protocol store this connection reaches. When attached, the Recipe hands the service a reference to the Secret the credential publishes, under the data key it publishes, and the service reads the password from that Secret in the gateway's namespace, so the password appears in no rendered file; a credential publishing no Secret name and data key halts the build. Unattached, the service connects with no password, which is what the shipped store components expect by default. |
| server_ca | feature.aggrega.ai/kind=secret | 아니요 | file | 예 | Optional authority the gateway's rate-limit service checks the store's certificate against while the store publishes protocol valkey-tls or redis-tls, where the image does not already trust the authority that signs it. Its Secret holds ca.crt and sits in the gateway's namespace, where the service runs. The Recipe mounts the whole Secret into the service and points the service at the file. The build halts on a server_ca publishing no Secret name, and on one wired to a store served without TLS. Fill it with core/referenced-secret. |
첨부 슬롯
Feature가 이 컴포넌트에 첨부되는 이름 있는 바인딩 지점입니다. 슬롯의 셀렉터는 어떤 Feature가 슬롯을 채울 수 있는지를 제한하고, 슬롯의 inject 목록은 Feature의 자료를 어떻게 전달할 수 있는지를 지정합니다. 필수 슬롯은 인스턴스의 첨부 또는 그 위 범위의 첨부를 통해 모든 인스턴스에서 바인딩되어야 하며, 민감 슬롯은 비밀 자료를 처리하도록 선언됩니다. Feature는 어떤 슬롯도 선언하지 않은 이름으로 첨부될 수도 있습니다.
선언된 첨부 슬롯이 없습니다.
자체 주입 허용 목록
선언된 자체 주입 파이프가 없습니다.
관계
게시된 다른 엔터티와 주고받는 타입 지정 에지입니다. 게시된 대상이 없는 참조는 링크가 아닌 끊어진 에지로 표시됩니다.
사용함
- 사용소켓 «extension» 사용
gateway.aggrega.ai/extension-server=envoy-gateway
첨부 슬롯을 선언하지 않습니다.
- 사용소켓 «models» 사용
component.aggrega.ai/category=ai-model
첨부 슬롯: credential
core/ai-model/ai21 v1.0.0 →core/ai-model/anthropic v1.0.0 →core/ai-model/azure-managed v1.0.0 →core/ai-model/azure-openai v1.0.0 →core/ai-model/azure-openai-embedding v1.0.0 →core/ai-model/bedrock v1.0.0 →core/ai-model/bedrock-embedding v1.0.0 →core/ai-model/cohere v1.0.0 →core/ai-model/databricks v1.0.0 →core/ai-model/docker-model-runner v1.0.0 →core/ai-model/gemini v1.0.0 →core/ai-model/huggingface v1.0.0 →core/ai-model/litellm v1.0.0 →core/ai-model/mistral v1.0.0 →core/ai-model/nemoguard-content-safety v1.0.0 →core/ai-model/nvidia-api v1.0.0 →core/ai-model/nvidia-nim v1.0.0 →core/ai-model/nvidia-nim-operator v1.0.0 →core/ai-model/ollama v1.0.0 →core/ai-model/openai v1.0.0 →core/ai-model/openai-compatible v1.0.0 →core/ai-model/openai-embedding v1.0.0 →core/ai-model/replicate v1.0.0 →core/ai-model/sagemaker v1.0.0 →core/ai-model/tei v1.0.0 →core/ai-model/tgi v1.0.0 →core/ai-model/vertex-ai v1.0.0 →core/ai-model/vertex-ai-embedding v1.0.0 →core/ai-model/vllm v1.0.0 → - 사용소켓 «cache» 사용
datastore.aggrega.ai/engine=kv
첨부 슬롯: credential, server_ca
사용됨
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «model» 사용
소켓 «target_model» 사용
소켓 «extraction_model» 사용
소켓 «embedding_model» 사용
소켓 «upstream» 사용
소켓 «forward_target» 사용
소켓 «scrape_target» 사용
소켓 «store» 사용
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
적용 대상
구현