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

Substituição de recipe por instância

Este exemplo ensina uma funcionalidade do Manifest: o nível de mapeamento name, que substitui 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 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 (a compilação predefinida) e greeter-green (uma compilação alternativa). O Manifest mapeia o tipo em bloco e substitui 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, pelo que greeter-special é implementado através de greeter-green e greeter-default através de greeter-blue.

Gerar o exemplo

É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.

Escreva o exemplo numa nova pasta com o nome dele:

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

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd per-instance-recipe-override

Compilação

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 fornecedor: o fornecedor compose vem incluído no catálogo padrão. Os brinquedos próprios da lição sobre a substituição — 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 substituição por instância — encontram-se no catálogo partilhado sob o editor example/, ao lado das entidades da biblioteca padrão. .aggrega-config.yaml declara hub.aggrega.ai como registo predefinido, pelo que as entidades são resolvidas a partir do hub — o comando de compilação não precisa de nenhuma flag --catalog.

O dist/app/compose/docker-compose.yaml renderizado mostra a substituição em ação — greeter-default executa image: greeter:blue, greeter-special executa image: greeter:green, e a etiqueta de proveniência aggrega.ai/recipe-uri de cada serviço nomeia a Recipe distinta para a qual foi resolvido.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.

Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa 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`: esta escreve o exemplo numa 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. Indique-me que ficheiros a compilação escreveu; encontram-se em `per-instance-recipe-override/dist/`.

Porque é que isto é útil

Duas instâncias de um mesmo tipo de componente precisam por vezes de implementações físicas diferentes — por exemplo, uma base de dados primária numa Recipe de nuvem gerida enquanto as suas réplicas usam a Recipe interna ao cluster. O nível name exprime isso por instância, no Manifest, sem bifurcar o tipo de componente nem duplicar o Aggregate. Um tipo implementado por mais de uma Recipe tem de ser desambiguado por um mapeamento; se ficar sem mapeamento, a compilação é interrompida e nomeia os candidatos em vez de adivinhar.