Definir un parcial con define
Declare un bloque de plantilla con nombre reutilizable
Definir un parcial con define es una lección gratuita de Helm Academy en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Helm Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Helm Academy incluye 4 lecciones en total.
¿Por qué repetir el trabajo?
Las mismas etiquetas y nombres se copian en todos los manifiestos de un chart. Una plantilla con nombre permite escribir ese bloque una vez y reutilizarlo en todas partes.
Conocer la acción define
Puede declarar un bloque reutilizable con la acción define. Esta asigna un nombre a un fragmento de texto de plantilla, pero no lo renderiza por sí sola.
{{- define "mychart.labels" -}}
app: my-app
{{- end -}}Anatomía de un bloque define
Cada define comienza con una cadena de nombre y termina con end. Todo lo que queda entre ambos es el cuerpo que incorporarán quienes lo llamen.
{{- define "NAME" -}}
...body...
{{- end -}}Las convenciones de nombres importan
Los nombres son globales en todo el chart, así que debe anteponerles el nombre del chart para evitar conflictos. El formato con puntos chart.purpose es la convención.
{{- define "mychart.selectorLabels" -}}
app.kubernetes.io/name: mychart
{{- end -}}Dónde viven los parciales
Por convención, todos los bloques define se colocan en templates/_helpers.tpl. El guion bajo inicial indica a Helm que este archivo no genera ningún manifiesto por sí mismo.
Los archivos con guion bajo son especiales
Los archivos de templates cuyo nombre comienza con un guion bajo nunca se renderizan como objetos de Kubernetes. Solo contienen parciales y helpers para que otros los utilicen.
define no produce ninguna salida
Definir un parcial solo lo registra por su nombre. No aparece nada en el YAML renderizado hasta que otra plantilla realmente llama a ese parcial.
Un parcial puede usar el punto
Dentro de un parcial puede leer contextos como .Release.Name, pero solo si quien lo llama le pasa ese ámbito. Pronto veremos cómo pasar el ámbito.
{{- define "mychart.name" -}}
{{ .Release.Name }}
{{- end -}}Muchos parciales, un solo archivo
Puede incluir tantos bloques define como quiera en _helpers.tpl. Agrupe los helpers relacionados para que el archivo sea fácil de revisar.
{{- define "mychart.name" -}}
my-app
{{- end -}}
{{- define "mychart.fullname" -}}
my-app-prod
{{- end -}}Los parciales permiten crear charts más grandes
A medida que crece un chart, los parciales mantienen sincronizados los nombres y las etiquetas duplicados. Cambie el helper una sola vez y se actualizarán todos los manifiestos que lo utilicen.
Definir es solo la mitad del trabajo
Un define por sí solo no hace nada. El siguiente paso es insertarlo en manifiestos reales con include o template, lo que se explica en la próxima lección.
Comprobación rápida
Ha añadido un bloque define, pero la salida renderizada está vacía. ¿Por qué?
Repaso: definir parciales
Ha aprendido a declarar bloques reutilizables con define, asignarles nombres como chart.purpose y almacenarlos en _helpers.tpl. A continuación, aprenderá a llamarlos. 🧩
Preguntas frecuentes
¿La lección «Definir un parcial con define» es gratis?
Sí — el texto completo de «Definir un parcial con define» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Helm Academy, actualiza a CoddyKit PRO. El curso de Helm Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Definir un parcial con define»?
Declare un bloque de plantilla con nombre reutilizable Practicas Helm Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Helm Academy?
No se requiere experiencia previa. Helm Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «Definir un parcial con define»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Helm Academy?
Sí. Cada lección de Helm Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Definir un parcial con define
- Insertar parciales con template e include
- Helpers estándar de nombres completos y etiquetas
- Pasar el ámbito a una plantilla con nombre