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 einerWorkloadLibrary, ü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/StatelessServiceSchreiben 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:
aggrega scaffold --example workload-library-importDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd workload-library-importBuild
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlDer 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.