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

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

DateiRolle
aggregate.yamlEntwicklerabsicht: eine einzelne Komponente secrets (core/security/openbao) mit eingeschalteter eingebauter Web-UI.
manifest.yamlBildet den Komponententyp auf das offizielle Sourced-Recipe (openbao) ab.
release.yamlDokument 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_enabled des 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 PersistentVolumeClaim hält, der unter /openbao/data eingebunden und über storage.size des 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 Secret aus. 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:

Terminal window
aggrega scaffold --example openbao-secrets

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

Terminal window
cd openbao-secrets

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 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 StatefulSet für den OpenBao-Server,
  • eine ConfigMap mit 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 ServiceAccount fü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.