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

external-secrets — operatore Kubernetes di sincronizzazione dei segreti

Questo esempio compila uno stack piccolo e reale — l’operatore external-secrets — a partire da un unico Aggregate scritto dallo sviluppatore per Kubernetes, basato sul chart Helm ufficiale di external-secrets.

external-secrets sincronizza materiale segreto da sistemi esterni di gestione dei segreti — HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, Azure Key Vault e altri — in Secret nativi di Kubernetes, mantenendoli sincronizzati man mano che la sorgente cambia. È un controller con ambito di cluster che estende l’API del cluster con le proprie risorse personalizzate, anziché un server verso cui le applicazioni instradano, quindi non accetta alcun arco uses, e tutto ciò che pubblica è il punto in cui un server Prometheus trova le sue metriche: le applicazioni ottengono i propri segreti dichiarando risorse ExternalSecret e SecretStore, e l’operatore materializza i corrispondenti Secrets di Kubernetes.

File

FileRuolo
aggregate.yamlIntento dello sviluppatore: un unico componente external-secrets (core/security/external-secrets) che installa le definizioni delle risorse personalizzate insieme alla release.
manifest.yamlMappa il tipo di componente sulla Recipe ufficiale con sorgente (external-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 è l’operatore; il Manifest dice come realizzarlo.
  • Un valore dello sviluppatore arriva fino al rendering. Il valore install_crds dello sviluppatore viene scritto nel valore installCRDs del chart, portando nel cluster le definizioni delle risorse personalizzate di external-secrets insieme alla release.
  • Un controller che estende il cluster, nessun arco di topologia. external-secrets aggiunge le proprie risorse personalizzate all’API del cluster; i consumatori richiedono segreti dichiarando quelle risorse, quindi il componente non cabla alcun arco uses ed esporta soltanto il punto in cui si trovano le sue metriche.
  • Un unico operatore coerente. Il chart renderizza il controller, il webhook e il controller dei certificati come un unico operatore; il subchart del provider incluso è disattivato, quindi non viene introdotto alcun datastore, cache o broker estraneo. L’output renderizzato è identico byte per byte tra esecuzioni con lo stesso input.
  • Un’immagine riproducibile. La Recipe fissa tutte e tre le immagini dei container a un tag di release risolvibile (ghcr.io/external-secrets/external-secrets:v2.7.0), così i carichi di lavoro renderizzati fanno 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 external-secrets-operator

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

Terminal window
cd external-secrets-operator

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

Che cosa viene renderizzato

Il build emette l’operatore external-secrets come un insieme di oggetti Kubernetes:

  • 24 CustomResourceDefinitions per l’API di external-secrets (ExternalSecret, SecretStore, ClusterSecretStore e le relative risorse di push e di generatori),
  • tre Deployments — il controller, il webhook e il controller dei certificati,
  • l’RBAC che li vincola: ClusterRoles, ClusterRoleBindings, un Role e un RoleBinding,
  • tre ServiceAccounts, uno per carico di lavoro,
  • un Service per il webhook,
  • due ValidatingWebhookConfigurations,
  • un Secret segnaposto che il controller dei certificati popola in fase di esecuzione con il certificato di servizio del webhook.

Tutte e tre le immagini dei container sono fissate al loro tag di release, così i carichi di lavoro fanno riferimento a immagini fissate.