OpenBao — servidor de gestión de secretos en Kubernetes
Este ejemplo compila un stack pequeño y real — un único servidor de secretos OpenBao — a partir de un único Aggregate escrito por el desarrollador para Kubernetes, respaldado por el chart de Helm oficial de OpenBao.
OpenBao almacena y genera tokens, contraseñas, certificados y otros secretos, y controla el acceso a ellos detrás de una API HTTP autenticada, y cifra su estado en reposo en un volumen de datos duradero. Aquí se ejecuta como un único servidor independiente que guarda su estado en el backend de almacenamiento en archivos integrado, así que se renderiza como un servidor con estado en ejecución respaldado por un volumen persistente, en lugar de como un recurso de nube gestionado. El servidor se inicializa y se desella en tiempo de ejecución dentro del clúster — su token raíz y sus claves de desellado los produce el servidor en ejecución después de iniciarse — así que no se declara ninguna credencial en el Aggregate y no se materializa ningún secreto en tiempo de compilación.
Archivos
| Archivo | Rol |
|---|---|
aggregate.yaml | Intención del desarrollador: un único componente secrets (core/security/openbao) con la interfaz web integrada activada. |
manifest.yaml | Asigna el tipo del componente a la Recipe sourced oficial (openbao). |
release.yaml | Documento del operador para el destino Kubernetes: el dimensionamiento de cómputo del servidor y el tamaño del volumen de datos. |
Lo que demuestra
- Una única superficie de autoría. Un único Aggregate es la fuente de verdad sobre qué es el servidor de secretos; el Manifest dice cómo realizarlo.
- Un valor del desarrollador llega hasta el renderizado. El valor
ui_enableddel desarrollador se escribe en la configuración del servidor que monta el chart, y activa o desactiva la interfaz web integrada. - Un servidor con estado en un volumen persistente. La Recipe sourced configura el modo independiente con el backend de almacenamiento en archivos, así que el servidor guarda su estado cifrado en un
PersistentVolumeClaimmontado en/openbao/data, dimensionado por elstorage.sizedel operador. - Ninguna credencial en tiempo de renderizado. OpenBao se inicializa y se desella por sí mismo en tiempo de ejecución, así que la compilación no conecta ninguna credencial ni emite ningún
Secret. La salida renderizada es idéntica byte a byte entre ejecuciones de la misma entrada. - Una imagen reproducible. La Recipe fija la imagen del servidor a un tag de versión resoluble (
quay.io/openbao/openbao:2.5.5), así que la carga de trabajo renderizada hace referencia a una versión fijada.
Generar el ejemplo
Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.
Escribe el ejemplo en una carpeta nueva con su nombre:
aggrega scaffold --example openbao-secretsDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd openbao-secretsCompilación
Este espacio de trabajo no contiene ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no hace falta ningún flag de catálogo:
aggrega pull --release release.yamlaggrega build --release release.yamlLos artefactos renderizados quedan bajo dist/. La compilación resuelve el chart upstream por referencia OCI en aggrega pull y lo fija en un lockfile.
Con un asistente de IA
Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.
Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta Workspace aún no contiene una carpeta `openbao-secrets`, llama una vez a la herramienta `scaffold` con `example` establecido en `openbao-secrets` y sin `dir`: escribe el ejemplo en una nueva carpeta `openbao-secrets`. Luego llama a la herramienta `build` con `workspace_root` establecido en `openbao-secrets`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `openbao-secrets/dist/`.Qué se renderiza
La compilación emite el stack mínimo de OpenBao con una sola carga de trabajo como siete objetos de Kubernetes:
- un
StatefulSetpara el servidor OpenBao, - un
ConfigMapque lleva la configuración del servidor (el backend de almacenamiento en archivos y el listener de la API), - dos
Service— el servicio principal de la API y el servicio headless interno que el StatefulSet usa para una red de pods estable, - un
ServiceAccountpara el pod del servidor, - un
ClusterRoleBindingque concede al servidor el permiso de token review que usa para autenticar las cuentas de servicio de Kubernetes, - un
Podhelm.sh/hook: testque comprueba que el servidor esté listo.
No hay ningún CustomResourceDefinition — OpenBao es un servidor autónomo, no un controlador que extiende la API del clúster. La imagen del servidor está fijada a su tag de versión, así que la carga de trabajo hace referencia a un tag de imagen fijado.