Component
core/gateway/contour
A Contour ingress gateway. Contour is a Kubernetes-native ingress controller: its control plane watches the cluster's Ingress and HTTPProxy resources and programs an Envoy data plane, which terminates client HTTP and HTTPS traffic and load-balances it to the backing services those resources name. Because its routing input is the cluster's own Ingress objects rather than a wired upstream, the gateway takes no `uses` edge; applications reach it by declaring Ingress resources against its ingress class. Contour is realized on Kubernetes through a Helm Recipe; it has no standalone local-container form, so no Compose Recipe is provided. Exports the Envoy data-plane host and listen port to consumers via the provides contract. Each Envoy pod serves its own metrics on a port no Service carries, so it also publishes the pod label selecting those pods, the name of their metrics port and the path, for a scraper that discovers them directly. The control plane's own metrics are not published.
来源
- 内容摘要
- sha256:7b87e1e7e3959e2adbd4e6bd68d838658897e0d7781a21b827cb8f4db9a0f776
- 发布时间
- 2026-11-10T10:11:44Z
- 签名身份
- 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:4756c67958c28e913a4446971d4417bc80303720e2eb00d9817f2d74a8d08871
此版本的引用
oci://hub.aggrega.ai/component/core/gateway/contour:1.0.0开发者参数
开发者在 Aggregate 中设置的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| ingress_class_name | string | contour | 否 | Name of the IngressClass this controller reconciles. Applications route to the gateway by referencing this class in their Ingress or HTTPProxy resources. |
运维规格
运维人员按环境调整的基础设施规格。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| port | integer (min 1, max 65535) | 80 | 否 | HTTP port the Envoy data-plane service listens on. Most operators should omit this and let the Recipe assign the default (80). |
| 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 fronting the Envoy data plane. A consumer sends its client traffic here and the gateway load-balances it onward. |
| port | integer | — | 是 | TCP port that data plane accepts traffic on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default. |
| protocol | string | — | 否 | How the published address is spoken to — `http`, so a consumer composes an address on that scheme. |
| metrics_pod_selector | string | — | 否 | Kubernetes label selector matching the Envoy data-plane 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 通过该套接字接入的每个连接来填充。
未声明 uses 套接字。
附加槽位
Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。
未声明附加槽位。
自注入允许列表
未声明自注入管道。
关系
与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。
使用
此实体未使用目录中的任何内容。
被使用
使用套接字 «upstream»
使用套接字 «forward_target»
使用套接字 «scrape_target»
使用套接字 «store»
适用于
适用于
适用于
适用于
适用于
适用于
适用于
适用于
适用于
适用于
实现