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

Padrões avançados

Esta página explica uma ideia, o Manifest e a FeatureRecipe como os locais que decidem o que uma compilação escreve para além da Recipe própria de um componente, e não é um workspace executável. Substituição de receita por instância mostra a metade relativa ao Manifest num workspace que se compila; pode escrevê-lo numa pasta própria com:

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

Depois, imprime os próximos comandos a executar:

Terminal window
cd per-instance-recipe-override
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

Uma instância, uma Recipe própria

O nível type do Manifest associa cada instância de um tipo de componente a uma única Recipe. O seu nível name associa uma instância concreta, pelo nome que tem no Aggregate, a outra, e a instância aí nomeada recebe-a, enquanto todas as outras instâncias do tipo mantêm a associação type. Do manifest.yaml do exemplo:

spec:
mappings:
components:
type:
example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0
name:
greeter-special: compose/greeter-green:1.0.0

Ganha a entrada mais específica:

  1. a entrada name para o nome da instância;
  2. a entrada type que nomeia o tipo na versão da instância, como example/compute/greeter:1.0.0;
  3. a entrada type que nomeia o tipo sem versão;
  4. sem qualquer entrada, a compilação é interrompida, nomeando a instância sem mapeamento.

Um Manifest é YAML comum, pelo que um valor que repete pode ser escrito uma vez com uma âncora e referenciado com um alias.

Uma Feature que traz recursos próprios

Uma FeatureRecipe pode renderizar recursos ao lado dos do componente, a partir de um chart próprio indicado por source: e alimentado pelo seu valuesMapping, em vez de alterar o que a Recipe do componente renderiza. O core/public-ingress da biblioteca padrão é realizado desta forma no Kubernetes, por helm/public-ingress, que renderiza um Ingress para o componente a que está anexado.

O caminho do pedido que um componente serve faz parte do que a aplicação é, pelo que a Feature o recebe em values; o nome de anfitrião é o nome que o ambiente dá ao componente, pelo que é infra, ao lado dos parâmetros que descrevem o cluster. Em Um agente, um router e dois modelos a montante, o programador anexa-a no Aggregate e escreve o caminho:

features:
published:
type: core/public-ingress
values:
path: /

e a Release dá ao mesmo anexo o seu anfitrião e afirma que um controlador de ingress é executado no cluster de destino, afirmação sem a qual a compilação é interrompida, a partir de release.yaml sem os comentários:

published:
infra:
host: assistant.example.internal
control_plane_present: true

A FeatureRecipe nomeia os recursos que renderiza a partir de .context.rendered_name, o nome do componente anfitrião tal como o seu fornecedor o reporta, para que o Ingress aponte para o Service que a Recipe própria do componente renderiza. Um host escrito nos values do Aggregate, ou um path na infra da Release, é recusado com a indicação do campo: cada pilar é fechado, e o campo pertence ao outro. Um caminho que difere entre ambientes é um parâmetro que o Aggregate declara e que cada Release cumpre.