cert-manager — Controller für den Lebenszyklus von TLS-Zertifikaten in Kubernetes
Dieses Beispiel kompiliert einen kleinen, realen Stack — einen cert-manager-Zertifikatscontroller — aus einem einzigen vom Entwickler verfassten Aggregate für Kubernetes. Der Entwickler deklariert, was cert-manager ist; ein einziges Ops-Recipe bildet diese Absicht auf das offizielle cert-manager-Helm-Chart aus der jetstack-Registry ab und rendert die Kubernetes-Objekte.
cert-manager ist ein clusterweites Kubernetes-Add-on, das die Ausstellung und Erneuerung von X.509-Zertifikaten aus ausstellenden Quellen wie ACME (Let’s Encrypt), einer privaten CA oder Vault automatisiert. Es erweitert den Cluster um seine eigenen benutzerdefinierten Ressourcen Certificate, Issuer und ClusterIssuer. Anwendungen fordern Zertifikate an, indem sie diese Ressourcen deklarieren — nicht, indem sie einen Upstream verdrahten —, daher nimmt die Komponente keine uses-Kante. Aus demselben Grund hat sie keine eigenständige lokale Container-Form, daher liefert diese Familie nur ein Helm-Recipe mit; es gibt kein Compose-Ziel. Alles, was die Komponente veröffentlicht, ist, wo ein Prometheus-Server ihre Metriken findet.
Dateien
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine einzelne Komponente cert-manager (core/security/cert-manager) mit aktivierter CRD-Installation. |
manifest.yaml | Bildet den Komponententyp auf das cert-manager-Helm-Recipe ab (cert-manager). |
release.yaml | Dokument des Operators für das Kubernetes-Ziel: die Dimensionierung von Controller/Webhook/CA-Injector. |
Was es zeigt
- Eine Authoring-Oberfläche, realisiert durch ein Ops-Recipe. Das Aggregate ist die maßgebliche Quelle dafür, was cert-manager ist. Das Manifest sagt, wie es zu realisieren ist, indem es den Komponententyp per Name auf ein Recipe abbildet; das Release liefert die betriebliche Dimensionierung. Entwicklerabsicht und Ops-Zuordnung bleiben getrennt.
- Drei koordinierte Arbeitslasten aus einer Komponente. Das Recipe rendert alle drei Teile von cert-manager: ein
Deploymentfür den Controller, der Zertifikatsanforderungen abgleicht, einDeploymentfür den Webhook, der die benutzerdefinierten Ressourcen validiert und mit Standardwerten versieht, und einDeploymentfür den CA-Injector, der das CA-Bundle des Webhooks in den Cluster einspeist. - Installation der Zertifikats-API. Der Wert
install_crdsdes Entwicklers fließt in das Chart, das dieCustomResourceDefinitions von cert-manager installiert (die RessourcenCertificate,Issuer,ClusterIssuerund ACMEOrder/Challenge). Setzen Sie ihn auf false, wenn die CRDs anderweitig verwaltet werden. - Admission-Verdrahtung. Das Chart gibt die
ValidatingWebhookConfigurationund dieMutatingWebhookConfigurationaus, die der Webhook bedient, denServicedes Webhooks und den vollständigen RBAC-Satz — eineClusterRole/ClusterRoleBindingpro Controller-Zuständigkeit plus dieRoles für die Leader-Wahl —, sodass der Controller die Berechtigungen hat, die er braucht. - Reproduzierbare Images. Das Chart liefert auflösbare Release-Tags mit; das Recipe fixiert die Images von Controller, Webhook, CA-Injector und ACME-Solver erneut auf diese Tags, sodass die gerenderten Arbeitslasten fixierte Versionen referenzieren.
Das Beispiel generieren
Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.
Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:
aggrega scaffold --example cert-manager-tlsDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd cert-manager-tlsBuild
Dieser Workspace enthält keine .aggrega-config.yaml, daher werden die Entitäten der Standardbibliothek aus der Hub-Registry hub.aggrega.ai aufgelöst, und es ist kein Katalog-Flag nötig:
aggrega pull --release release.yamlaggrega build --release release.yamlGerenderte Artefakte landen unter dist/. Der Build löst das Upstream-Chart per OCI-Referenz bei aggrega pull auf und fixiert es in einem Lockfile.
Mit einem KI-Assistenten
Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.
Verwenden Sie nur die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `cert-manager-tls` enthält, rufen Sie das Tool `scaffold` einmal auf, mit `example` auf `cert-manager-tls` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `cert-manager-tls`. Rufen Sie dann das Tool `build` auf, mit `workspace_root` auf `cert-manager-tls`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `cert-manager-tls/dist/`.Was gerendert wird
Der Build gibt den vollständigen cert-manager-Stack aus — drei Deployments (der Controller, der Webhook und der CA-Injector), die sechs CustomResourceDefinitions von cert-manager, wenn install_crds aktiviert ist, eine ValidatingWebhookConfiguration und eine MutatingWebhookConfiguration, den Service des Webhooks, die ServiceAccounts des Controllers sowie den RBAC-Satz aus ClusterRoles, ClusterRoleBindings und Roles und RoleBindings für die Leader-Wahl. Er enthält außerdem einen Job nach der Installation (die API-Prüfung beim Start, die blockiert, bis die Zertifikats-API bereitsteht) und je einen Service für Metriken für den Controller und den CA-Injector — insgesamt 50 Kubernetes-Objekte. Die Images von Controller, Webhook, CA-Injector und ACME-Solver sind auf ihre Release-Tags fixiert, sodass jede Arbeitslast einen fixierten Image-Tag referenziert.