Definindo um parcial com define
Declare um bloco de modelo nomeado e reutilizável.
Definindo um parcial com define é uma aula grátis de Helm Academy no CoddyKit. Esta é a aula 1 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.
Por que repetir?
Os mesmos rótulos e nomes são copiados para cada manifesto de um gráfico. Um modelo nomeado permite escrever esse bloco uma vez e reutilizá-lo em todos os lugares.
Conheça a ação definir
Você declara um bloco reutilizável com a ação definir. Ela dá nome a um trecho de texto do modelo, mas não renderiza nada por conta própria.
{{- define "mychart.labels" -}}
app: my-app
{{- end -}}Anatomia de um bloco definir
Cada definir começa com uma cadeia de caracteres de nome e termina com fim. Tudo que fica entre os dois é o corpo que os chamadores importarão.
{{- define "NAME" -}}
...body...
{{- end -}}As convenções de nomenclatura são importantes
Os nomes são globais em todo o gráfico, portanto prefixe-os com o nome do gráfico para evitar conflitos. O formato com pontos chart.purpose é a convenção.
{{- define "mychart.selectorLabels" -}}
app.kubernetes.io/name: mychart
{{- end -}}Onde ficam os parciais
Por convenção, todos os seus blocos definir ficam em templates/_helpers.tpl. O sublinhado inicial informa ao Helm que esse arquivo não emite um manifesto próprio.
Arquivos com sublinhado são especiais
Arquivos em templates que começam com um sublinhado nunca são renderizados em objetos do Kubernetes. Eles contêm apenas parciais e auxiliares para uso de outros arquivos.
Definir não produz saída
Definir um parcial apenas o registra pelo nome. Nada aparece no YAML renderizado até que outro modelo realmente chame esse parcial.
Um parcial pode usar o ponto
Dentro de um parcial, você pode ler contextos como .Release.Name, mas somente se o chamador passar esse escopo. Em breve, veremos como passar o escopo.
{{- define "mychart.name" -}}
{{ .Release.Name }}
{{- end -}}Muitos parciais, um arquivo
Você pode empilhar quantos blocos definir quiser em _helpers.tpl. Agrupe auxiliares relacionados para manter o arquivo fácil de consultar.
{{- define "mychart.name" -}}
my-app
{{- end -}}
{{- define "mychart.fullname" -}}
my-app-prod
{{- end -}}Parciais criam gráficos maiores
À medida que um gráfico cresce, os parciais mantêm os rótulos e nomes duplicados sincronizados. Altere o auxiliar uma vez e todos os manifestos que o utilizam serão atualizados juntos.
Definir é apenas metade do trabalho
Um bloco definir sozinho é inerte. A próxima etapa é inseri-lo em manifestos reais com incluir ou modelo, assunto da próxima lição.
Verificação rápida
Você adicionou um bloco definir, mas a saída renderizada está vazia. Por quê?
Recapitulação: definindo parciais
Você aprendeu a declarar blocos reutilizáveis com definir, nomeá-los como chart.purpose e armazená-los em _helpers.tpl. Em seguida, você os chamará. 🧩
Perguntas Frequentes
A aula “Definindo um parcial com define” é grátis?
Sim — o texto completo de “Definindo um parcial com define” é 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 “Definindo um parcial com define”?
Declare um bloco de modelo nomeado e reutilizável. 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 1 de 4.
Quanto tempo leva a aula “Definindo um parcial com define”?
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