Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Passerelle Contour — un contrôleur d’ingress natif de Kubernetes

Cet exemple compile une petite stack réelle — une passerelle d’ingress Contour — à partir d’un seul Aggregate écrit par le développeur, vers Kubernetes. Le développeur déclare ce qu’est la passerelle ; une seule Recipe Ops fait correspondre cette intention au chart Helm officiel project-contour (servi depuis le dépôt de charts HTTPS du projet) et rend les objets Kubernetes.

Contour est un contrôleur d’ingress natif de Kubernetes. Son plan de contrôle surveille les ressources Ingress et HTTPProxy du cluster et programme un plan de données Envoy, qui termine le trafic HTTP et HTTPS des clients et le répartit entre les services sous-jacents que nomment ces ressources. Son entrée de routage, ce sont les propres objets Ingress du cluster — et non un upstream câblé — si bien que la passerelle ne prend aucune arête uses. Les applications l’atteignent en déclarant des ressources Ingress pour sa classe d’ingress. Pour la même raison, elle n’a pas de forme autonome en conteneur local, si bien que cette famille ne livre qu’une Recipe Helm ; il n’y a pas de cible Compose.

Fichiers

FichierRôle
aggregate.yamlIntention du développeur : un seul composant gateway (core/gateway/contour) qui nomme la classe d’ingress qu’il réconcilie.
manifest.yamlFait correspondre le type de passerelle à la Recipe Helm project-contour (contour).
release.yamlDocument de l’opérateur pour la cible Kubernetes : le port du service Envoy et le dimensionnement du plan de contrôle et du plan de données.

Ce qu’il démontre

  • Une seule surface de rédaction, réalisée par une Recipe Ops. L’Aggregate est la source de vérité pour ce qu’est la passerelle. Le Manifest dit comment la réaliser en faisant correspondre le type de passerelle à une Recipe par son nom ; la Release fournit le dimensionnement opérationnel. L’intention du développeur et la correspondance Ops restent séparées.
  • Plan de contrôle et plan de données à partir d’un seul composant. La Recipe rend les deux moitiés du contrôleur d’ingress : un Deployment pour le plan de contrôle de Contour et un DaemonSet pour le plan de données d’Envoy, reliés entre eux par le chart.
  • Propriété de la classe d’ingress. La valeur ingress_class_name du développeur passe dans le chart, qui crée une IngressClass de ce nom. Les applications routent vers la passerelle en référençant cette classe dans leurs ressources Ingress.
  • Gestion des CRD. Contour installe et gère ses propres CustomResourceDefinitions (sa famille HTTPProxy). La Recipe laisse la gestion des CRD activée par défaut ; désactivez-la via infra.overrides.manage_crds lorsque les CRD sont préinstallées.
  • Point d’entrée du plan de données. Le Service Envoy est exposé en tant que LoadBalancer par défaut ; l’opérateur définit le port du service HTTP via infra.port et peut changer le type de service via infra.overrides.service_type.
  • Images reproductibles. La Recipe épingle à nouveau les images de Contour et d’Envoy sur des tags de release explicites, si bien que les charges de travail rendues référencent des versions épinglées.

Générer l’exemple

Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.

Écrivez l’exemple dans un nouveau dossier qui porte son nom :

Terminal window
aggrega scaffold --example contour-gateway

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd contour-gateway

Build

Cet espace de travail ne contient aucun .aggrega-config.yaml, si bien que les entités de la bibliothèque standard se résolvent depuis le registre du hub, hub.aggrega.ai, et qu’aucun flag de catalogue n’est nécessaire :

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Les artefacts rendus arrivent sous dist/. Le build résout le chart upstream lors de aggrega pull et l’épingle dans un lockfile.

Avec un assistant IA

Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.

Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `contour-gateway`, appelez une fois l’outil `scaffold` avec `example` défini sur `contour-gateway` et sans `dir` : il écrit l’exemple dans un nouveau dossier `contour-gateway`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `contour-gateway`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi les fichiers écrits par le build ; ils se trouvent sous `contour-gateway/dist/`.

Ce qui est rendu

Le build émet la stack complète du contrôleur d’ingress :

  • un Deployment qui exécute le plan de contrôle de Contour,
  • un DaemonSet qui exécute le plan de données d’Envoy,
  • les CustomResourceDefinitions de Contour,
  • une IngressClass nommée contour,
  • un Service LoadBalancer devant Envoy sur le port HTTP 80 et le port HTTPS 443,

ainsi que la ConfigMap de support, le Job de génération de certificats, le Service du plan de contrôle, la NetworkPolicy, le RBAC et le ServiceAccount. Les images de Contour et d’Envoy sont épinglées sur leurs tags de release, si bien que chaque charge de travail référence un tag d’image épinglé.