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
- Empreinte du contenu
- sha256:7b87e1e7e3959e2adbd4e6bd68d838658897e0d7781a21b827cb8f4db9a0f776
- Publié
- 2026-11-10T10:11:44Z
- Identité de signature
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officielapplication/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
Référence à cette version
oci://hub.aggrega.ai/component/core/gateway/contour:1.0.0Paramètres du développeur
Valeurs que le développeur définit dans l’Aggregate.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| ingress_class_name | string | contour | non | Name of the IngressClass this controller reconciles. Applications route to the gateway by referencing this class in their Ingress or HTTPProxy resources. |
Dimensionnement de l’opérateur
Dimensionnement de l’infrastructure que l’opérateur ajuste pour chaque environnement.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| port | integer (min 1, max 65535) | 80 | non | 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 | — | non | Source artifact version (Helm chart). Overrides the Recipe's default source version. Changing from default does not guarantee value mapping compatibility. |
| compute | object | — | non | — |
| overrides | object (open) | — | non | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Contrat de sortie
Valeurs que ce composant publie vers les consommateurs via la topologie uses.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| host | string | — | oui | 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 | — | oui | 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 | — | non | How the published address is spoken to — `http`, so a consumer composes an address on that scheme. |
| metrics_pod_selector | string | — | non | 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 | — | non | Name of the container port on those pods that carries the metrics, `metrics`. |
| metrics_path | string | — | non | Path the metrics are served at on that port, `/stats/prometheus`. |
Sockets uses
Les sockets de dépendance par lesquels ce composant se connecte. La cible de chaque connexion câblée via un socket doit satisfaire son sélecteur d’étiquettes, et chaque connexion peut porter une attache dans les emplacements que le socket déclare. Un emplacement obligatoire doit être rempli par chaque connexion que l’Aggregate ou la Release câble via le socket.
Aucun socket uses déclaré.
Emplacements d’attache
Points de liaison nommés auxquels une Feature s’attache à ce composant. Le sélecteur d’un emplacement restreint la Feature qui peut le remplir, et sa liste inject indique comment le matériel de la Feature peut être livré. Un emplacement obligatoire doit être lié sur chaque instance, par une attache sur l’instance ou à une portée supérieure, et un emplacement sensible est déclaré pour traiter du matériel secret. Une Feature peut aussi s’attacher sous un nom qu’aucun emplacement ne déclare.
Aucun emplacement d’attache déclaré.
Liste d’autorisation d’auto-injection
Aucun canal d’auto-injection déclaré.
Relations
Arêtes typées vers et depuis d’autres entités publiées. Une référence sans cible publiée s’affiche comme une arête rompue plutôt que comme un lien.
Utilise
Cette entité n’utilise rien du catalogue.
Utilisé par
utilise le socket « upstream »
utilise le socket « forward_target »
utilise le socket « scrape_target »
utilise le socket « store »
s’applique à
s’applique à
s’applique à
s’applique à
s’applique à
s’applique à
s’applique à
s’applique à
s’applique à
s’applique à
implémente