OpenBao — servidor de gerenciamento de segredos no Kubernetes
Este exemplo compila um stack pequeno e real — um único servidor de segredos OpenBao — a partir de um único Aggregate escrito pelo desenvolvedor para o Kubernetes, apoiado no chart Helm oficial do OpenBao.
O OpenBao armazena e gera tokens, senhas, certificados e outros segredos, e controla o acesso a eles por trás de uma API HTTP autenticada, além de criptografar o seu estado em repouso em um volume de dados durável. Aqui ele roda como um único servidor autônomo que mantém o seu estado no backend de armazenamento em arquivo integrado, então é renderizado como um servidor com estado em execução apoiado em um volume persistente, e não como um recurso de nuvem gerenciado. O servidor é inicializado e deslacrado em tempo de execução dentro do cluster — o seu root token e as suas chaves de unseal são produzidos pelo servidor em execução depois que ele inicia — então nenhuma credencial é declarada no Aggregate e nenhum segredo é materializado em tempo de build.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um único componente secrets (core/security/openbao) com a interface web integrada ativada. |
manifest.yaml | Mapeia o tipo do componente para a Recipe sourced oficial (openbao). |
release.yaml | Documento do operador para o destino Kubernetes: o dimensionamento de computação do servidor e o tamanho do volume de dados. |
O que ele demonstra
- Uma única superfície de autoria. Um único Aggregate é a fonte da verdade sobre o que o servidor de segredos é; o Manifest diz como realizá-lo.
- Um valor do desenvolvedor chega até a renderização. O valor
ui_enableddo desenvolvedor é escrito na configuração do servidor que o chart monta, ativando ou desativando a interface web integrada. - Um servidor com estado em um volume persistente. A Recipe sourced configura o modo autônomo com o backend de armazenamento em arquivo, então o servidor mantém o seu estado criptografado em um
PersistentVolumeClaimmontado em/openbao/data, dimensionado pelostorage.sizedo operador. - Nenhuma credencial em tempo de renderização. O OpenBao se inicializa e se deslacra sozinho em tempo de execução, então o build não liga nenhuma credencial e não emite nenhum
Secret. A saída renderizada é idêntica byte a byte entre execuções da mesma entrada. - Uma imagem reproduzível. A Recipe fixa a imagem do servidor em uma tag de versão resolvível (
quay.io/openbao/openbao:2.5.5), então a carga de trabalho renderizada referencia uma versão fixada.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example openbao-secretsEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd openbao-secretsBuild
Este espaço de trabalho não traz nenhum .aggrega-config.yaml, então as entidades da biblioteca padrão são resolvidas a partir do registro do hub, hub.aggrega.ai, e nenhuma flag de catálogo é necessária:
aggrega pull --release release.yamlaggrega build --release release.yamlOs artefatos renderizados ficam em dist/. O build resolve o chart upstream por referência OCI no aggrega pull e o fixa em um lockfile.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta Workspace ainda não contiver uma pasta `openbao-secrets`, chame uma vez a ferramenta `scaffold` com `example` definido como `openbao-secrets` e sem `dir`: ela grava o exemplo em uma nova pasta `openbao-secrets`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `openbao-secrets`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `openbao-secrets/dist/`.O que é renderizado
O build emite o stack enxuto do OpenBao com uma única carga de trabalho como sete objetos do Kubernetes:
- um
StatefulSetpara o servidor OpenBao, - um
ConfigMapque contém a configuração do servidor (o backend de armazenamento em arquivo e o listener da API), - dois
Service— o serviço principal da API e o serviço headless interno que o StatefulSet usa para uma rede de pods estável, - um
ServiceAccountpara o pod do servidor, - um
ClusterRoleBindingque concede ao servidor a permissão de token review que ele usa para autenticar as contas de serviço do Kubernetes, - um
Podhelm.sh/hook: testque verifica se o servidor está pronto.
Não há nenhum CustomResourceDefinition — o OpenBao é um servidor autossuficiente, não um controlador que estende a API do cluster. A imagem do servidor é fixada na sua tag de versão, então a carga de trabalho referencia uma tag de imagem fixada.