tpl: renderizando textos a partir de valores
Avaliando expressões de modelo armazenadas em valores
tpl: renderizando textos a partir de valores é uma aula grátis de Helm Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Helm Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Helm Academy inclui 4 aulas no total.
Modelos dentro de values
Às vezes, um valor no próprio values.yaml contém sintaxe de modelo. Por padrão, o Helm o trata como uma cadeia de caracteres simples e nunca o avalia.
Conheça a função tpl
A função tpl recebe uma cadeia de caracteres e um contexto, depois renderiza essa cadeia como um modelo Go exatamente no ponto em que você a chama.
{{ tpl .Values.greeting . }}Ela precisa de um contexto
O segundo argumento de tpl é o escopo usado durante a renderização. Passar o ponto raiz permite que a cadeia acesse Values e Release.
{{ tpl "Hello {{ .Release.Name }}" . }}Um valor com modelo
Agora, um usuário pode armazenar uma cadeia dinâmica em values, como um nome de host criado a partir do nome da versão, e fazer com que ela seja expandida durante a renderização.
host: "{{ .Release.Name }}.example.com"Renderizando esse valor
No seu modelo, passe esse campo por tpl com o contexto raiz para transformar o marcador armazenado em um valor real.
host: {{ tpl .Values.host . | quote }}Por que não apenas referenciá-lo
Uma referência direta exibe as chaves brutas como texto. Somente tpl realmente avalia as diretivas incorporadas na cadeia armazenada.
Renderizando arquivos também
Você também pode fornecer o conteúdo de arquivos ao tpl, permitindo que um arquivo de configuração incluído contenha marcadores específicos da versão.
{{ tpl (.Files.Get "config.tpl") . }}Passando um escopo personalizado
O contexto não precisa ser a raiz. Passe qualquer dict para que a cadeia renderizada veja exatamente as variáveis escolhidas por você.
{{ tpl .Values.msg (dict "name" "api") }}Um caso de uso real
Os pacotes frequentemente permitem criar modelos para hosts ou anotações de ingress dessa maneira, mantendo a configuração flexível em values em vez de nos modelos.
Cuidado com os erros
Se o texto armazenado tiver um erro de digitação, o tpl falhará durante a renderização. Portanto, execute helm template depois de adicionar valores modelados.
Combine com quote
Como um host modelado pode conter pontos ou dois-pontos, passe o resultado de tpl por quote para que o valor final de YAML continue sendo um texto seguro.
host: {{ tpl .Values.host . | quote }}Verificação rápida
Faça uma verificação rápida do comportamento de tpl.
Recapitulação
Você aprendeu que tpl avalia textos de modelo armazenados em values ou arquivos, usando um contexto fornecido por você, como o ponto raiz. 🎉
Perguntas Frequentes
A aula “tpl: renderizando textos a partir de valores” é grátis?
Sim — o texto completo de “tpl: renderizando textos a partir de valores” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Helm Academy, atualize para CoddyKit PRO. O curso de Helm Academy inclui 4 aulas no total.
O que vou aprender em “tpl: renderizando textos a partir de valores”?
Avaliando expressões de modelo armazenadas em valores Você pratica Helm Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Helm Academy?
Nenhuma experiência prévia é necessária. Helm Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.
Quanto tempo leva a aula “tpl: renderizando textos a partir de valores”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Helm Academy?
Sim. Cada aula de Helm Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Mesclagem profunda com mergeOverwrite e dict
- tpl: renderizando textos a partir de valores
- Percorrendo arquivos com range sobre .Files.Glob
- fail e proteções de validação personalizadas