Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Sobrescritura de recipe por instancia

Este ejemplo enseña una funcionalidad del Manifest: el nivel de asignación name, que sobrescribe la Recipe para una sola instancia de componente mientras cada otra instancia del mismo tipo conserva la Recipe general del nivel type.

Qué muestra

El Aggregate declara dos instancias de un mismo tipo de componente (example/compute/greeter):

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

El catálogo incluye dos Recipes que implementan ambas example/compute/greeter — greeter-blue (la compilación predeterminada) y greeter-green (una compilación alternativa). El Manifest asigna el tipo en bloque y sobrescribe una instancia por nombre:

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

El nombre prevalece sobre el tipo, así que greeter-special se despliega mediante greeter-green y greeter-default mediante greeter-blue.

Generar el ejemplo

Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

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

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd per-instance-recipe-override

Compilación

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

Este ejemplo consume la biblioteca estándar para su proveedor: el proveedor compose se incluye en el catálogo estándar. Los juguetes propios de la lección sobre la sobrescritura — el componente de demostración example/compute/greeter y sus dos recipes (greeter-blue / greeter-green), que existen solo para hacer visible la sobrescritura por instancia — viven en el catálogo compartido bajo el editor example/, junto a las entidades de la biblioteca estándar. .aggrega-config.yaml declara hub.aggrega.ai como registro predeterminado, así que las entidades se resuelven desde el hub — el comando de compilación no necesita ningún flag --catalog.

El dist/app/compose/docker-compose.yaml renderizado muestra la sobrescritura en acción — greeter-default ejecuta image: greeter:blue, greeter-special ejecuta image: greeter:green, y la etiqueta de procedencia aggrega.ai/recipe-uri de cada servicio nombra la Recipe distinta a la que se resolvió.

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta Workspace aún no contiene una carpeta `per-instance-recipe-override`, llama una vez a la herramienta `scaffold` con `example` establecido en `per-instance-recipe-override` y sin `dir`: escribe el ejemplo en una nueva carpeta `per-instance-recipe-override`. Luego llama a la herramienta `build` con `workspace_root` establecido en `per-instance-recipe-override`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `per-instance-recipe-override/dist/`.

Por qué es útil

Dos instancias de un mismo tipo de componente a veces necesitan implementaciones físicas distintas — por ejemplo, una base de datos primaria en una Recipe de nube gestionada mientras sus réplicas usan la Recipe interna del clúster. El nivel name lo expresa por instancia, en el Manifest, sin bifurcar el tipo de componente ni duplicar el Aggregate. Un tipo implementado por más de una Recipe debe desambiguarse mediante una asignación; si queda sin asignar, la compilación se detiene y nombra a los candidatos en lugar de adivinar.