Sovrascrittura della recipe per istanza
Questo esempio insegna una funzionalità del Manifest: il livello di mappatura name, che sovrascrive la Recipe per una singola istanza di componente mentre ogni altra istanza dello stesso tipo mantiene la Recipe d’insieme del livello type.
Che cosa mostra
L’Aggregate dichiara due istanze di un unico tipo di componente (example/compute/greeter):
components: greeter-default: type: example/compute/greeter greeter-special: type: example/compute/greeterIl catalogo fornisce due Recipes che implementano entrambe example/compute/greeter — greeter-blue (il build predefinito) e greeter-green (un build alternativo). Il Manifest mappa il tipo in blocco e sovrascrive un’istanza per nome:
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 oneIl nome prevale sul tipo, quindi greeter-special viene distribuito tramite greeter-green e greeter-default tramite greeter-blue.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example per-instance-recipe-overridePoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd per-instance-recipe-overrideBuild
aggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlQuesto esempio usa la libreria standard per il suo provider: il provider compose è incluso nel catalogo standard. I giocattoli propri della lezione sulla sovrascrittura — il componente dimostrativo example/compute/greeter e le sue due recipe (greeter-blue / greeter-green), che esistono solo per rendere visibile la sovrascrittura per istanza — si trovano nel catalogo condiviso sotto l’editore example/, accanto alle entità della libreria standard. .aggrega-config.yaml dichiara hub.aggrega.ai come registry predefinito, quindi le entità vengono risolte dall’hub — il comando di build non richiede alcun flag --catalog.
Il dist/app/compose/docker-compose.yaml renderizzato mostra la sovrascrittura in azione — greeter-default esegue image: greeter:blue, greeter-special esegue image: greeter:green, e l’etichetta di provenienza aggrega.ai/recipe-uri di ciascun servizio nomina la Recipe distinta in cui si è risolto.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella Workspace non contiene ancora una cartella `per-instance-recipe-override`, chiama una volta lo strumento `scaffold` con `example` impostato a `per-instance-recipe-override` e senza `dir`: scrive l’esempio in una nuova cartella `per-instance-recipe-override`. Poi chiama lo strumento `build` con `workspace_root` impostato a `per-instance-recipe-override`, `release` impostato a `release.yaml`, `auto_pull` impostato a true e `write` impostato a true. Dimmi quali file ha scritto la build; si trovano in `per-instance-recipe-override/dist/`.Perché è utile
Due istanze di un unico tipo di componente a volte richiedono implementazioni fisiche diverse — ad esempio un database primario su una Recipe cloud gestita mentre le sue repliche usano la Recipe interna al cluster. Il livello name lo esprime per istanza, nel Manifest, senza biforcare il tipo di componente né duplicare l’Aggregate. Un tipo che più di una Recipe implementa deve essere disambiguato da una mappatura; se resta non mappato, il build si arresta e nomina i candidati anziché tirare a indovinare.