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

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

DateiRolle
aggregate.yamlEntwicklerabsicht: eine einzelne Komponente external-secrets (core/security/external-secrets), die die Definitionen der benutzerdefinierten Ressourcen mit dem Release installiert.
manifest.yamlBildet den Komponententyp auf das offizielle Recipe mit Quelle ab (external-secrets).
release.yamlDokument 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_crds des Entwicklers wird in den Wert installCRDs des 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 uses und 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:

Terminal window
aggrega scaffold --example external-secrets-operator

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

Terminal window
cd external-secrets-operator

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 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, ClusterSecretStore und die zugehörigen Push- und Generator-Ressourcen),
  • drei Deployments — der Controller, der Webhook und der Zertifikatscontroller,
  • das RBAC, das sie bindet: ClusterRoles, ClusterRoleBindings, eine Role und ein RoleBinding,
  • drei ServiceAccounts, eines pro Arbeitslast,
  • ein Service für den Webhook,
  • zwei ValidatingWebhookConfigurations,
  • ein Secret als 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.