Insertar parciales con template e include
Por qué include se combina con pipelines y template no
Insertar parciales con template e include es una lección gratuita de Helm Academy en CoddyKit. Esta es la lección 2 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.
Llamar a un parcial
Un parcial definido no hace nada hasta que se lo llama. Helm proporciona dos acciones para hacerlo: template e include.
La acción template
La acción template renderiza un parcial con nombre directamente en línea. Debe pasarle el nombre del parcial y un objeto de ámbito que pueda leer.
{{ template "mychart.labels" . }}Por qué template es limitado
La acción template es una instrucción, no una expresión. Su salida pasa directamente al documento y no se puede enviar por un pipe a otras funciones.
Aparece include
Helm añade la función include para solucionar esa limitación. Renderiza los mismos parciales, pero devuelve el resultado como una cadena que puede transformar.
{{ include "mychart.labels" . }}include se combina con pipelines
Como include devuelve un valor, puede enviarlo por un pipe a funciones como indent o nindent. Por eso los charts casi siempre prefieren include.
{{ include "mychart.labels" . | indent 4 }}La verdadera razón es la indentación
El YAML insertado debe quedar con la indentación correcta. Solo include puede enviarse por un pipe a nindent, por lo que produce una salida correctamente anidada en todo momento.
metadata:
labels:
{{- include "mychart.labels" . | nindent 4 }}El argumento de ámbito
El punto que aparece después del nombre del parcial es el ámbito que se le entrega. Pasar el punto raíz permite al parcial leer .Values y .Release.
{{ include "mychart.fullname" . }}Un helper que construye un nombre
Aquí un parcial devuelve un nombre y un Deployment usa include para insertarlo en los metadatos. Una única fuente de verdad y muchos sitios donde llamarla.
metadata:
name: {{ include "mychart.fullname" . }}template también tiene su lugar
Seguirá viendo template en muchos ejemplos, a menudo para parciales que generan un bloque completo en su propia línea, cuando no hace falta usar un pipe.
{{ template "mychart.notes" . }}Regla práctica
Si el resultado necesita sangría o algún procesamiento posterior, use include. Use la acción de plantilla simple solo cuando realmente no lo necesite.
Renderice para confirmar
Ejecute helm template . y compruebe que la plantilla parcial se expande con la sangría esperada. El YAML desalineado es el error clásico en este caso.
helm template my-release .Comprobación rápida
Necesita renderizar una plantilla parcial y aplicar sangría debajo de una clave labels. ¿Qué acción funciona?
Resumen: template frente a include
Ambas acciones llaman a plantillas parciales, pero include devuelve una cadena que se puede pasar por una tubería, mientras que template solo genera contenido en línea. Prefiera include con nindent para obtener un YAML limpio. ✨
Preguntas frecuentes
¿La lección «Insertar parciales con template e include» es gratis?
Sí — el texto completo de «Insertar parciales con template e include» 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 «Insertar parciales con template e include»?
Por qué include se combina con pipelines y template no 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 2 de 4.
¿Cuánto tiempo toma la lección «Insertar parciales con template e include»?
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