OpenBao — serveur de gestion des secrets sur Kubernetes
Cet exemple compile une petite stack réelle — un seul serveur de secrets OpenBao — à partir d’un seul Aggregate écrit par le développeur vers Kubernetes, adossé au chart Helm officiel d’OpenBao.
OpenBao stocke et génère des jetons, des mots de passe, des certificats et d’autres secrets, et en contrôle l’accès derrière une API HTTP authentifiée, et chiffre son état au repos sur un volume de données durable. Il s’exécute ici comme un seul serveur autonome qui conserve son état dans le backend de stockage sur fichier intégré, si bien qu’il est rendu comme un serveur avec état en cours d’exécution, adossé à un volume persistant, plutôt que comme une ressource cloud managée. Le serveur est initialisé et descellé à l’exécution dans le cluster — son jeton root et ses clés de descellement sont produits par le serveur en cours d’exécution après son démarrage — si bien qu’aucune information d’identification n’est déclarée dans l’Aggregate et qu’aucun secret n’est matérialisé au moment du build.
Fichiers
| Fichier | Rôle |
|---|---|
aggregate.yaml | Intention du développeur : un seul composant secrets (core/security/openbao) avec l’interface web intégrée activée. |
manifest.yaml | Associe le type du composant à la Recipe sourced officielle (openbao). |
release.yaml | Document de l’opérateur pour la cible Kubernetes : le dimensionnement de calcul du serveur et la taille du volume de données. |
Ce qu’il démontre
- Une seule surface de rédaction. Un seul Aggregate est la source de vérité sur ce qu’est le serveur de secrets ; le Manifest dit comment le réaliser.
- Une valeur du développeur va jusqu’au rendu. La valeur
ui_enableddu développeur est écrite dans la configuration du serveur que le chart monte, et active ou désactive l’interface web intégrée. - Un serveur avec état sur un volume persistant. La Recipe sourced configure le mode autonome avec le backend de stockage sur fichier, si bien que le serveur conserve son état chiffré sur un
PersistentVolumeClaimmonté sur/openbao/data, dimensionné par lestorage.sizede l’opérateur. - Aucune information d’identification au moment du rendu. OpenBao s’initialise et se descelle lui-même à l’exécution, si bien que le build ne câble aucune information d’identification et n’émet aucun
Secret. La sortie rendue est identique octet par octet d’une exécution à l’autre de la même entrée. - Une image reproductible. La Recipe épingle l’image du serveur à un tag de version résolvable (
quay.io/openbao/openbao:2.5.5), si bien que la charge de travail rendue référence une version épinglée.
Générer l’exemple
Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.
Écrivez l’exemple dans un nouveau dossier qui porte son nom :
aggrega scaffold --example openbao-secretsElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd openbao-secretsBuild
Cet espace de travail ne contient aucun .aggrega-config.yaml, si bien que les entités de la bibliothèque standard se résolvent depuis le registre du hub, hub.aggrega.ai, et qu’aucun flag de catalogue n’est nécessaire :
aggrega pull --release release.yamlaggrega build --release release.yamlLes artefacts rendus se trouvent sous dist/. Le build résout le chart upstream par référence OCI lors de aggrega pull et l’épingle dans un lockfile.
Avec un assistant IA
Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.
Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier Workspace ne contient pas encore de dossier `openbao-secrets`, appelez une fois l’outil `scaffold` avec `example` défini sur `openbao-secrets` et sans `dir` : il écrit l’exemple dans un nouveau dossier `openbao-secrets`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `openbao-secrets`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `openbao-secrets/dist/`.Ce qui est rendu
Le build émet la stack OpenBao minimale à charge de travail unique sous forme de sept objets Kubernetes :
- un
StatefulSetpour le serveur OpenBao, - une
ConfigMapportant la configuration du serveur (le backend de stockage sur fichier et l’écouteur de l’API), - deux
Service— le service principal de l’API et le service headless interne que le StatefulSet utilise pour un réseau de pods stable, - un
ServiceAccountpour le pod du serveur, - un
ClusterRoleBindingaccordant au serveur la permission de token review qu’il utilise pour authentifier les comptes de service Kubernetes, - un
Podhelm.sh/hook: testqui vérifie que le serveur est prêt.
Il n’y a aucune CustomResourceDefinition — OpenBao est un serveur autonome, et non un contrôleur qui étend l’API du cluster. L’image du serveur est épinglée à son tag de version, si bien que la charge de travail référence un tag d’image épinglé.