Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

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

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

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

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

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

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

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