cert-manager — controlador do ciclo de vida de certificados TLS do Kubernetes
Este exemplo compila um stack pequeno e real — um controlador de certificados cert-manager — a partir de um único Aggregate escrito pelo desenvolvedor para o Kubernetes. O desenvolvedor declara o que o cert-manager é; uma única Recipe de Ops mapeia essa intenção para o chart Helm oficial do cert-manager no registro jetstack e renderiza os objetos do Kubernetes.
O cert-manager é um complemento do Kubernetes com escopo 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. Ele estende o cluster com os seus próprios recursos personalizados Certificate, Issuer e ClusterIssuer. As aplicações pedem certificados declarando esses recursos — não conectando um upstream —, então o componente não recebe nenhuma aresta uses. Pelo mesmo motivo, ele não tem uma forma independente de contêiner local, então esta família traz apenas uma Recipe Helm; não há destino Compose. Tudo o que o componente publica é onde um servidor Prometheus encontra as suas métricas.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um único componente cert-manager (core/security/cert-manager) com a instalação dos CRDs ativada. |
manifest.yaml | Mapeia o tipo de componente para a Recipe Helm do cert-manager (cert-manager). |
release.yaml | Documento do operador para o destino Kubernetes: o dimensionamento de controlador/webhook/injetor de CA. |
O que ele demonstra
- Uma única superfície de autoria, realizada por uma Recipe de Ops. O Aggregate é a fonte da verdade sobre o que o cert-manager é. O Manifest diz como realizá-lo mapeando o tipo de componente para uma Recipe pelo nome; a Release fornece o dimensionamento operacional. A intenção do desenvolvedor e o mapeamento de Ops permanecem separados.
- Três cargas de trabalho coordenadas a partir de um componente. A Recipe renderiza as três partes do cert-manager: um
Deploymentpara o controlador que reconcilia as solicitações de certificado, umDeploymentpara o webhook que valida os recursos personalizados e define os seus valores padrão, e umDeploymentpara o injetor de CA que liga o bundle de CA do webhook ao cluster. - Instalação da API de certificados. O valor
install_crdsdo desenvolvedor flui para o chart, que instala asCustomResourceDefinitions do cert-manager (os recursosCertificate,Issuer,ClusterIssuere ACMEOrder/Challenge). Defina-o como false quando os CRDs forem gerenciados por fora. - Conexão de admissão. O chart emite a
ValidatingWebhookConfiguratione aMutatingWebhookConfigurationque o webhook atende, oServicedo webhook e o conjunto RBAC completo — umClusterRole/ClusterRoleBindingpor responsabilidade do controlador mais osRoles de eleição de líder —, para que o controlador tenha as permissões de que precisa. - Imagens reproduzíveis. O chart traz tags de release resolvíveis; a Recipe fixa novamente 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
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 cert-manager-tlsEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd cert-manager-tlsBuild
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 apenas as ferramentas do Aggrega e não crie nenhuma pasta você mesmo. Se a pasta do workspace 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`: ela escreve o exemplo em uma 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 quais arquivos o build escreveu; eles ficam em `cert-manager-tls/dist/`.O que é renderizado
O build emite o stack completo 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. Ele também inclui um Job pós-instalação (a verificação da API na inicialização, que bloqueia até que a API de certificados esteja 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 são fixadas nas suas tags de release, para que cada carga de trabalho referencie uma tag de imagem fixada.