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

OpenBao — servidor de gestão de segredos no Kubernetes

Este exemplo compila uma stack pequena e real — um único servidor de segredos OpenBao — a partir de um único Aggregate escrito pelo programador para o Kubernetes, assente no chart Helm oficial do OpenBao.

O OpenBao armazena e gera tokens, palavras-passe, certificados e outros segredos, e controla o acesso a eles por detrás de uma API HTTP autenticada, além de cifrar o seu estado em repouso num volume de dados durável. Aqui é executado como um único servidor autónomo que mantém o seu estado no backend de armazenamento em ficheiro integrado, pelo que é renderizado como um servidor com estado em execução, assente num volume persistente, e não como um recurso de nuvem gerido. O servidor é inicializado e desselado 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 de arrancar — pelo que nenhuma credencial é declarada no Aggregate e nenhum segredo é materializado em tempo de compilação.

Ficheiros

FicheiroPapel
aggregate.yamlIntenção do programador: 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 demonstra

  • Uma única superfície de autoria. Um único Aggregate é a fonte de verdade sobre o que o servidor de segredos é; o Manifest diz como realizá-lo.
  • Um valor do programador chega até à renderização. O valor ui_enabled do programador é escrito na configuração do servidor que o chart monta, ativando ou desativando a interface web integrada.
  • Um servidor com estado num volume persistente. A Recipe sourced configura o modo autónomo com o backend de armazenamento em ficheiro, pelo que o servidor mantém o seu estado cifrado num PersistentVolumeClaim montado em /openbao/data, dimensionado pelo storage.size do operador.
  • Nenhuma credencial em tempo de renderização. O OpenBao inicializa-se e dessela-se sozinho em tempo de execução, pelo que a compilação 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 numa tag de versão resolúvel (quay.io/openbao/openbao:2.5.5), pelo que a carga de trabalho renderizada referencia uma versão fixada.

Gerar o exemplo

É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.

Escreva o exemplo numa nova pasta com o nome dele:

Terminal window
aggrega scaffold --example openbao-secrets

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd openbao-secrets

Compilação

Este espaço de trabalho não inclui nenhum .aggrega-config.yaml, pelo que as entidades da biblioteca standard são resolvidas a partir do registo do hub, hub.aggrega.ai, e não é necessária nenhuma flag de catálogo:

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

Os artefactos renderizados ficam em dist/. A compilação resolve o chart upstream por referência OCI no aggrega pull e fixa-o num lockfile.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.

Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa 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`: esta escreve o exemplo numa 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. Indique-me que ficheiros a compilação escreveu; encontram-se em `openbao-secrets/dist/`.

O que é renderizado

A compilação emite a stack enxuta 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 ficheiro 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 este 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 autónomo, e não um controlador que estende a API do cluster. A imagem do servidor está fixada na sua tag de versão, pelo que a carga de trabalho referencia uma tag de imagem fixada.