OpenBao — Server für die Verwaltung von Secrets auf Kubernetes
Dieses Beispiel kompiliert einen kleinen, realen Stack — einen einzelnen OpenBao-Secrets-Server — aus einem einzigen vom Entwickler verfassten Aggregate für Kubernetes, gestützt auf das offizielle OpenBao-Helm-Chart.
OpenBao speichert, erzeugt und kontrolliert den Zugriff auf Tokens, Passwörter, Zertifikate und andere Secrets hinter einer authentifizierten HTTP-API und verschlüsselt seinen Zustand im Ruhezustand auf einem dauerhaften Daten-Volume. Es läuft hier als einzelner eigenständiger Server, der seinen Zustand im eingebauten Dateispeicher-Backend hält, und wird daher als zustandsbehafteter laufender Server mit einem persistenten Volume gerendert statt als verwaltete Cloud-Ressource. Der Server wird zur Laufzeit innerhalb des Clusters initialisiert und entsiegelt — sein Root-Token und seine Unseal-Schlüssel erzeugt der laufende Server nach seinem Start —, daher werden im Aggregate keine Zugangsdaten deklariert und zur Build-Zeit wird kein Secret materialisiert.
Dateien
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine einzelne Komponente secrets (core/security/openbao) mit eingeschalteter eingebauter Web-UI. |
manifest.yaml | Bildet den Komponententyp auf das offizielle Sourced-Recipe (openbao) ab. |
release.yaml | Dokument des Operators für das Kubernetes-Ziel: die Rechen-Dimensionierung des Servers und die Größe des Daten-Volumes. |
Was es zeigt
- Eine Authoring-Oberfläche. Ein einziges Aggregate ist die maßgebliche Quelle dafür, was der Secrets-Server ist; das Manifest sagt, wie er zu realisieren ist.
- Ein Entwicklerwert fließt bis in das Rendering. Der Wert
ui_enableddes Entwicklers wird in die Serverkonfiguration geschrieben, die das Chart einbindet, und schaltet die eingebaute Web-UI ein oder aus. - Ein zustandsbehafteter Server auf einem persistenten Volume. Das Sourced-Recipe konfiguriert den Standalone-Modus mit dem Dateispeicher-Backend, sodass der Server seinen verschlüsselten Zustand auf einem
PersistentVolumeClaimhält, der unter/openbao/dataeingebunden und überstorage.sizedes Operators dimensioniert ist. - Keine Zugangsdaten zur Render-Zeit. OpenBao initialisiert und entsiegelt sich zur Laufzeit selbst, daher verdrahtet der Build keine Zugangsdaten und gibt kein
Secretaus. Die gerenderte Ausgabe ist über Läufe mit derselben Eingabe hinweg byteidentisch. - Ein reproduzierbares Image. Das Recipe fixiert das Server-Image auf einen auflösbaren Release-Tag (
quay.io/openbao/openbao:2.5.5), 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:
aggrega scaffold --example openbao-secretsDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd openbao-secretsBuild
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 Workspace-Ordner noch keinen Ordner `openbao-secrets` enthält, rufen Sie das Tool `scaffold` einmal auf, mit `example` auf `openbao-secrets` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `openbao-secrets`. Rufen Sie dann das Tool `build` auf, mit `workspace_root` auf `openbao-secrets`, `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 `openbao-secrets/dist/`.Was gerendert wird
Der Build gibt den schlanken OpenBao-Stack mit einer einzigen Arbeitslast als sieben Kubernetes-Objekte aus:
- ein
StatefulSetfür den OpenBao-Server, - eine
ConfigMapmit der Serverkonfiguration (dem Dateispeicher-Backend und dem API-Listener), - zwei
Services — den Haupt-API-Service und den internen Headless-Service, den das StatefulSet für ein stabiles Pod-Networking nutzt, - ein
ServiceAccountfür den Server-Pod, - ein
ClusterRoleBinding, das dem Server die Token-Review-Berechtigung erteilt, mit der er Kubernetes-Service-Accounts authentifiziert, - einen
helm.sh/hook: test-Pod, der die Bereitschaft des Servers prüft.
Es gibt keine CustomResourceDefinitions — OpenBao ist ein in sich geschlossener Server, kein Controller, der die Cluster-API erweitert. Das Server-Image ist auf seinen Release-Tag fixiert, sodass die Arbeitslast einen fixierten Image-Tag referenziert.