Comentários e aspas em modelos

Um pacote tem duas maneiras de deixar observações: comentários YAML comuns e comentários de modelo especiais. Eles se comportam de maneiras muito diferentes no momento da renderização.

Uma linha que começa com uma cerquilha é um comentário YAML comum. Ela passa diretamente e permanece na saída renderizada para que qualquer pessoa possa lê-la.

O Helm tem seu próprio tipo de comentário, que desaparece por completo. Envolva o texto em {{/* */}}, e o mecanismo o removerá antes da saída.

Use uma cerquilha para documentar o YAML implantado. Use um comentário de modelo para observações sobre a lógica do modelo que os usuários nunca devem ver. 📝

Comentários de modelos são úteis para desativar código. Envolva uma ação em {{/* */}} e o Helm a ignorará: sem renderização, sem erros.

O YAML frequentemente deduz tipos. O valor 1.10 pode virar 1.1, e yes pode se transformar em true. Uso de aspas força um texto limpo.

O Helm inclui uma função quote que envolve um valor em aspas duplas para você, de modo que o campo renderizado seja inequivocamente um texto.

Você normalmente verá quote escrito como um operador de canal no final de uma ação. A leitura é natural: pegue o valor e depois coloque-o entre aspas.

Sem aspas, uma versão como 1.20 pode perder silenciosamente o zero final e virar 1.2, quebrando a referência da imagem. As aspas evitam isso. ⚠️

O Kubernetes às vezes quer que um número seja mantido como texto, como uma porta em uma anotação. Passá-lo por quote o mantém com segurança como texto.

Você também pode escrever aspas literais diretamente no YAML. A função quote apenas faz isso programaticamente quando o valor vem de um modelo.

Você adiciona uma observação que não deve aparecer no YAML implantado.

Agora você pode ocultar observações com {{/* */}}, manter visíveis as que usam uma cerquilha e forçar textos limpos usando a função quote. 🎯