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:
aggrega scaffold --example workload-identity-bindingDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd workload-identity-bindingBuild
aggrega build --release release.yaml --auto-pullDer 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:
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:
features: identity: type: core/gcp-workload-identity infra: service_account_name: app-workload-identity gcp_service_account: app-dev@example-project.iam.gserviceaccount.comEin 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-identitylocals: 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 workloadserviceAccount: "{{ .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:
[… omitted: the apiVersion]kind: ServiceAccountmetadata: 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][… 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-identityWarum 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.