Barreiras de lint e de modelos na CI

Um gráfico com problemas deve fazer seu fluxo de integração falhar, não seu cluster de produção. Os controles de CI permitem rejeitar gráficos inválidos assim que uma solicitação de alteração é aberta. 🛡️

O comando helm lint executa verificações estáticas em um gráfico: verifica a estrutura, os campos obrigatórios e problemas comuns de boas práticas sem tocar em nenhum cluster.

O lint sinaliza um campo ausente de Chart.yaml, um modelo que não pode ser analisado ou um ícone que não é uma URL. Ele é rápido e não precisa de uma conexão com o Kubernetes.

Adicione --strict para que os avisos do lint também façam a execução falhar. Na CI, você quer que a compilação fique vermelha diante de qualquer coisa questionável, não um aviso silencioso que ninguém lê.

Passe -f para executar o lint usando os valores que um lançamento realmente usará. Um gráfico pode ser válido sem valores e ainda assim falhar quando seus valores de produção forem mesclados.

Depois que o lint passar, execute helm template para renderizar todos os manifestos localmente. Se a criação dos modelos falhar, o fluxo de integração para antes que qualquer coisa chegue ao Kubernetes.

O lint é superficial; helm template avalia completamente a lógica dos seus modelos Go. Um erro de digitação em um range ou um valor nulo aparece aqui, não no momento da implantação.

Ambos os comandos retornam um código de saída diferente de zero em caso de falha. Os executores de CI leem esse código automaticamente e marcam o trabalho como falho, bloqueando a mesclagem.

Envie a saída renderizada para kubeval ou kubeconform para confirmar que ela corresponde aos esquemas reais do Kubernetes. Isso detecta antecipadamente um nome de campo incorreto.

Encadeie os controles em um único trabalho para que uma falha interrompa o restante. Na maioria dos executores, && interrompe na primeira saída diferente de zero, mantendo o retorno rápido.

Acione essas verificações em cada solicitação de alteração, não apenas durante a mesclagem. Os revisores veem uma verificação verde que comprova que o gráfico continua sendo renderizado corretamente.

Qual controle avalia completamente sua lógica de modelos Go para detectar uma expressão de range incorreta?

Faça uma verificação de cada alteração com helm lint --strict e depois helm template, verificando opcionalmente o esquema da saída. Gráficos inválidos fazem a compilação falhar, nunca o cluster. ✅