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

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

FicheiroPapel
aggregate.yamlIntenção do programador: um único componente external-secrets (core/security/external-secrets) que instala as definições de recursos personalizados com a release.
manifest.yamlMapeia o tipo de componente para a Recipe oficial com origem (external-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 operador é; o Manifest diz como realizá-lo.
  • Um valor do programador flui até à renderização. O valor install_crds do programador é escrito no valor installCRDs do 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 uses e 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:

Terminal window
aggrega scaffold --example external-secrets-operator

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

Terminal window
cd external-secrets-operator

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.

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, ClusterSecretStore e 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, um Role e um RoleBinding,
  • três ServiceAccounts, uma por carga de trabalho,
  • um Service para o webhook,
  • duas ValidatingWebhookConfigurations,
  • um Secret de 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.