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

sealed-secrets — controlador do Kubernetes de desencriptação de SealedSecret

Este exemplo compila uma stack pequena e real — o controlador sealed-secrets — a partir de um único Aggregate escrito pelo programador para o Kubernetes, assente no chart Helm oficial do sealed-secrets servido a partir de um repositório de charts HTTPS.

O sealed-secrets permite submeter com segurança material secreto encriptado ao controlo de versões: uma chave pública encripta um segredo num recurso personalizado SealedSecret, e um controlador com âmbito de cluster que detém a chave privada correspondente desencripta-o de volta num Secret nativo do Kubernetes. O controlador estende a API do cluster com o seu próprio recurso personalizado SealedSecret em vez de ser um servidor para o qual as aplicações encaminham tráfego, pelo que não recebe nenhuma aresta uses e não exporta nada para os consumidores: as aplicações obtêm os seus segredos declarando recursos SealedSecret, e o controlador desencripta os Secrets do Kubernetes correspondentes. O controlador gera o seu par de chaves de selagem no cluster em tempo de execução, pelo que nenhum material de chave é produzido no momento da renderização.

Ficheiros

FicheiroPapel
aggregate.yamlIntenção do programador: um único componente sealed-secrets (core/security/sealed-secrets).
manifest.yamlMapeia o tipo de componente para a Recipe oficial com origem (sealed-secrets).
release.yamlDocumento do operador para o destino Kubernetes: o dimensionamento de computação do operador.

O que demonstra

  • Uma única superfície de autoria. Um único Aggregate é a fonte de verdade sobre o que o controlador é; o Manifest diz como realizá-lo.
  • Um chart servido por HTTPS. A Recipe obtém o chart de um repositório de charts HTTPS em vez de um registo OCI; a compilação resolve-o e fixa-o no aggrega pull.
  • Uma CRD incluída no diretório de CRD do chart. A CustomResourceDefinition SealedSecret encontra-se no diretório de CRD nativo do Helm do chart, não nos templates; é renderizada no resultado com a release incondicionalmente.
  • Um controlador que estende o cluster, sem aresta de topologia. O sealed-secrets acrescenta o seu próprio recurso personalizado à API do cluster; os consumidores pedem segredos declarando recursos SealedSecret, pelo que o componente não liga nenhuma aresta uses e não exporta nada.
  • Um único controlador coerente. O chart renderiza um único controlador com o seu RBAC e os seus Services, sem nenhum datastore, cache ou broker externo. O resultado renderizado é idêntico byte a byte entre execuções da mesma entrada.
  • Uma imagem reproduzível. A Recipe fixa a imagem do controlador numa tag de release resolúvel (docker.io/bitnami/sealed-secrets-controller:0.38.4), para que a carga de trabalho renderizada referencie 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 sealed-secrets-controller

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

Terminal window
cd sealed-secrets-controller

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 a partir do repositório de charts HTTPS no aggrega pull e fixa-o num ficheiro de bloqueio.

Com um assistente de IA

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

Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa própria. Se a pasta da área de trabalho ainda não contiver uma pasta `sealed-secrets-controller`, chame uma vez a ferramenta `scaffold` com `example` definido como `sealed-secrets-controller` e sem `dir`: esta escreve o exemplo numa nova pasta `sealed-secrets-controller`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `sealed-secrets-controller`, `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 `sealed-secrets-controller/dist/`.

O que é renderizado

A compilação emite o controlador sealed-secrets como um conjunto de objetos do Kubernetes:

  • uma CustomResourceDefinition para a API do sealed-secrets (SealedSecret),
  • um Deployment — o controlador,
  • o RBAC que o vincula: um ClusterRole, um ClusterRoleBinding, dois Roles e dois RoleBindings,
  • uma ServiceAccount,
  • dois Services — o serviço do controlador e o seu serviço de métricas.

A imagem do controlador está fixada na sua tag de release, pelo que a carga de trabalho referencia uma tag de imagem fixada.