A sintaxe de ação com chaves duplas

Os pacotes do Helm não são YAML simples. Eles são modelos: YAML comum salpicado com pequenos trechos de lógica que o Helm preenche para você. ✨

Cada diretiva de modelo fica entre duas chaves. O par {{ }} é a passagem do YAML estático para o mecanismo de modelos do Helm.

O que estiver entre as chaves é chamado de ação. O Helm o avalia no momento da renderização e coloca o resultado de volta no YAML.

A ação mais simples apenas imprime algo. Aqui, o Helm substitui a ação pelo nome da versão antes de aplicar o manifesto.

Esse ponto inicial é o contexto: o objeto de nível superior que contém tudo o que o Helm conhece. Você percorre esse objeto com mais pontos, como .Release.Name.

Os espaços dentro das chaves são apenas uma questão de estilo. {{ .Chart.Name }} e {{.Chart.Name}} são renderizados da mesma forma. A convenção do Helm favorece a forma com espaços por questão de legibilidade.

Uma ação que produz um valor é uma ação de expressão. Ela substitui o texto exatamente onde está, sendo perfeita para nomes, etiquetas e rótulos.

Outras ações não imprimem nada. Palavras-chave como if e range controlam o que é renderizado, decidindo se um bloco aparece ou se repete.

Toda essa sintaxe vem do mecanismo text/template do Go. O Helm adiciona funções extras, mas a base {{ }} é puramente Go.

O texto fora das chaves é repassado sem alterações. Somente as ações são avaliadas, portanto a estrutura do YAML permanece intacta após a renderização. 🧱

Execute helm template e observe cada ação desaparecer, substituída pelo valor calculado. Essa saída é exatamente o que chega ao Kubernetes.

Você encontra {{ .Release.Name }} em um modelo de pacote.

Agora você conhece a sintaxe básica: {{ }} marca uma ação, o ponto é o contexto raiz e tudo fora das chaves é renderizado sem alterações. 🎯