Inserindo parciais com template e include
Por que include compõe com pipelines e template não.
Inserindo parciais com template e include é 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.
Chamando um parcial
Um parcial definido não faz nada até ser chamado. O Helm oferece duas ações para isso: modelo e incluir.
A ação modelo
A ação modelo renderiza um parcial nomeado diretamente no local. Você passa o nome do parcial e um objeto de escopo para que ele possa fazer leituras.
{{ template "mychart.labels" . }}Por que modelo é limitado
A ação modelo é uma instrução, não uma expressão. Sua saída vai diretamente para o documento e não pode ser enviada por um canal para outras funções.
Conheça incluir
O Helm acrescenta a função incluir para resolver essa limitação. Ela renderiza os mesmos parciais, mas retorna o resultado como uma cadeia que você pode transformar.
{{ include "mychart.labels" . }}Incluir se combina com fluxos
Como incluir retorna um valor, você pode enviá-lo por um canal para funções como recuo ou recuo com nova linha. É por isso que os gráficos quase sempre preferem incluir.
{{ include "mychart.labels" . | indent 4 }}A indentação é o verdadeiro motivo
O YAML inserido precisa ficar no nível correto de recuo. Somente incluir pode ser enviado por um canal para recuo com nova linha, produzindo sempre uma saída corretamente aninhada.
metadata:
labels:
{{- include "mychart.labels" . | nindent 4 }}O argumento de escopo
O ponto depois do nome do parcial é o escopo que você fornece a ele. Passar o ponto raiz permite que o parcial leia .Values e .Release.
{{ include "mychart.fullname" . }}Um auxiliar que cria um nome
Aqui, um parcial retorna um nome, e uma implantação usa incluir para inseri-lo nos metadados. Uma única fonte de verdade, muitos chamadores.
metadata:
name: {{ include "mychart.fullname" . }}Modelo também tem seu lugar
Você ainda encontra modelo na prática, geralmente em parciais que emitem um bloco completo na própria linha, quando não é necessário usar um canal.
{{ template "mychart.notes" . }}Regra prática
Se a saída precisar de indentação ou de qualquer pós-processamento, use include. Use a ação template simples apenas quando realmente não precisar disso.
Renderize para confirmar
Execute helm template . e verifique se o fragmento foi expandido com a indentação esperada. YAML desalinhado é o erro clássico aqui.
helm template my-release .Verificação rápida
Você precisa renderizar um fragmento e indentá-lo sob uma chave de rótulos. Qual ação funciona?
Recapitulação: template versus include
Ambos chamam fragmentos, mas include retorna uma string que pode passar por um pipe, enquanto template apenas emite conteúdo inline. Prefira include com nindent para obter YAML limpo. ✨
Perguntas Frequentes
A aula “Inserindo parciais com template e include” é grátis?
Sim — o texto completo de “Inserindo parciais com template e include” é 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 “Inserindo parciais com template e include”?
Por que include compõe com pipelines e template não. 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 “Inserindo parciais com template e include”?
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
- Definindo um parcial com define
- Inserindo parciais com template e include
- Os auxiliares padrão Fullname e Labels
- Passando escopo para um modelo nomeado