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

Credenziali a più chiavi su un Deployment helm sintetizzato

Una singola app senza stato renderizzata su Kubernetes dalla sintesi del Workload del provider helm — nessun chart esterno. L’app legge due chiavi di dati da un unico segreto: un nome utente e una password. Un unico slot di credenziale le supporta entrambe, riempito da una credenziale referenziabile a più chiavi.

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 multikey-secret-synth

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

Terminal window
cd multikey-secret-synth

Build

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

Il catalogo si risolve da due sorgenti nominate in .aggrega-config.yaml: il ./catalog dell’esempio stesso (il Component local/compute/app e la sua Recipe synth helm/app) e il registry hub (la Feature di credenziale a più chiavi, la sua FeatureRecipe e il Provider helm). --auto-pull scrive durante il build il lockfile che manca a un clone appena creato. Tre manifest finiscono sotto dist/helm/helm/.

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 del workspace non contiene ancora una cartella `multikey-secret-synth`, chiama una volta lo strumento `scaffold` con `example` impostato su `multikey-secret-synth` e senza `dir`: scrive l’esempio in una nuova cartella `multikey-secret-synth`. Poi chiama lo strumento `build` con `workspace_root` impostato su `multikey-secret-synth`, `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 `multikey-secret-synth/dist/`.

Uno slot, due chiavi

Il Component dichiara uno slot di credenziale trasparente, app_credentials (inject: [env]). L’Aggregate lo riempie con core/referenced-secret-set — una credenziale referenziabile a più chiavi che materializza un unico Secret Kubernetes contenente un insieme di chiavi di dati fornito dal chiamante e pubblica solo il localizzatore del Secret (provides.name). Qui il chiamante fornisce due chiavi:

aggregate.yaml
features:
app_credentials:
type: core/referenced-secret-set
values:
entries:
- key: db_username
value: appuser
- key: db_password
value: dev-pw-change-me

Il Manifest mappa core/referenced-secret-set sulla FeatureRecipe k8s-secret-set, che renderizza un unico Secret contenente entrambe le chiavi:

app--app-zucredentials--app-secret-app-app-credentials.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: app-app-credentials
[… omitted: the labels and annotations every rendered document carries]
stringData:
db_username: "appuser"
db_password: "dev-pw-change-me"

Fare riferimento a un unico slot per ciascuna chiave

La Recipe synth fa riferimento allo stesso slot due volte — una per chiave di dati. Ciascuna voce nomina la chiave di dati che legge tramite il campo key; la chiave della mappa della voce è il nome della variabile d’ambiente:

# helm/app recipe workload
attachments:
APP_DB_USER:
from: app_credentials
as: env
key: db_username
APP_DB_PASSWORD:
from: app_credentials
as: env
key: db_password

Il sintetizzatore renderizza un secretKeyRef env per voce. Entrambi fanno riferimento allo stesso Secret (provides.name), ciascuno con la propria chiave di dati:

# app-deployment.yaml (container env)
- name: APP_DB_USER
valueFrom:
secretKeyRef:
name: app-app-credentials # == the Secret's metadata.name
key: db_username
- name: APP_DB_PASSWORD
valueFrom:
secretKeyRef:
name: app-app-credentials # same Secret
key: db_password # different data key
[… omitted: the GREETING variable, set from the Aggregate's greeting value]

Il campo key è ciò che rende un segreto a più chiavi utilizzabile da un Workload sintetizzato. Quando una voce omette key, legge invece l’unica chiave di dati pubblicata dello slot — la forma che usa una credenziale a chiave singola (core/referenced-secret), che pubblica sia un localizzatore sia una chiave.

Dimensionamento da parte dell’operatore

release.yaml soddisfa il pilastro del dimensionamento dell’operatore per ambiente: il tag dell’immagine del container proviene da infra.image_tag (myapp:1.2). L’Aggregate dello sviluppatore non porta mai questo campo.