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

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

ArquivoPapel
aggregate.yamlIntenção do desenvolvedor: 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 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_crds do desenvolvedor é 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 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 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 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:

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

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd external-secrets-operator

Build

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:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Os 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, 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 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.