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

sealed-secrets — Kubernetes-Controller zur Entschlüsselung von SealedSecret-Ressourcen

Dieses Beispiel kompiliert einen kleinen, realen Stack — den sealed-secrets-Controller — aus einem einzigen vom Entwickler verfassten Aggregate für Kubernetes, gestützt auf das offizielle sealed-secrets-Helm-Chart, ausgeliefert aus einem HTTPS-Chart-Repository.

sealed-secrets ermöglicht es, verschlüsseltes geheimes Material sicher in die Versionsverwaltung zu committen: Ein öffentlicher Schlüssel verschlüsselt ein Secret in eine benutzerdefinierte Ressource SealedSecret, und ein clusterweiter Controller, der den passenden privaten Schlüssel besitzt, entschlüsselt sie zurück in ein natives Secret von Kubernetes. Der Controller erweitert die Cluster-API um seine eigene benutzerdefinierte Ressource SealedSecret, statt ein Server zu sein, zu dem Anwendungen routen, daher nimmt er keine Kante uses und exportiert nichts an Konsumenten: Anwendungen beziehen ihre Secrets, indem sie Ressourcen SealedSecret deklarieren, und der Controller entsiegelt die entsprechenden Secrets von Kubernetes. Der Controller erzeugt sein Versiegelungs-Schlüsselpaar zur Laufzeit im Cluster, daher wird zur Renderzeit kein Schlüsselmaterial erzeugt.

Dateien

DateiRolle
aggregate.yamlEntwicklerabsicht: eine einzelne Komponente sealed-secrets (core/security/sealed-secrets).
manifest.yamlBildet den Komponententyp auf das offizielle Recipe mit Quelle ab (sealed-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 Controller ist; das Manifest sagt, wie er zu realisieren ist.
  • Ein über HTTPS ausgeliefertes Chart. Das Recipe bezieht das Chart aus einem HTTPS-Chart-Repository statt aus einer OCI-Registry; der Build löst es bei aggrega pull auf und fixiert es.
  • Eine CRD, die im CRD-Verzeichnis des Charts mitgeliefert wird. Die CustomResourceDefinition SealedSecret liegt im Helm-nativen CRD-Verzeichnis des Charts, nicht in den Vorlagen; sie wird bedingungslos mit dem Release in die Ausgabe gerendert.
  • Ein clustererweiternder Controller, keine Topologiekante. sealed-secrets fügt der Cluster-API seine eigene benutzerdefinierte Ressource hinzu; Konsumenten fordern Secrets an, indem sie Ressourcen SealedSecret deklarieren, daher verdrahtet die Komponente keine Kante uses und exportiert nichts.
  • Ein einziger kohärenter Controller. Das Chart rendert einen Controller mit seinem RBAC und seinen Services, ohne fremden Datenspeicher, Cache oder Broker. Die gerenderte Ausgabe ist über Läufe mit derselben Eingabe hinweg byteidentisch.
  • Ein reproduzierbares Image. Das Recipe fixiert das Controller-Image auf einen auflösbaren Release-Tag (docker.io/bitnami/sealed-secrets-controller:0.38.4), sodass die gerenderte Arbeitslast eine fixierte Version referenziert.

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 sealed-secrets-controller

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

Terminal window
cd sealed-secrets-controller

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 bei aggrega pull aus dem HTTPS-Chart-Repository auf und fixiert es in einer 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-Werkzeuge und legen Sie selbst keinen Ordner an. Wenn der Ordner des Arbeitsbereichs noch keinen Ordner `sealed-secrets-controller` enthält, rufen Sie das Werkzeug `scaffold` einmal auf, mit `example` auf `sealed-secrets-controller` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `sealed-secrets-controller`. Rufen Sie dann das Werkzeug `build` auf, mit `workspace_root` auf `sealed-secrets-controller`, `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 `sealed-secrets-controller/dist/`.

Was gerendert wird

Der Build gibt den sealed-secrets-Controller als eine Menge von Kubernetes-Objekten aus:

  • eine CustomResourceDefinition für die sealed-secrets-API (SealedSecret),
  • ein Deployment — der Controller,
  • das RBAC, das ihn bindet: eine ClusterRole, ein ClusterRoleBinding, zwei Roles und zwei RoleBindings,
  • ein ServiceAccount,
  • zwei Services — der Controller-Service und sein Metrik-Service.

Das Controller-Image ist auf seinen Release-Tag fixiert, sodass die Arbeitslast einen fixierten Image-Tag referenziert.