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
| File | Ruolo |
|---|---|
aggregate.yaml | Intento dello sviluppatore: un unico componente sealed-secrets (core/security/sealed-secrets). |
manifest.yaml | Mappa il tipo di componente sulla Recipe ufficiale con sorgente (sealed-secrets). |
release.yaml | Documento 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
SealedSecretsi 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 arcousese 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:
aggrega scaffold --example sealed-secrets-controllerPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd sealed-secrets-controllerBuild
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/. 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
CustomResourceDefinitionper l’API di sealed-secrets (SealedSecret), - un
Deployment— il controller, - l’RBAC che lo vincola: un
ClusterRole, unClusterRoleBinding, dueRoles e dueRoleBindings, - 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.