Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

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

ArquivoPapel
aggregate.yamlIntenção do desenvolvedor: um único componente secrets (core/security/openbao) com a interface web integrada ativada.
manifest.yamlMapeia o tipo do componente para a Recipe sourced oficial (openbao).
release.yamlDocumento 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_enabled do 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 PersistentVolumeClaim montado em /openbao/data, dimensionado pelo storage.size do 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:

Terminal window
aggrega scaffold --example openbao-secrets

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd openbao-secrets

Build

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:

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

Os 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 StatefulSet para o servidor OpenBao,
  • um ConfigMap que 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 ServiceAccount para o pod do servidor,
  • um ClusterRoleBinding que concede ao servidor a permissão de token review que ele usa para autenticar as contas de serviço do Kubernetes,
  • um Pod helm.sh/hook: test que 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.