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
| Fichier | Rôle |
|---|---|
aggregate.yaml | Intention du développeur : un seul composant cert-manager (core/security/cert-manager) avec l’installation des CRD activée. |
manifest.yaml | Mappe le type de composant vers la Recipe Helm de cert-manager (cert-manager). |
release.yaml | Document 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
Deploymentpour le contrôleur qui réconcilie les demandes de certificat, unDeploymentpour le webhook qui valide les ressources personnalisées et leur attribue des valeurs par défaut, et unDeploymentpour 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_crdsdu développeur est transmise au chart, qui installe lesCustomResourceDefinitions de cert-manager (les ressourcesCertificate,Issuer,ClusterIssueret ACMEOrder/Challenge). Mettez-la à false lorsque les CRD sont gérées hors bande. - Câblage de l’admission. Le chart émet la
ValidatingWebhookConfigurationet laMutatingWebhookConfigurationque sert le webhook, leServicedu webhook et l’ensemble RBAC complet — unClusterRole/ClusterRoleBindingpar responsabilité du contrôleur plus lesRoles 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 :
aggrega scaffold --example cert-manager-tlsElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd cert-manager-tlsBuild
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 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é.