sealed-secrets — controlador do Kubernetes de descriptografia de SealedSecret
Este exemplo compila um stack pequeno e real — o controlador sealed-secrets — a partir de um único Aggregate escrito pelo desenvolvedor para o Kubernetes, apoiado no chart Helm oficial do sealed-secrets servido a partir de um repositório de charts HTTPS.
O sealed-secrets permite que material secreto criptografado seja enviado ao controle de versão com segurança: uma chave pública criptografa um segredo em um recurso personalizado SealedSecret, e um controlador com escopo de cluster que detém a chave privada correspondente o descriptografa de volta em um 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 roteiam, então 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 descriptografa os Secrets do Kubernetes correspondentes. O controlador gera o seu par de chaves de selagem no cluster em tempo de execução, então nenhum material de chave é produzido em tempo de renderização.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um único componente sealed-secrets (core/security/sealed-secrets). |
manifest.yaml | Mapeia o tipo de componente para a Recipe oficial com origem (sealed-secrets). |
release.yaml | Documento do operador para o destino Kubernetes: o dimensionamento de computação do operador. |
O que ele demonstra
- Uma única superfície de autoria. Um único Aggregate é a fonte da 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 registry OCI; o build o resolve e o fixa no
aggrega pull. - Uma CRD incluída no diretório de CRDs do chart. A CustomResourceDefinition
SealedSecretfica no diretório de CRDs nativo do Helm do chart, não nos templates; ela é renderizada na saída com a release incondicionalmente. - Um controlador que estende o cluster, sem aresta de topologia. O sealed-secrets adiciona o seu próprio recurso personalizado à API do cluster; os consumidores solicitam segredos declarando recursos
SealedSecret, então o componente não liga nenhuma arestausese 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. 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 controlador em uma tag de release resolví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
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 sealed-secrets-controllerEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd sealed-secrets-controllerBuild
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 a partir do repositório de charts HTTPS no aggrega pull e o fixa em um arquivo de bloqueio.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use somente as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta do espaço 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`: ela grava o exemplo em uma 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. Diga-me quais arquivos o build gravou; eles ficam em `sealed-secrets-controller/dist/`.O que é renderizado
O build emite o controlador sealed-secrets como um conjunto de objetos do Kubernetes:
- uma
CustomResourceDefinitionpara a API do sealed-secrets (SealedSecret), - um
Deployment— o controlador, - o RBAC que o vincula: um
ClusterRole, umClusterRoleBinding, doisRoles e doisRoleBindings, - uma
ServiceAccount, - dois
Services — o serviço do controlador e o seu serviço de métricas.
A imagem do controlador é fixada na sua tag de release, para que a carga de trabalho referencie uma tag de imagem fixada.