Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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/greeter

Il 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 one

Il 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:

Terminal window
aggrega scaffold --example per-instance-recipe-override

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

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

Questo 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.