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

cert-manager — controlador do ciclo de vida de certificados TLS do Kubernetes

Este exemplo compila uma stack pequena e real — um controlador de certificados cert-manager — a partir de um único Aggregate escrito pelo programador para o Kubernetes. O programador declara o que o cert-manager é; uma única Recipe de Ops mapeia essa intenção para o chart Helm oficial do cert-manager no registo jetstack e renderiza os objetos do Kubernetes.

O cert-manager é um complemento do Kubernetes com âmbito de cluster que automatiza a emissão e a renovação de certificados X.509 a partir de fontes emissoras como ACME (Let’s Encrypt), uma CA privada ou o Vault. Estende o cluster com os seus próprios recursos personalizados Certificate, Issuer e ClusterIssuer. As aplicações pedem certificados declarando esses recursos — e não ligando um upstream —, pelo que o componente não recebe nenhuma aresta uses. Pelo mesmo motivo, não tem uma forma autónoma de contentor local, pelo que esta família inclui apenas uma Recipe Helm; não há destino Compose. Tudo o que o componente publica é onde um servidor Prometheus encontra as suas métricas.

Ficheiros

FicheiroPapel
aggregate.yamlIntenção do programador: um único componente cert-manager (core/security/cert-manager) com a instalação dos CRD ativada.
manifest.yamlMapeia o tipo de componente para a Recipe Helm do cert-manager (cert-manager).
release.yamlDocumento do operador para o destino Kubernetes: o dimensionamento de controlador/webhook/injetor de CA.

O que demonstra

  • Uma única superfície de autoria, realizada por uma Recipe de Ops. O Aggregate é a fonte de verdade sobre o que o cert-manager é. O Manifest diz como realizá-lo ao mapear o tipo de componente para uma Recipe pelo nome; a Release fornece o dimensionamento operacional. A intenção do programador e o mapeamento de Ops mantêm-se separados.
  • Três cargas de trabalho coordenadas a partir de um componente. A Recipe renderiza as três partes do cert-manager: um Deployment para o controlador que reconcilia os pedidos de certificado, um Deployment para o webhook que valida os recursos personalizados e lhes atribui valores predefinidos, e um Deployment para o injetor de CA que liga o bundle de CA do webhook ao cluster.
  • Instalação da API de certificados. O valor install_crds do programador flui para o chart, que instala as CustomResourceDefinitions do cert-manager (os recursos Certificate, Issuer, ClusterIssuer e ACME Order/Challenge). Deve ser definido como false quando os CRD são geridos à parte.
  • Ligação de admissão. O chart emite a ValidatingWebhookConfiguration e a MutatingWebhookConfiguration que o webhook serve, o Service do webhook e o conjunto RBAC completo — um ClusterRole/ClusterRoleBinding por responsabilidade do controlador mais os Roles de eleição de líder —, para que o controlador tenha as permissões de que precisa.
  • Imagens reproduzíveis. O chart inclui tags de release resolúveis; a Recipe volta a fixar as imagens do controlador, do webhook, do injetor de CA e do solver ACME nessas tags, para que as cargas de trabalho renderizadas referenciem versões fixadas.

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 cert-manager-tls

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

Terminal window
cd cert-manager-tls

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 do espaço de trabalho ainda não contiver uma pasta `cert-manager-tls`, chame a ferramenta `scaffold` uma única vez com `example` definido como `cert-manager-tls` e sem `dir`: esta escreve o exemplo numa nova pasta `cert-manager-tls`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `cert-manager-tls`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me que ficheiros a compilação escreveu; encontram-se em `cert-manager-tls/dist/`.

O que é renderizado

A compilação emite a stack completa do cert-manager — três Deployments (o controlador, o webhook e o injetor de CA), as seis CustomResourceDefinitions do cert-manager quando install_crds está ativado, uma ValidatingWebhookConfiguration e uma MutatingWebhookConfiguration, o Service do webhook, as ServiceAccounts do controlador, e o conjunto RBAC de ClusterRoles, ClusterRoleBindings, e Roles e RoleBindings de eleição de líder. Inclui também um Job pós-instalação (a verificação da API no arranque, que bloqueia até a API de certificados estar em serviço) e um Service de métricas para o controlador e outro para o injetor de CA — 50 objetos do Kubernetes no total. As imagens do controlador, do webhook, do injetor de CA e do solver ACME estão fixadas nas suas tags de release, pelo que cada carga de trabalho referencia uma tag de imagem fixada.