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

Quando recorrer a uma etapa de pipeline

Uma FeatureRecipe oferece a você duas formas de moldar a saída com que uma Feature contribui: uma FeatureRecipe baseada em templates que gera os seus próprios documentos, e uma etapa de pipeline (pipeline:) que executa um plugin Wasm sobre a saída renderizada. Elas resolvem problemas diferentes. Esta página é o guia de decisão: recorra a uma etapa de pipeline diante de exatamente dois gatilhos, e use uma FeatureRecipe baseada em templates para todo o resto.

As duas ferramentas

Uma FeatureRecipe baseada em templates é local e generativa. Ela produz os seus próprios documentos a partir dos seus próprios valores por meio de um template Go — o ConfigMap de um sidecar, um CRD de política, um objeto de autoescalonamento. Tudo o que ela emite é função dos values: e infra: da Feature e do contexto de renderização entregue aos seus templates. Ela nunca entra na saída de outra entidade; adiciona documentos próprios. Se o que você precisa produzir pode ser escrito a partir do que a Feature já sabe, uma FeatureRecipe baseada em templates é a ferramenta certa e mais simples — sem plugin, sem pipeline.

Uma etapa de pipeline é global e transformadora. Ela é executada depois da renderização, sobre o conjunto real de documentos que o build já emitiu. O host entrega à etapa esse conjunto de documentos indexado por chave, inteiro; a etapa lê o conteúdo real, seleciona os documentos que tem como alvo e retorna patches RFC 6902 precisos para a estrutura deles — ou emite novos documentos como efeitos colaterais. Uma etapa raciocina sobre o que foi renderizado, não apenas sobre o que a Feature declarou. Esse alcance é toda a sua razão de existir, e é também o motivo pelo qual você a usa com moderação.

Os dois gatilhos para uma etapa de pipeline

Recorra a uma etapa de pipeline apenas quando um destes casos se aplicar. Se nenhum se aplicar, gere o documento com uma FeatureRecipe baseada em templates.

  1. Patch no escopo do host — você precisa entrar na estrutura de outra entidade já renderizada. O caso clássico é injetar uma variável de ambiente, uma montagem de volume ou um contêiner sidecar na carga de trabalho do componente consumidor — um documento que a própria Feature não escreveu. Uma FeatureRecipe baseada em templates não consegue fazer isso: ela produz os seus próprios documentos, não edita os de outro. Uma etapa de pipeline consegue, porque opera sobre o conjunto renderizado e pode endereçar por chave os documentos do componente host.

  2. Emissão ou patch dependente do conteúdo — a saída depende do que o conjunto renderizado contém. Quando o recurso que você emite, ou o patch que você aplica, é função do conteúdo que o build produziu — as portas reais que um Deployment declarou, os nomes de contêiner que acabaram no manifesto, os recursos em que um chart se expandiu — a decisão precisa do conteúdo renderizado em mãos. Uma FeatureRecipe baseada em templates renderiza a partir dos valores próprios da Feature e nunca vê o conjunto final, de modo que não pode fazer uma escolha dependente do conteúdo; uma etapa de pipeline primeiro lê o conteúdo e depois age.

Os dois gatilhos compartilham uma forma: precisam de informações que só existem depois da renderização — a estrutura de outra entidade, ou o próprio conteúdo emitido. A geração local nunca precisa disso, então a geração local nunca precisa de uma etapa de pipeline.

Uma etapa transforma; uma política valida

Uma etapa de pipeline é um transformador: ela altera o conjunto renderizado. Não é o lugar para verificar se um resultado é aceitável. Para validar um build — para afirmar que uma carga de trabalho com patch tem o sidecar, que nenhum segredo em texto puro chegou à saída, que um rótulo obrigatório está presente — vincule uma política da etapa de renderização: um plugin de governança no papel render-verdict, que é executado depois da renderização sobre os artefatos emitidos e retorna um veredito. Um veredito halt interrompe o build; um veredito warn ou info avisa sem bloquear.

Mantenha os dois separados. Não coloque lógica de validação em uma etapa de pipeline, e não recorra a uma política para modificar a saída — um plugin de governança vinculado a um papel de veredito retorna vereditos e nunca aplica patches, e o host lê a saída de um papel de veredito apenas como uma decisão. Uma etapa molda a saída; uma política render-verdict a julga. A página do socket de governança aborda os quatro papéis de governança e as severidades dos vereditos.

As etapas se compõem

Uma etapa de pipeline pode declarar um contrato tipado de entrada e saída, de modo que a sua entrada with: e as saídas que retorna sejam formas validadas em vez de blobs livres. Uma etapa também retorna outputs nomeadas, e uma etapa declarada mais adiante no mesmo pipeline lê as saídas de uma etapa anterior a partir do seu próprio template with: como .steps.<id>.outputs.<key>. É assim que um padrão de duas partes se compõe sem acoplamento: uma etapa Fetcher emite um recurso de credenciais e publica o nome do Secret resultante como saída; uma etapa Injector lê esse nome e aplica um patch na carga de trabalho consumidora para montá-lo. Cada etapa cuida de uma única preocupação, e o pipeline encadeia as saídas delas na ordem declarada.

Referências cruzadas