Diese Seite wurde maschinell übersetzt. Englisches Original lesen.

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

OffiziellSigniert von einer Signaturidentität, die dieser Katalog als offiziellen Herausgeber anerkennt.
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.0

Entwicklerparameter

Werte, die der Entwickler im Aggregate festlegt.

NameTypStandardwertErforderlichBeschreibung
ingress_class_namestringcontourneinName 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.

NameTypStandardwertErforderlichBeschreibung
portinteger (min 1, max 65535)80neinHTTP port the Envoy data-plane service listens on. Most operators should omit this and let the Recipe assign the default (80).
source_versionstring—neinSource artifact version (Helm chart). Overrides the Recipe's default source version. Changing from default does not guarantee value mapping compatibility.
computeobject—nein—
overridesobject (open)—neinProvider-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.

NameTypStandardwertErforderlichBeschreibung
hoststring—jaIn-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.
portinteger—jaTCP 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.
protocolstring—neinHow the published address is spoken to — `http`, so a consumer composes an address on that scheme.
metrics_pod_selectorstring—neinKubernetes 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_portstring—neinName of the container port on those pods that carries the metrics, `metrics`.
metrics_pathstring—neinPath 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

Konzeptreferenz zu Component →

Der Aggrega-Katalog — ein offener Index von Komponenten, Funktionen, Rezepten und den Plugins, die sie rendern.

Erstellt mit dem gemeinsamen Aggrega-Designsystem.

Datenschutz