Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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

FileRuolo
aggregate.yamlIntento dello sviluppatore: un unico componente cert-manager (core/security/cert-manager) con l’installazione dei CRD attiva.
manifest.yamlMappa il tipo di componente sulla Recipe Helm di cert-manager (cert-manager).
release.yamlDocumento 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 Deployment per il controller che riconcilia le richieste di certificato, un Deployment per il webhook che valida le risorse personalizzate e ne imposta i valori predefiniti, e un Deployment per il CA injector che collega il bundle CA del webhook nel cluster.
  • Installazione dell’API dei certificati. Il valore install_crds dello sviluppatore confluisce nel chart, che installa le CustomResourceDefinitions di cert-manager (le risorse Certificate, Issuer, ClusterIssuer e ACME Order/Challenge). Impostalo a false quando i CRD sono gestiti separatamente.
  • Cablaggio dell’ammissione. Il chart emette la ValidatingWebhookConfiguration e la MutatingWebhookConfiguration servite dal webhook, il Service del webhook e l’intero set RBAC — un ClusterRole/ClusterRoleBinding per ogni responsabilità del controller più i Roles 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:

Terminal window
aggrega scaffold --example cert-manager-tls

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd cert-manager-tls

Build

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:

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

Gli 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.