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.
Provenance
- Content digest
- sha256:7b87e1e7e3959e2adbd4e6bd68d838658897e0d7781a21b827cb8f4db9a0f776
- Published
- 2026-11-10T10:11:44Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/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
Reference at this version
oci://hub.aggrega.ai/component/core/gateway/contour:1.0.0Developer parameters
Values the developer sets in the Aggregate.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| ingress_class_name | string | contour | no | Name of the IngressClass this controller reconciles. Applications route to the gateway by referencing this class in their Ingress or HTTPProxy resources. |
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| port | integer (min 1, max 65535) | 80 | no | 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 | — | no | Source artifact version (Helm chart). Overrides the Recipe's default source version. Changing from default does not guarantee value mapping compatibility. |
| compute | object | — | no | — |
| overrides | object (open) | — | no | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Output contract
Values this component publishes to consumers over the uses topology.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| host | string | — | yes | 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 | — | yes | 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 | — | no | How the published address is spoken to — `http`, so a consumer composes an address on that scheme. |
| metrics_pod_selector | string | — | no | 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 | — | no | Name of the container port on those pods that carries the metrics, `metrics`. |
| metrics_path | string | — | no | Path the metrics are served at on that port, `/stats/prometheus`. |
Uses sockets
The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.
No uses sockets declared.
Attachment slots
Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.
No attachment slots declared.
Self-inject allowlist
No self-inject pipes declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
This entity uses nothing in the catalog.
Used by
uses socket «upstream»
uses socket «forward_target»
uses socket «scrape_target»
uses socket «store»
applies to
applies to
applies to
applies to
applies to
applies to
applies to
applies to
applies to
applies to
implements