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:
aggrega scaffold --example per-instance-recipe-overrideEm seguida ele 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. 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.0Vence 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 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: trueA 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.