external-secrets — operador do Kubernetes de sincronização de segredos
Este exemplo compila uma stack pequena e real — o operador external-secrets — a partir de um único Aggregate escrito pelo programador para o Kubernetes, assente no chart Helm oficial do external-secrets.
O external-secrets sincroniza material secreto de sistemas externos de gestão 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 âmbito 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 encaminham tráfego, pelo que 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.
Ficheiros
| Ficheiro | Papel |
|---|---|
aggregate.yaml | Intenção do programador: 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 demonstra
- Uma única superfície de autoria. Um único Aggregate é a fonte de verdade sobre o que o operador é; o Manifest diz como realizá-lo.
- Um valor do programador flui até à renderização. O valor
install_crdsdo programador é 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 acrescenta os seus próprios recursos personalizados à API do cluster; os consumidores pedem segredos declarando esses recursos, pelo que 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 fornecedor incluído está desativado, pelo que não é incluído 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 as três imagens de contentor numa tag de release resolú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
É 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:
aggrega scaffold --example external-secrets-operatorDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd external-secrets-operatorCompilaçã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:
aggrega pull --release release.yamlaggrega build --release release.yamlOs 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.
Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por si. Se a pasta da área de trabalho ainda não contiver uma pasta `external-secrets-operator`, chame uma vez a ferramenta `scaffold` com `example` definido como `external-secrets-operator` e sem `dir`: esta escreve o exemplo numa 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. Indique-me que ficheiros o build escreveu; encontram-se em `external-secrets-operator/dist/`.O que é renderizado
A compilação 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 marcador de posição que o controlador de certificados preenche em tempo de execução com o certificado de serviço do webhook.
As três imagens de contentor estão fixadas na sua tag de release, pelo que as cargas de trabalho referenciam imagens fixadas.