external-secrets — Kubernetes-Operator zur Synchronisierung von Secrets
Dieses Beispiel kompiliert einen kleinen, realen Stack — den external-secrets-Operator — aus einem einzigen vom Entwickler verfassten Aggregate für Kubernetes, gestützt auf das offizielle external-secrets-Helm-Chart.
external-secrets synchronisiert geheimes Material aus externen Systemen zur Verwaltung von Secrets — HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key Vault und anderen — in native Kubernetes-Secrets und hält sie synchron, wenn sich die Quelle ändert. Es ist ein clusterweiter Controller, der die Cluster-API um eigene benutzerdefinierte Ressourcen erweitert, statt eines Servers, zu dem Anwendungen routen, daher nimmt es keine Kante uses, und alles, was es veröffentlicht, ist, wo ein Prometheus-Server seine Metriken findet: Anwendungen beziehen ihre Secrets, indem sie Ressourcen ExternalSecret und SecretStore deklarieren, und der Operator materialisiert die entsprechenden Secrets von Kubernetes.
Dateien
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine einzelne Komponente external-secrets (core/security/external-secrets), die die Definitionen der benutzerdefinierten Ressourcen mit dem Release installiert. |
manifest.yaml | Bildet den Komponententyp auf das offizielle Recipe mit Quelle ab (external-secrets). |
release.yaml | Dokument des Operators für das Kubernetes-Ziel: die Dimensionierung der Rechenressourcen des Operators. |
Was es zeigt
- Eine Authoring-Oberfläche. Ein einziges Aggregate ist die maßgebliche Quelle dafür, was der Operator ist; das Manifest sagt, wie er zu realisieren ist.
- Ein Entwicklerwert fließt bis in das Rendering. Der Wert
install_crdsdes Entwicklers wird in den WertinstallCRDsdes Charts geschrieben und bringt die Definitionen der benutzerdefinierten Ressourcen von external-secrets mit dem Release in den Cluster. - Ein clustererweiternder Controller, keine Topologiekante. external-secrets fügt der Cluster-API eigene benutzerdefinierte Ressourcen hinzu; Konsumenten fordern Secrets an, indem sie diese Ressourcen deklarieren, daher verdrahtet die Komponente keine Kante
usesund exportiert nichts außer dem Ort ihrer Metriken. - Ein einziger kohärenter Operator. Das Chart rendert den Controller, den Webhook und den Zertifikatscontroller als einen Operator; das mitgelieferte Provider-Subchart ist deaktiviert, daher wird kein fremder Datenspeicher, Cache oder Broker hinzugezogen. Die gerenderte Ausgabe ist über Läufe mit derselben Eingabe hinweg byteidentisch.
- Ein reproduzierbares Image. Das Recipe fixiert alle drei Container-Images auf einen auflösbaren Release-Tag (
ghcr.io/external-secrets/external-secrets:v2.7.0), sodass die gerenderten Arbeitslasten eine fixierte Version 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 external-secrets-operatorDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd external-secrets-operatorBuild
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 ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Arbeitsbereichsordner noch keinen Ordner `external-secrets-operator` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `external-secrets-operator` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `external-secrets-operator`. Rufen Sie dann das Tool `build` mit `workspace_root` auf `external-secrets-operator`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt auf. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `external-secrets-operator/dist/`.Was gerendert wird
Der Build gibt den external-secrets-Operator als eine Menge von Kubernetes-Objekten aus:
- 24
CustomResourceDefinitions für die external-secrets-API (ExternalSecret,SecretStore,ClusterSecretStoreund die zugehörigen Push- und Generator-Ressourcen), - drei
Deployments — der Controller, der Webhook und der Zertifikatscontroller, - das RBAC, das sie bindet:
ClusterRoles,ClusterRoleBindings, eineRoleund einRoleBinding, - drei
ServiceAccounts, eines pro Arbeitslast, - ein
Servicefür den Webhook, - zwei
ValidatingWebhookConfigurations, - ein
Secretals Platzhalter, das der Zertifikatscontroller zur Laufzeit mit dem Serving-Zertifikat des Webhooks befüllt.
Alle drei Container-Images sind auf ihren Release-Tag fixiert, sodass die Arbeitslasten fixierte Images referenzieren.