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:
aggrega scaffold --example per-instance-recipe-overrideDepois, imprime os próximos comandos a executar:
cd per-instance-recipe-overrideaggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlUma 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.0Ganha a entrada mais específica:
- a entrada
namepara o nome da instância; - a entrada
typeque nomeia o tipo na versão da instância, comoexample/compute/greeter:1.0.0; - a entrada
typeque nomeia o tipo sem versão; - 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: trueA 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.