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

sealed-secrets — controller Kubernetes di decifratura dei SealedSecret

Questo esempio compila uno stack piccolo e reale — il controller sealed-secrets — a partire da un unico Aggregate scritto dallo sviluppatore per Kubernetes, basato sul chart Helm ufficiale di sealed-secrets servito da un repository di chart HTTPS.

sealed-secrets permette di eseguire in sicurezza il commit di materiale segreto cifrato nel controllo di versione: una chiave pubblica cifra un segreto in una risorsa personalizzata SealedSecret, e un controller con ambito di cluster che possiede la chiave privata corrispondente la decifra riportandola a un Secret nativo di Kubernetes. Il controller estende l’API del cluster con la propria risorsa personalizzata SealedSecret, anziché essere un server verso cui le applicazioni instradano, quindi non accetta alcun arco uses e non esporta nulla verso i consumatori: le applicazioni ottengono i propri segreti dichiarando risorse SealedSecret, e il controller dissigilla i corrispondenti Secrets di Kubernetes. Il controller genera la propria coppia di chiavi di sigillatura nel cluster in fase di esecuzione, quindi in fase di rendering non viene prodotto alcun materiale di chiave.

File

FileRuolo
aggregate.yamlIntento dello sviluppatore: un unico componente sealed-secrets (core/security/sealed-secrets).
manifest.yamlMappa il tipo di componente sulla Recipe ufficiale con sorgente (sealed-secrets).
release.yamlDocumento dell’operatore per la destinazione Kubernetes: il dimensionamento delle risorse di calcolo dell’operatore.

Che cosa dimostra

  • Un’unica superficie di authoring. Un unico Aggregate è la fonte di verità su che cosa è il controller; il Manifest dice come realizzarlo.
  • Un chart servito su HTTPS. La Recipe reperisce il chart da un repository di chart HTTPS anziché da un registry OCI; la build lo risolve e lo fissa con aggrega pull.
  • Una CRD fornita nella directory CRD del chart. La CustomResourceDefinition SealedSecret si trova nella directory CRD nativa di Helm del chart, non nei template; viene renderizzata nell’output insieme alla release in modo incondizionato.
  • Un controller che estende il cluster, nessun arco di topologia. sealed-secrets aggiunge la propria risorsa personalizzata all’API del cluster; i consumatori richiedono segreti dichiarando risorse SealedSecret, quindi il componente non cabla alcun arco uses e non esporta nulla.
  • Un unico controller coerente. Il chart renderizza un unico controller con il suo RBAC e i suoi Service, nessun datastore, cache o broker estraneo. L’output renderizzato è identico byte per byte tra esecuzioni con lo stesso input.
  • Un’immagine riproducibile. La Recipe fissa l’immagine del controller a un tag di release risolvibile (docker.io/bitnami/sealed-secrets-controller:0.38.4), così il carico di lavoro renderizzato fa riferimento a una versione fissata.

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 sealed-secrets-controller

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

Terminal window
cd sealed-secrets-controller

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/. La build risolve il chart upstream dal repository di chart HTTPS 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 alcuna cartella. Se la cartella dell’area di lavoro non contiene ancora una cartella `sealed-secrets-controller`, chiama una volta lo strumento `scaffold` con `example` impostato su `sealed-secrets-controller` e senza `dir`: scrive l’esempio in una nuova cartella `sealed-secrets-controller`. Poi chiama lo strumento `build` con `workspace_root` impostato su `sealed-secrets-controller`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano sotto `sealed-secrets-controller/dist/`.

Che cosa viene renderizzato

La build emette il controller sealed-secrets come un insieme di oggetti Kubernetes:

  • una CustomResourceDefinition per l’API di sealed-secrets (SealedSecret),
  • un Deployment — il controller,
  • l’RBAC che lo vincola: un ClusterRole, un ClusterRoleBinding, due Roles e due RoleBindings,
  • un ServiceAccount,
  • due Services — il servizio del controller e il suo servizio delle metriche.

L’immagine del controller è fissata al suo tag di release, così il carico di lavoro fa riferimento a un tag di immagine fissato.