Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Zugangsdaten mit mehreren Schlüsseln auf einem synthetisierten helm-Deployment

Eine einzelne zustandslose App, auf Kubernetes durch die Workload-Synthese des helm-Providers gerendert — kein externes Chart. Die App liest zwei Datenschlüssel aus einem einzigen Secret: einen Benutzernamen und ein Passwort. Ein einziger Zugangsdaten-Slot stellt beide bereit, befüllt durch referenzierbare Zugangsdaten mit mehreren Schlüsseln.

Das Beispiel generieren

Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.

Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:

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

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd multikey-secret-synth

Build

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

Der Katalog wird aus zwei Quellen aufgelöst, die in .aggrega-config.yaml genannt sind: dem eigenen ./catalog des Beispiels (die Component local/compute/app und ihr synth-Recipe helm/app) und der Hub-Registry (das Zugangsdaten-Feature mit mehreren Schlüsseln, sein FeatureRecipe und der helm-Provider). --auto-pull schreibt während des Builds die Lockfile, die einem frischen Klon fehlt. Drei Manifeste landen unter dist/helm/helm/.

Mit einem KI-Assistenten

Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.

Verwenden Sie ausschließlich die Aggrega-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `multikey-secret-synth` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `multikey-secret-synth` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `multikey-secret-synth`. Rufen Sie anschließend das Tool `build` mit `workspace_root` auf `multikey-secret-synth`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt auf. Nennen Sie mir, welche Dateien der Build geschrieben hat; sie liegen unter `multikey-secret-synth/dist/`.

Ein Slot, zwei Schlüssel

Die Component deklariert einen transparenten Zugangsdaten-Slot, app_credentials (inject: [env]). Das Aggregate befüllt ihn mit core/referenced-secret-set — referenzierbaren Zugangsdaten mit mehreren Schlüsseln, die ein einziges Kubernetes-Secret materialisieren, das eine vom Aufrufer gelieferte Menge von Datenschlüsseln trägt, und nur den Lokator des Secrets veröffentlichen (provides.name). Hier liefert der Aufrufer zwei Schlüssel:

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

Das Manifest ordnet core/referenced-secret-set dem FeatureRecipe k8s-secret-set zu, das ein einziges Secret mit beiden Schlüsseln rendert:

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"

Einen Slot über jeden Schlüssel referenzieren

Das synth-Recipe referenziert denselben Slot zweimal — einmal pro Datenschlüssel. Jeder Eintrag nennt über das Feld key den Datenschlüssel, den er liest; der Map-Schlüssel des Eintrags ist der Name der Umgebungsvariable:

# 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

Der Synthesizer rendert pro Eintrag eine secretKeyRef in env. Beide referenzieren dasselbe Secret (provides.name), jede mit ihrem eigenen Datenschlüssel:

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

Das Feld key ist es, was ein Secret mit mehreren Schlüsseln aus einem synthetisierten Workload heraus nutzbar macht. Wenn ein Eintrag key weglässt, liest er stattdessen den einzigen veröffentlichten Datenschlüssel des Slots — die Form, die Zugangsdaten mit einem einzigen Schlüssel (core/referenced-secret) verwenden, die sowohl einen Lokator als auch einen Schlüssel veröffentlichen.

Dimensionierung durch den Betreiber

release.yaml erfüllt die Säule der Dimensionierung durch den Operator pro Umgebung: Das Tag des Container-Images stammt aus infra.image_tag (myapp:1.2). Das Aggregate des Entwicklers trägt dieses Feld nie.