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.
Herkunft
- Inhalts-Digest
- sha256:7b87e1e7e3959e2adbd4e6bd68d838658897e0d7781a21b827cb8f4db9a0f776
- Veröffentlicht
- 2026-11-10T10:11:44Z
- Signaturidentität
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signatur
- Offiziellapplication/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
Referenz zu dieser Version
oci://hub.aggrega.ai/component/core/gateway/contour:1.0.0Entwicklerparameter
Werte, die der Entwickler im Aggregate festlegt.
| Name | Typ | Standardwert | Erforderlich | Beschreibung |
|---|---|---|---|---|
| ingress_class_name | string | contour | nein | Name of the IngressClass this controller reconciles. Applications route to the gateway by referencing this class in their Ingress or HTTPProxy resources. |
Dimensionierung durch den Operator
Infrastrukturdimensionierung, die der Operator pro Umgebung anpasst.
| Name | Typ | Standardwert | Erforderlich | Beschreibung |
|---|---|---|---|---|
| port | integer (min 1, max 65535) | 80 | nein | 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 | — | nein | Source artifact version (Helm chart). Overrides the Recipe's default source version. Changing from default does not guarantee value mapping compatibility. |
| compute | object | — | nein | — |
| overrides | object (open) | — | nein | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Ausgabevertrag
Werte, die diese Komponente über die uses-Topologie an Konsumenten veröffentlicht.
| Name | Typ | Standardwert | Erforderlich | Beschreibung |
|---|---|---|---|---|
| host | string | — | ja | 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 | — | ja | 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 | — | nein | How the published address is spoken to — `http`, so a consumer composes an address on that scheme. |
| metrics_pod_selector | string | — | nein | 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 | — | nein | Name of the container port on those pods that carries the metrics, `metrics`. |
| metrics_path | string | — | nein | Path the metrics are served at on that port, `/stats/prometheus`. |
uses-Sockets
Die Abhängigkeits-Sockets, über die sich diese Komponente verbindet. Das Ziel jeder über einen Socket verdrahteten Verbindung muss dessen Label-Selektor erfüllen, und jede Verbindung kann in den Slots, die der Socket deklariert, eine Anbindung tragen. Einen erforderlichen Slot muss jede Verbindung füllen, die das Aggregate oder das Release über den Socket verdrahtet.
Keine uses-Sockets deklariert.
Anbindungs-Slots
Benannte Bindungspunkte, an denen ein Feature an diese Komponente angebunden wird. Der Selektor eines Slots schränkt ein, welches Feature ihn füllen darf, und seine inject-Liste benennt, wie das Feature sein Material liefern darf. Ein erforderlicher Slot muss auf jeder Instanz gebunden sein, durch eine Anbindung an der Instanz oder in einem darüberliegenden Geltungsbereich, und ein sensibler Slot ist für den Umgang mit geheimem Material deklariert. Ein Feature kann auch unter einem Namen angebunden werden, den kein Slot deklariert.
Keine Anbindungs-Slots deklariert.
Zulassungsliste für Selbstinjektion
Keine Selbstinjektions-Pipes deklariert.
Beziehungen
Typisierte Kanten zu und von anderen veröffentlichten Entitäten. Eine Referenz ohne veröffentlichtes Ziel wird als unterbrochene Kante statt als Link dargestellt.
Verwendet
Diese Entität verwendet nichts aus dem Katalog.
Verwendet von
verwendet Socket «upstream»
verwendet Socket «forward_target»
verwendet Socket «scrape_target»
verwendet Socket «store»
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
implementiert