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
| Ficheiro | Papel |
|---|---|
aggregate.yaml | Intenção do programador: um único componente cert-manager (core/security/cert-manager) com a instalação dos CRD 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 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
Deploymentpara o controlador que reconcilia os pedidos de certificado, umDeploymentpara o webhook que valida os recursos personalizados e lhes atribui valores predefinidos, 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 programador flui para o chart, que instala asCustomResourceDefinitions do cert-manager (os recursosCertificate,Issuer,ClusterIssuere ACMEOrder/Challenge). Deve ser definido como false quando os CRD são geridos à parte. - Ligação de admissão. O chart emite a
ValidatingWebhookConfiguratione aMutatingWebhookConfigurationque o webhook serve, 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 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:
aggrega scaffold --example cert-manager-tlsDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd cert-manager-tlsCompilaçã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 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.