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

Padrões avançados

Esta página explica uma ideia, o Manifest e a FeatureRecipe como os lugares que decidem o que um build escreve 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 do Manifest em um workspace que você compila; escreva-o em uma pasta sua com:

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

Em seguida ele 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. Seu nível name associa uma instância específica, pelo nome dela no Aggregate, a outra, e a instância nomeada ali a recebe 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

Vence 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 nenhuma entrada, o build é interrompido nomeando a instância não mapeada.

Um Manifest é YAML comum, então um valor que ele 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 nomeado por source: e alimentado por seu valuesMapping, em vez de alterar o que a Recipe do componente renderiza. O core/public-ingress da biblioteca padrão é realizado dessa forma no Kubernetes, por helm/public-ingress, que renderiza um Ingress para o componente ao qual está vinculado.

O caminho de requisição que um componente atende faz parte do que a aplicação é, então a Feature o recebe em values; o hostname é o nome que o ambiente dá ao componente, então ele é infra, ao lado dos ajustes que descrevem o cluster. Em Um agente, um roteador e dois modelos upstream, o desenvolvedor a vincula no Aggregate e escreve o caminho:

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

e a Release dá à mesma vinculação seu host, e afirma que um controlador de ingress é executado no cluster de destino, afirmação sem a qual o build é interrompido, do release.yaml sem seus 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 hospedeiro conforme seu provedor o informa, de modo que o Ingress aponta 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 nomeando o 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.