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

Recipe-Überschreibung pro Instanz

Dieses Beispiel vermittelt eine Funktion des Manifest: die name-Zuordnungsebene, die das Recipe für eine einzelne Komponenten-Instanz überschreibt, während jede andere Instanz desselben Typs das pauschale Recipe der type-Ebene behält.

Was es zeigt

Das Aggregate deklariert zwei Instanzen eines einzigen Komponententyps (example/compute/greeter):

components:
greeter-default:
type: example/compute/greeter
greeter-special:
type: example/compute/greeter

Der Katalog liefert zwei Recipes, die beide example/compute/greeter implementieren — greeter-blue (der Standard-Build) und greeter-green (ein alternativer Build). Das Manifest ordnet den Typ pauschal zu und überschreibt eine Instanz über ihren Namen:

mappings:
components:
type:
example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 # every greeter instance...
name:
greeter-special: compose/greeter-green:1.0.0 # ...except this one

Der Name hat Vorrang vor dem Typ, daher wird greeter-special über greeter-green und greeter-default über greeter-blue bereitgestellt.

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 per-instance-recipe-override

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

Terminal window
cd per-instance-recipe-override

Build

Terminal window
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

Dieses Beispiel nutzt die Standardbibliothek für seinen Provider: Der Provider compose wird im Standardkatalog mitgeliefert. Die eigenen Spielzeuge der Lektion über die Überschreibung — die Demo-Komponente example/compute/greeter und ihre beiden Recipes (greeter-blue / greeter-green), die nur existieren, um die Überschreibung pro Instanz sichtbar zu machen — liegen im gemeinsamen Katalog unter dem Herausgeber example/, neben den Entitäten der Standardbibliothek. .aggrega-config.yaml deklariert hub.aggrega.ai als Standard-Registry, daher werden die Entitäten aus dem Hub aufgelöst — der Build-Befehl benötigt kein Flag --catalog.

Die gerenderte dist/app/compose/docker-compose.yaml zeigt, dass die Überschreibung greift — greeter-default führt image: greeter:blue aus, greeter-special führt image: greeter:green aus, und das Herkunfts-Label aggrega.ai/recipe-uri jedes Service benennt das jeweils eigene Recipe, zu dem er aufgelöst wurde.

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

Warum das nützlich ist

Zwei Instanzen eines einzigen Komponententyps benötigen manchmal unterschiedliche physische Implementierungen — etwa eine primäre Datenbank auf einem verwalteten Cloud-Recipe, während ihre Replikate das clusterinterne Recipe verwenden. Die Ebene name drückt das pro Instanz im Manifest aus, ohne den Komponententyp zu forken oder das Aggregate zu duplizieren. Ein Typ, den mehr als ein Recipe implementiert, muss durch eine Zuordnung eindeutig gemacht werden; bleibt er ohne Zuordnung, bricht der Build ab und benennt die Kandidaten, statt zu raten.