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

cert-manager — contrôleur du cycle de vie des certificats TLS de Kubernetes

Cet exemple compile une petite stack réelle — un contrôleur de certificats cert-manager — à partir d’un seul Aggregate écrit par le développeur vers Kubernetes. Le développeur déclare ce qu’est cert-manager ; une seule Recipe Ops mappe cette intention vers le chart Helm officiel de cert-manager depuis le registre jetstack et rend les objets Kubernetes.

cert-manager est un module complémentaire Kubernetes à l’échelle du cluster qui automatise l’émission et le renouvellement de certificats X.509 à partir de sources émettrices telles qu’ACME (Let’s Encrypt), une CA privée ou Vault. Il étend le cluster avec ses propres ressources personnalisées Certificate, Issuer et ClusterIssuer. Les applications demandent des certificats en déclarant ces ressources — et non en câblant un upstream — si bien que le composant ne prend aucune arête uses. Pour la même raison, il n’a pas de forme autonome en conteneur local, si bien que cette famille ne fournit qu’une Recipe Helm ; il n’y a pas de cible Compose. Tout ce que publie le composant, c’est l’endroit où un serveur Prometheus trouve ses métriques.

Fichiers

FichierRôle
aggregate.yamlIntention du développeur : un seul composant cert-manager (core/security/cert-manager) avec l’installation des CRD activée.
manifest.yamlMappe le type de composant vers la Recipe Helm de cert-manager (cert-manager).
release.yamlDocument de l’opérateur pour la cible Kubernetes : le dimensionnement contrôleur/webhook/injecteur de CA.

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é sur ce qu’est cert-manager. Le Manifest dit comment le réaliser en mappant le type de composant vers une Recipe par son nom ; la Release fournit le dimensionnement opérationnel. L’intention du développeur et le mappage Ops restent séparés.
  • Trois charges de travail coordonnées à partir d’un seul composant. La Recipe rend les trois parties de cert-manager : un Deployment pour le contrôleur qui réconcilie les demandes de certificat, un Deployment pour le webhook qui valide les ressources personnalisées et leur attribue des valeurs par défaut, et un Deployment pour l’injecteur de CA qui câble le bundle de CA du webhook dans le cluster.
  • Installation de l’API des certificats. La valeur install_crds du développeur est transmise au chart, qui installe les CustomResourceDefinitions de cert-manager (les ressources Certificate, Issuer, ClusterIssuer et ACME Order/Challenge). Mettez-la à false lorsque les CRD sont gérées hors bande.
  • Câblage de l’admission. Le chart émet la ValidatingWebhookConfiguration et la MutatingWebhookConfiguration que sert le webhook, le Service du webhook et l’ensemble RBAC complet — un ClusterRole/ClusterRoleBinding par responsabilité du contrôleur plus les Roles d’élection du leader — si bien que le contrôleur dispose des permissions dont il a besoin.
  • Images reproductibles. Le chart fournit des tags de release résolvables ; la Recipe épingle de nouveau les images du contrôleur, du webhook, de l’injecteur de CA et du solveur ACME sur ces tags, 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 cert-manager-tls

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

Terminal window
cd cert-manager-tls

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 se trouvent sous dist/. Le build résout le chart upstream par référence OCI 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 `cert-manager-tls`, appelez une seule fois l’outil `scaffold` avec `example` défini sur `cert-manager-tls` et sans `dir` : il écrit l’exemple dans un nouveau dossier `cert-manager-tls`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `cert-manager-tls`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `cert-manager-tls/dist/`.

Ce qui est rendu

Le build émet toute la stack cert-manager — trois Deployments (le contrôleur, le webhook et l’injecteur de CA), les six CustomResourceDefinitions de cert-manager lorsque install_crds est activé, une ValidatingWebhookConfiguration et une MutatingWebhookConfiguration, le Service du webhook, les ServiceAccounts du contrôleur, et l’ensemble RBAC de ClusterRoles, de ClusterRoleBindings, et de Roles et RoleBindings d’élection du leader. Il inclut aussi un Job post-installation (la vérification de l’API au démarrage, qui bloque jusqu’à ce que l’API des certificats soit en service) et un Service de métriques pour le contrôleur et un autre pour l’injecteur de CA — 50 objets Kubernetes en tout. Les images du contrôleur, du webhook, de l’injecteur de CA et du solveur ACME sont épinglées sur leurs tags de release, si bien que chaque charge de travail référence un tag d’image épinglé.