Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

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

DateiRolle
aggregate.yamlEntwicklerabsicht: eine einzelne Komponente cert-manager (core/security/cert-manager) mit aktivierter CRD-Installation.
manifest.yamlBildet den Komponententyp auf das cert-manager-Helm-Recipe ab (cert-manager).
release.yamlDokument 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 Deployment für den Controller, der Zertifikatsanforderungen abgleicht, ein Deployment für den Webhook, der die benutzerdefinierten Ressourcen validiert und mit Standardwerten versieht, und ein Deployment für den CA-Injector, der das CA-Bundle des Webhooks in den Cluster einspeist.
  • Installation der Zertifikats-API. Der Wert install_crds des Entwicklers fließt in das Chart, das die CustomResourceDefinitions von cert-manager installiert (die Ressourcen Certificate, Issuer, ClusterIssuer und ACME Order/Challenge). Setzen Sie ihn auf false, wenn die CRDs anderweitig verwaltet werden.
  • Admission-Verdrahtung. Das Chart gibt die ValidatingWebhookConfiguration und die MutatingWebhookConfiguration aus, die der Webhook bedient, den Service des Webhooks und den vollständigen RBAC-Satz — eine ClusterRole/ClusterRoleBinding pro Controller-Zuständigkeit plus die Roles 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:

Terminal window
aggrega scaffold --example cert-manager-tls

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd cert-manager-tls

Build

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:

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

Gerenderte 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.