Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

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

ArchivoRol
aggregate.yamlIntención del desarrollador: un único componente secrets (core/security/openbao) con la interfaz web integrada activada.
manifest.yamlAsigna el tipo del componente a la Recipe sourced oficial (openbao).
release.yamlDocumento 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_enabled del 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 PersistentVolumeClaim montado en /openbao/data, dimensionado por el storage.size del 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:

Terminal window
aggrega scaffold --example openbao-secrets

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd openbao-secrets

Compilació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:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Los 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 StatefulSet para el servidor OpenBao,
  • un ConfigMap que 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 ServiceAccount para el pod del servidor,
  • un ClusterRoleBinding que concede al servidor el permiso de token review que usa para autenticar las cuentas de servicio de Kubernetes,
  • un Pod helm.sh/hook: test que 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.