Sobrescrita de recipe por instância
Este exemplo ensina uma funcionalidade do Manifest: o nível de mapeamento name, que sobrescreve a Recipe para uma única instância de componente enquanto todas as outras instâncias do mesmo tipo mantêm a Recipe geral do nível type.
O que ele mostra
O Aggregate declara duas instâncias de um mesmo tipo de componente (example/compute/greeter):
components: greeter-default: type: example/compute/greeter greeter-special: type: example/compute/greeterO catálogo inclui duas Recipes que implementam ambas example/compute/greeter — greeter-blue (o build padrão) e greeter-green (um build alternativo). O Manifest mapeia o tipo em bloco e sobrescreve uma instância pelo 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 oneO nome prevalece sobre o tipo, então greeter-special é implantado por meio de greeter-green e greeter-default por meio de greeter-blue.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example per-instance-recipe-overrideEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd per-instance-recipe-overrideBuild
aggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlEste exemplo consome a biblioteca padrão para o seu provedor: o provedor compose vem no catálogo padrão. Os brinquedos próprios da lição sobre a sobrescrita — o componente de demonstração example/compute/greeter e as suas duas recipes (greeter-blue / greeter-green), que existem apenas para tornar visível a sobrescrita por instância — ficam no catálogo compartilhado sob o publicador example/, ao lado das entidades da biblioteca padrão. .aggrega-config.yaml declara hub.aggrega.ai como registry padrão, então as entidades são resolvidas a partir do hub — o comando de build não precisa de nenhum flag --catalog.
O dist/app/compose/docker-compose.yaml renderizado mostra a sobrescrita em ação — greeter-default executa image: greeter:blue, greeter-special executa image: greeter:green, e o rótulo de procedência aggrega.ai/recipe-uri de cada serviço nomeia a Recipe distinta para a qual ele foi resolvido.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta Workspace ainda não contiver uma pasta `per-instance-recipe-override`, chame uma vez a ferramenta `scaffold` com `example` definido como `per-instance-recipe-override` e sem `dir`: ela grava o exemplo em uma nova pasta `per-instance-recipe-override`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `per-instance-recipe-override`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `per-instance-recipe-override/dist/`.Por que isso é útil
Duas instâncias de um mesmo tipo de componente às vezes precisam de implementações físicas diferentes — por exemplo, um banco de dados primário em uma Recipe de nuvem gerenciada enquanto as suas réplicas usam a Recipe interna ao cluster. O nível name expressa isso por instância, no Manifest, sem bifurcar o tipo de componente nem duplicar o Aggregate. Um tipo implementado por mais de uma Recipe precisa ser desambiguado por um mapeamento; se ficar sem mapeamento, o build é interrompido e nomeia os candidatos em vez de adivinhar.