external-secrets — operador do Kubernetes de sincronização de segredos
Este exemplo compila um stack pequeno e real — o operador external-secrets — a partir de um único Aggregate escrito pelo desenvolvedor para o Kubernetes, apoiado no chart Helm oficial do external-secrets.
O external-secrets sincroniza material secreto de sistemas externos de gerenciamento de segredos — HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key Vault e outros — para Secrets nativos do Kubernetes, mantendo-os sincronizados à medida que a origem muda. É um controlador com escopo de cluster que estende a API do cluster com os seus próprios recursos personalizados, em vez de um servidor para o qual as aplicações roteiam, então não recebe nenhuma aresta uses, e tudo o que publica é onde um servidor Prometheus encontra as suas métricas: as aplicações obtêm os seus segredos declarando recursos ExternalSecret e SecretStore, e o operador materializa os Secrets do Kubernetes correspondentes.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um único componente external-secrets (core/security/external-secrets) que instala as definições de recursos personalizados com a release. |
manifest.yaml | Mapeia o tipo de componente para a Recipe oficial com origem (external-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 operador é; o Manifest diz como realizá-lo.
- Um valor do desenvolvedor flui até a renderização. O valor
install_crdsdo desenvolvedor é escrito no valorinstallCRDsdo chart, levando as definições de recursos personalizados do external-secrets para o cluster com a release. - Um controlador que estende o cluster, sem aresta de topologia. O external-secrets adiciona os seus próprios recursos personalizados à API do cluster; os consumidores solicitam segredos declarando esses recursos, então o componente não liga nenhuma aresta
usese não exporta nada além de onde ficam as suas métricas. - Um único operador coerente. O chart renderiza o controlador, o webhook e o controlador de certificados como um único operador; o subchart de provedor incluído está desativado, então nenhum datastore, cache ou broker externo é incluído. A saída renderizada é idêntica byte a byte entre execuções da mesma entrada.
- Uma imagem reproduzível. A Recipe fixa as três imagens de contêiner em uma tag de release resolvível (
ghcr.io/external-secrets/external-secrets:v2.7.0), para que as cargas de trabalho renderizadas referenciem 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 external-secrets-operatorEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd external-secrets-operatorBuild
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 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 contém uma pasta `external-secrets-operator`, chame uma vez a ferramenta `scaffold` com `example` definido como `external-secrets-operator` e sem `dir`: ela grava o exemplo em uma nova pasta `external-secrets-operator`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `external-secrets-operator`, `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 `external-secrets-operator/dist/`.O que é renderizado
O build emite o operador external-secrets como um conjunto de objetos do Kubernetes:
- 24
CustomResourceDefinitions para a API do external-secrets (ExternalSecret,SecretStore,ClusterSecretStoree os recursos relacionados de push e de geradores), - três
Deployments — o controlador, o webhook e o controlador de certificados, - o RBAC que os vincula:
ClusterRoles,ClusterRoleBindings, umRolee umRoleBinding, - três
ServiceAccounts, uma por carga de trabalho, - um
Servicepara o webhook, - duas
ValidatingWebhookConfigurations, - um
Secretde espaço reservado que o controlador de certificados preenche em tempo de execução com o certificado de serviço do webhook.
As três imagens de contêiner são fixadas na sua tag de release, para que as cargas de trabalho referenciem imagens fixadas.