Definindo o escopo de um bloco com with

Digitar .Values.image.repository repetidamente fica trabalhoso. A ação with restringe o ponto a uma subárvore para que você possa escrever caminhos mais curtos.

Um bloco with começa com {{ with SOMETHING }} e termina com {{ end }}. Dentro dele, o ponto é redefinido para o que você passou.

Uma vez dentro do bloco, .repository significa .Values.image.repository. A palavra-chave with vincula novamente o ponto à subárvore, encurtando todos os caminhos abaixo dela.

Se o valor estiver vazio ou ausente, with ignorará todo o bloco. Assim, ele restringe o ponto e também funciona como um if ao mesmo tempo. 🛡️

Assim como if, with aceita um ramo else. O else é renderizado quando o valor está vazio, oferecendo uma alternativa organizada para configurações opcionais.

Aqui está a armadilha: dentro de with, o ponto deixa de ser a raiz. Portanto, .Release.Name falha, pois Release não existe nessa subárvore.

Para usar valores da raiz dentro de with, prefixe-os com $. O cifrão sempre aponta para o contexto raiz original, independentemente da profundidade.

Como with altera o ponto, blocos grandes ficam confusos rapidamente. Mantenha as seções with curtas para que fique sempre claro para onde o ponto aponta.

Use if quando quiser apenas testar um sinalizador e use with quando também quiser entrar nesse valor. with altera o ponto; if o mantém.

Não tem certeza do que o ponto contém? Renderize com helm template e leia a saída, ou imprima o escopo ao depurar um bloco with complicado.

Você pode aninhar um with dentro de outro para se aprofundar. Cada nível move o ponto um passo adiante, portanto acompanhe onde você está.

Dentro de um bloco {{ with .Values.image }}, você tenta ler .Release.Name, mas ele está vazio.

Agora você sabe definir o escopo do ponto com with, obter uma proteção automática contra valores vazios, adicionar uma alternativa else e alcançar a raiz com $. Modelos mais limpos! 🎯