Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Informations d’identification à plusieurs clés sur un Deployment helm synthétisé

Une seule app sans état rendue sur Kubernetes par la synthèse de Workload du fournisseur helm — aucun chart externe. L’app lit deux clés de données dans un seul secret : un nom d’utilisateur et un mot de passe. Un seul slot d’informations d’identification couvre les deux, rempli par une information d’identification référençable à plusieurs clés.

Générer l’exemple

Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.

Écrivez l’exemple dans un nouveau dossier qui porte son nom :

Terminal window
aggrega scaffold --example multikey-secret-synth

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd multikey-secret-synth

Build

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

Le catalogue se résout depuis deux sources nommées dans .aggrega-config.yaml : le ./catalog propre à l’exemple (le Component local/compute/app et sa Recipe synth helm/app) et le registre hub (la Feature d’informations d’identification à plusieurs clés, sa FeatureRecipe et le Provider helm). --auto-pull écrit pendant le build le lockfile qui manque à un clone récent. Trois manifestes aboutissent sous dist/helm/helm/.

Avec un assistant IA

Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.

Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `multikey-secret-synth`, appelez une fois l’outil `scaffold` avec `example` défini sur `multikey-secret-synth` et sans `dir` : il écrit l’exemple dans un nouveau dossier `multikey-secret-synth`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `multikey-secret-synth`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `multikey-secret-synth/dist/`.

Un slot, deux clés

Le Component déclare un slot d’informations d’identification transparent, app_credentials (inject: [env]). L’Aggregate le remplit avec core/referenced-secret-set — une information d’identification référençable à plusieurs clés qui matérialise un seul Secret Kubernetes portant un ensemble de clés de données fourni par l’appelant et ne publie que le localisateur du Secret (provides.name). Ici, l’appelant fournit deux clés :

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

Le Manifest associe core/referenced-secret-set à la FeatureRecipe k8s-secret-set, qui rend un seul Secret portant les deux clés :

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"

Référencer un seul slot par chaque clé

La Recipe synth référence le même slot deux fois — une fois par clé de données. Chaque entrée nomme la clé de données qu’elle lit via le champ key ; la clé de map de l’entrée est le nom de la variable d’environnement :

# 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

Le synthétiseur rend un secretKeyRef d’env par entrée. Les deux référencent le même Secret (provides.name), chacun avec sa propre clé de données :

# 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]

Le champ key est ce qui rend un secret à plusieurs clés consommable depuis un Workload synthétisé. Lorsqu’une entrée omet key, elle lit à la place l’unique clé de données publiée du slot — la forme qu’utilise une information d’identification à clé unique (core/referenced-secret), qui publie à la fois un localisateur et une clé.

Dimensionnement par l’opérateur

release.yaml remplit le pilier du dimensionnement par l’opérateur pour chaque environnement : le tag de l’image du conteneur provient de infra.image_tag (myapp:1.2). L’Aggregate du développeur ne porte jamais ce champ.