nindent versus indent na prática

YAML usa espaços para mostrar a estrutura, portanto um bloco inserido na profundidade errada invalida o arquivo. O Helm oferece auxiliares para aplicar indent corretamente à saída.

A função indent adiciona um número fixo de espaços ao início de cada linha de uma cadeia de caracteres, deslocando um bloco inteiro para a direita.

Aqui está o detalhe: indent desloca todas as linhas, mas não adiciona uma nova linha inicial. A primeira linha fica exatamente onde a ação está.

A função nindent aplica o mesmo espaçamento, mas primeiro imprime uma nova linha, fazendo o bloco começar claramente em sua própria linha.

Essa nova linha inicial de nindent significa que você não precisa deixar um espaço no final nem adivinhar o alinhamento depois de uma chave na mesma linha.

Você recorrerá a nindent principalmente ao colocar um bloco toYaml sob uma chave, pois ele posiciona o mapa renderizado de forma organizada abaixo dela.

Escolha o número contando os espaços a partir da chave pai, não da coluna zero. Um filho com dois níveis de profundidade geralmente precisa de nindent 4.

O indent simples é adequado quando o bloco já começa em sua própria linha, portanto você não quer inserir uma nova linha extra antes dele.

A maioria das estruturas YAML avança em passos de dois espaços. Errar por dois na contagem de nindent é a principal causa de um gráfico que não pode ser analisado.

Nunca adivinhe a profundidade. Execute helm template e leia a saída bruta para confirmar que as linhas do bloco inserido estão alinhadas abaixo da chave pai.

Ambos os auxiliares leem a cadeia de caracteres do encadeamento à esquerda, portanto combinam naturalmente com toYaml para formatar um mapa inteiro no manifesto.

Você escreve {{ toYaml .Values.env | indent 4 }} logo após uma chave na mesma linha, e o YAML fica malformado.

Agora você sabe que indent aplica espaços a um bloco, que nindent adiciona primeiro uma nova linha e que renderizar é a maneira mais segura de confirmar a profundidade. 🧹