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

Eine Arbeitslast an das binden, was eine Anbindung veröffentlicht

Eine einzelne zustandslose App, auf Kubernetes durch die Workload-Synthese des helm-Providers gerendert — kein externes Chart. Die App läuft unter einer Cloud-Identität, für die ihre Component einen Slot deklariert und die das Release befüllt: Die Anbindung, die den Slot befüllt, emittiert einen Kubernetes-ServiceAccount und veröffentlicht dessen Namen, und das Recipe der App bindet den Pod an diesen veröffentlichten Namen.

Der didaktische Kern ist die Richtung des Flusses. Der Produzent nennt den Namen einmal; der Konsument liest ihn. Nichts auf der konsumierenden Seite wiederholt einen Wert, den der Produzent bereits besitzt, daher können die beiden nicht auseinanderdriften.

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 workload-identity-binding

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

Terminal window
cd workload-identity-binding

Build

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

Der Katalog wird aus zwei Quellen aufgelöst, die in .aggrega-config.yaml benannt sind: dem eigenen ./catalog des Beispiels (die Component local/compute/identity-app und ihr Synthese-Recipe helm/identity-app) und der Hub-Registry (das Feature core/gcp-workload-identity und sein FeatureRecipe). --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-Werkzeuge und legen Sie selbst keinen Ordner an. Wenn der Ordner des Arbeitsbereichs noch keinen Ordner `workload-identity-binding` enthält, rufen Sie das Werkzeug `scaffold` einmal auf, mit `example` auf `workload-identity-binding` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `workload-identity-binding`. Rufen Sie dann das Werkzeug `build` auf, mit `workspace_root` auf `workload-identity-binding`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `workload-identity-binding/dist/`.

Die Component deklariert den Bedarf; das Release erfüllt ihn

Die App braucht eine Identität, unter der sie läuft, daher deklariert ihre Component eine, als erforderlichen Slot identity:

catalog/component/local/compute/identity-app/1.0.0/component.yaml
featuresSchema:
identity:
required: true
selector: "feature.aggrega.ai/kind!=secret"
inject: []

Das Aggregate schreibt dafür nichts. Unter welcher Identität die App läuft, und auf welcher Cloud, ist die Wahl des Operators für jedes Ziel, daher befüllt das Release den Slot mit dem Identitäts-Feature und jedem Feld, das dieses Feature benötigt:

release.yaml
features:
identity:
type: core/gcp-workload-identity
infra:
service_account_name: app-workload-identity
gcp_service_account: app-dev@example-project.iam.gserviceaccount.com

Ein Release, das den Slot unbefüllt lässt, bricht ab und benennt den Slot. Ein Release für einen EKS-Cluster befüllt denselben Slot stattdessen mit core/aws-irsa und dessen role_arn, und sein Manifest bildet dieses Feature auf sein FeatureRecipe ab. Der Selektor hält Zugangsdaten aus dem Slot heraus: Ein Feature vom Typ Secret, das ihn befüllt, führt zum Abbruch.

Die Anbindung veröffentlicht

Das Feature deklariert in seinem schema.provides, dass es einen name veröffentlicht, und sein FeatureRecipe veröffentlicht ihn — aus demselben lokalen Wert, mit dem das emittierte Chart den ServiceAccount benennt, nämlich dem vom Operator gesetzten service_account_name, wenn das Release einen schreibt:

# FeatureRecipe gcp-workload-identity
locals:
sa_name: '{{ default (printf "%s-%s" .context.rendered_name (.attachment_name | replace "_" "-")) .infra.service_account_name }}'
provides:
name: "{{ .locals.sa_name }}"

Das Recipe konsumiert

Das konsumierende Recipe liest den veröffentlichten Namen unter .features.<instance-name>.provides.<key>:

# helm/identity-app recipe workload
serviceAccount: "{{ .features.identity.provides.name }}"
containers:
main:
variables:
IDENTITY_SERVICE_ACCOUNT: {{ .features.identity.provides.name }}

Beide Lesezugriffe werden zu dem ServiceAccount aufgelöst, den die Anbindung tatsächlich emittiert hat:

app--identity--app-serviceaccount-app-workload-identity.yaml
[… omitted: the apiVersion]
kind: ServiceAccount
metadata:
name: app-workload-identity
annotations:
iam.gke.io/gcp-service-account: "app-dev@example-project.iam.gserviceaccount.com"
[… omitted: the boundary and recipe annotations, and the labels, that every rendered document carries]
app-deployment.yaml
[… omitted: the Deployment's metadata, selector and pod template up to the containers]
containers:
- name: main
[… omitted: the image and the port]
env:
[… omitted: the GREETING variable]
- name: IDENTITY_SERVICE_ACCOUNT
value: app-workload-identity
serviceAccountName: app-workload-identity

Warum lesen statt wiederholen

Die Alternative ist, app-workload-identity ein zweites Mal auf der konsumierenden Seite zu schreiben. Das funktioniert, bis jemand den service_account_name des Operators ändert und nur eine der beiden Stellen aktualisiert — dann fordert der Pod einen ServiceAccount an, der nicht existiert, und nichts in der Kompilierung bemerkt es, weil beide Schreibweisen gültige Strings sind.

Das Lesen von .features.identity.provides.name beseitigt die zweite Schreibweise. Dieselbe Struktur gilt für jede Anbindung: Zugangsdaten veröffentlichen den Locator ihres Secrets unter .features.<slot>.provides.name, ein Sidecar veröffentlicht seinen Port, eine Identität veröffentlicht ihren Namen. Die vollständige Struktur der Anbindung, Feld für Feld, steht unter templates/template-context-contract.md.

Dimensionierung durch den Betreiber

release.yaml erfüllt die Säule der Operator-Dimensionierung pro Umgebung: Der Image-Tag des Containers stammt aus infra.image_tag (myapp:1.2), und die Identität — ihr Feature und die Felder dieses Feature — stammt aus der Befüllung des Slots. Das Aggregate des Entwicklers enthält keines von beiden.