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/greeterDer 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 oneDer 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:
aggrega scaffold --example per-instance-recipe-overrideDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd per-instance-recipe-overrideBuild
aggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlDieses 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.