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
| Fichier | Rôle |
|---|---|
aggregate.yaml | Intention du développeur : un seul composant gateway (core/gateway/contour) qui nomme la classe d’ingress qu’il réconcilie. |
manifest.yaml | Fait correspondre le type de passerelle à la Recipe Helm project-contour (contour). |
release.yaml | Document 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
Deploymentpour le plan de contrôle de Contour et unDaemonSetpour 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_namedu développeur passe dans le chart, qui crée uneIngressClassde 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 familleHTTPProxy). La Recipe laisse la gestion des CRD activée par défaut ; désactivez-la viainfra.overrides.manage_crdslorsque les CRD sont préinstallées. - Point d’entrée du plan de données. Le
ServiceEnvoy est exposé en tant queLoadBalancerpar défaut ; l’opérateur définit le port du service HTTP viainfra.portet peut changer le type de service viainfra.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 :
aggrega scaffold --example contour-gatewayElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd contour-gatewayBuild
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 :
aggrega pull --release release.yamlaggrega build --release release.yamlLes 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
Deploymentqui exécute le plan de contrôle de Contour, - un
DaemonSetqui exécute le plan de données d’Envoy, - les
CustomResourceDefinitions de Contour, - une
IngressClassnomméecontour, - un
ServiceLoadBalancerdevant 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é.