cert-manager — controller del ciclo di vita dei certificati TLS di Kubernetes
Questo esempio compila uno stack piccolo e reale — un controller di certificati cert-manager — a partire da un unico Aggregate scritto dallo sviluppatore per Kubernetes. Lo sviluppatore dichiara che cosa è cert-manager; un’unica Recipe di Ops mappa quell’intento sul chart Helm ufficiale di cert-manager dal registry jetstack e renderizza gli oggetti Kubernetes.
cert-manager è un componente aggiuntivo di Kubernetes con ambito di cluster che automatizza l’emissione e il rinnovo di certificati X.509 da fonti emittenti come ACME (Let’s Encrypt), una CA privata o Vault. Estende il cluster con le proprie risorse personalizzate Certificate, Issuer e ClusterIssuer. Le applicazioni chiedono certificati dichiarando quelle risorse — non cablando un upstream — quindi il componente non accetta alcun arco uses. Per lo stesso motivo non ha una forma autonoma come container locale, quindi questa famiglia fornisce solo una Recipe Helm; non c’è alcuna destinazione Compose. Tutto ciò che il componente pubblica è il punto in cui un server Prometheus trova le sue metriche.
File
| File | Ruolo |
|---|---|
aggregate.yaml | Intento dello sviluppatore: un unico componente cert-manager (core/security/cert-manager) con l’installazione dei CRD attiva. |
manifest.yaml | Mappa il tipo di componente sulla Recipe Helm di cert-manager (cert-manager). |
release.yaml | Documento dell’operatore per la destinazione Kubernetes: il dimensionamento di controller/webhook/CA injector. |
Che cosa dimostra
- Un’unica superficie di authoring, realizzata da una Recipe di Ops. L’Aggregate è la fonte di verità su che cosa è cert-manager. Il Manifest dice come realizzarlo mappando il tipo di componente su una Recipe per nome; la Release fornisce il dimensionamento operativo. L’intento dello sviluppatore e la mappatura di Ops restano separati.
- Tre carichi di lavoro coordinati da un unico componente. La Recipe renderizza tutte e tre le parti di cert-manager: un
Deploymentper il controller che riconcilia le richieste di certificato, unDeploymentper il webhook che valida le risorse personalizzate e ne imposta i valori predefiniti, e unDeploymentper il CA injector che collega il bundle CA del webhook nel cluster. - Installazione dell’API dei certificati. Il valore
install_crdsdello sviluppatore confluisce nel chart, che installa leCustomResourceDefinitions di cert-manager (le risorseCertificate,Issuer,ClusterIssuere ACMEOrder/Challenge). Impostalo a false quando i CRD sono gestiti separatamente. - Cablaggio dell’ammissione. Il chart emette la
ValidatingWebhookConfiguratione laMutatingWebhookConfigurationservite dal webhook, ilServicedel webhook e l’intero set RBAC — unClusterRole/ClusterRoleBindingper ogni responsabilità del controller più iRoles per l’elezione del leader — così il controller ha i permessi di cui ha bisogno. - Immagini riproducibili. Il chart fornisce tag di release risolvibili; la Recipe rifissa le immagini del controller, del webhook, del CA injector e del solver ACME su quei tag, così i carichi di lavoro renderizzati fanno riferimento a versioni fissate.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example cert-manager-tlsPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd cert-manager-tlsBuild
Questo workspace non contiene alcun .aggrega-config.yaml, quindi le entità della libreria standard si risolvono dal registry dell’hub, hub.aggrega.ai, e non serve alcun flag di catalogo:
aggrega pull --release release.yamlaggrega build --release release.yamlGli artefatti renderizzati finiscono sotto dist/. Il build risolve il chart upstream tramite riferimento OCI con aggrega pull e lo fissa in un lockfile.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu stesso alcuna cartella. Se la cartella del workspace non contiene ancora una cartella `cert-manager-tls`, chiama una sola volta lo strumento `scaffold` con `example` impostato su `cert-manager-tls` e senza `dir`: scrive l’esempio in una nuova cartella `cert-manager-tls`. Poi chiama lo strumento `build` con `workspace_root` impostato su `cert-manager-tls`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano in `cert-manager-tls/dist/`.Che cosa viene renderizzato
Il build emette l’intero stack di cert-manager — tre Deployments (il controller, il webhook e il CA injector), le sei CustomResourceDefinitions di cert-manager quando install_crds è attivo, una ValidatingWebhookConfiguration e una MutatingWebhookConfiguration, il Service del webhook, i ServiceAccounts del controller, e il set RBAC di ClusterRoles, ClusterRoleBindings, e Roles e RoleBindings per l’elezione del leader. Include anche un Job post-installazione (il controllo dell’API all’avvio, che attende finché l’API dei certificati non è in servizio) e un Service delle metriche ciascuno per il controller e per il CA injector — 50 oggetti Kubernetes in tutto. Le immagini del controller, del webhook, del CA injector e del solver ACME sono fissate ai loro tag di release, così ogni carico di lavoro fa riferimento a un tag d’immagine fissato.