Percorrendo listas e mapas com range

Quando um valor contém uma lista, raramente você quer digitar cada entrada manualmente. A ação range percorre uma coleção e renderiza YAML para cada item.

Um laço começa com {{ range SOMETHING }} e termina com {{ end }}. O bloco entre eles é renderizado uma vez para cada elemento da coleção. 🔁

Dentro de um range, o ponto é vinculado novamente ao elemento atual, não à raiz. Assim, {{ . }} imprime o item que está sendo processado nesta passagem.

Dada uma lista de strings, range emite uma linha de YAML para cada valor. O resultado é uma lista limpa e de tamanho dinâmico, controlada inteiramente pelos valores.

Precisa também da posição? Capture ambos com duas variáveis. Em cada passagem, range fornece primeiro o índice e depois o valor.

Percorra um mapa com range e as duas variáveis se tornarão a chave e o valor. Isso é perfeito para transformar um mapa de valores em rótulos ou variáveis de ambiente.

O Helm percorre as chaves do mapa em ordem alfabética, não na ordem de inserção. Isso mantém a saída renderizada estável e facilita as diferenças entre execuções.

Como o ponto agora é o item, .Values fica inacessível dentro do laço. Capture primeiro a raiz com $ para continuar lendo-a.

Se a coleção estiver vazia, range simplesmente não produzirá saída e ignorará seu bloco. Sem itens, não há corpo de laço, exatamente como você deseja.

Cada passagem precisa estar alinhada sob a chave pai. Os laços costumam ser combinados com o auxiliar indent para que o YAML repetido fique na profundidade correta. 🧱

Aninhe um if dentro de um range para filtrar enquanto percorre a coleção. Apenas os itens que passarem na condição renderizarão seu bloco; os demais serão ignorados.

Você percorre uma lista de strings com {{ range .Values.hosts }}.

Agora você pode percorrer coleções com range, ler itens por meio do ponto reatribuído, obter o índice ou a chave e acessar a raiz com $. A repetição está sob controle! 🎯