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

Workload-Bibliotheksimport — ein gemeinsam genutzter Workload-Körper über `$import`

Ein einzelner zustandsloser Webdienst, dessen Recipe seine Kubernetes-Workload aus einem gemeinsam genutzten Bibliothekseintrag statt aus einem Inline-Körper synthetisiert. Dies ist der dritte Authoring-Modus von spec.workload in einem Recipe:

  • Modus 1 (inline): eine Go-Template-Workload, direkt im Recipe geschrieben.
  • Modus 2 (Dateiimport): $import: ./relative/path.yaml — eine lokale Datei.
  • Modus 3 (Bibliotheksimport): $import: <Library>#/workloads/<Entry> — ein Eintrag einer WorkloadLibrary, über eine Identität aus dem bloßen Namen referenziert.

Das Recipe web-service verwendet hier Modus 3:

spec:
capability: helm
implements: example/compute/web-service
workload:
$import: BaseWorkloads#/workloads/StatelessService

Schreiben Sie die Referenz als ein einziges ununterbrochenes Token: kein Leerzeichen und kein Zeilenumbruch irgendwo darin, vom Bibliotheksnamen bis zum Fragment. Eine Referenz mit Leerraum wird abgewiesen statt bereinigt, und der Build bricht ab — siehe errors/fatal-halts.md „A reference to a library entry carries whitespace (Ein Verweis auf einen Bibliothekseintrag enthält Leerraum)“.

BaseWorkloads ist eine WorkloadLibrary, die im Hub-Katalog veröffentlicht ist (workloadlibrary/base-workloads). Ihr Eintrag StatelessService ist ein Go-Template, das im Render-Kontext dieses Recipe ausgewertet wird, daher fließen .values.image (aus Component/Aggregate) und .infra.* (Replikate, Port, Compute — aus dem Release) genau so hinein, wie sie in einen Inline-Körper fließen würden. Die Workload in eine Bibliothek auszulagern ändert nichts an dem, was bereitgestellt wird: Die gerenderte Ausgabe ist byteidentisch zur entsprechenden Inline-Workload.

Die Version der Bibliothek wird von der Lockfile pro Release geliefert — in der Referenz erscheint kein Registry-Host. Bei aggrega pull wird BaseWorkloads im Abschnitt workload_libraries der Lockfile gepinnt; bei aggrega build wird die gepinnte Bibliothek aufgelöst und ihr Eintrag gerendert.

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-library-import

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

Terminal window
cd workload-library-import

Build

Terminal window
aggrega pull --release release.yaml # pins BaseWorkloads in release.lock
aggrega build --release release.yaml

Der Katalog wird aus der in .aggrega-config.yaml benannten Hub-Registry aufgelöst (die BaseWorkloads und den helm-Provider liefert) sowie aus dem lokalen catalog/ dieses Beispiels (die Component und das Recipe web-service). Die Manifests landen unter dist/app/helm/ — die directory: der Boundary, gefolgt von der Fähigkeit des Providers.

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-library-import` enthält, rufen Sie das Werkzeug `scaffold` einmal auf, mit `example` auf `workload-library-import` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `workload-library-import`. Rufen Sie dann das Werkzeug `build` auf, mit `workspace_root` auf `workload-library-import`, `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-library-import/dist/`.

Die Behauptung der Byte-Identität überprüfen

Ersetzen Sie im Recipe workload: { $import: … } durch einen Block workload: |, der den Körper von StatelessService wortgetreu enthält, führen Sie den Build erneut aus und vergleichen Sie die beiden Bäume dist/ per diff. Sie stimmen exakt überein: Die Bibliotheksreferenz wird zum selben Template-Text aufgelöst, im selben Render-Kontext ausgewertet, daher ist der Import eine Faktorisierung der Authoring-Oberfläche ohne Auswirkung auf die gerenderten Bytes.