Files, Template y el contexto raíz
Acceda a archivos incluidos y al ámbito del punto
Files, Template y el contexto raíz es una lección gratuita de Helm Academy en CoddyKit. Esta es la lección 4 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.
El contexto raíz: el punto
En la parte superior de una plantilla, el punto . es el contexto raíz que contiene todos los objetos integrados: .Values, .Release, .Chart y otros.
El punto puede cambiar de ámbito
Los bloques como with y range vuelven a vincular el punto a un valor más específico. Por eso, . no siempre representa la raíz dentro de cada bloque.
Volver a la raíz con el signo de dólar
La variable $ siempre apunta al contexto raíz original. Dentro de un range o un with, use $ para volver a .Values o .Release.
{{ range .Values.ports }}
release: {{ $.Release.Name }}
{{ end }}El objeto Files
.Files permite que las plantillas lean archivos que no son plantillas y que están incluidos en el chart, como un archivo de configuración que quiera incluir en un ConfigMap. 📄
Leer un archivo como texto
.Files.Get devuelve el contenido de un archivo como cadena. Pase la ruta relativa a la raíz del chart para incorporarlo a su manifiesto.
data:
app.conf: |
{{ .Files.Get "config/app.conf" | indent 4 }}Files tiene limitaciones
.Files no puede leerlo todo: templates/ y Chart.yaml están excluidos, y los patrones de .helmignore se omiten durante el empaquetado.
Buscar varios archivos con patrones
.Files.Glob busca varios archivos mediante un patrón y devuelve un mapa que puede recorrer con range para crear muchas entradas de ConfigMap a la vez.
{{ range $path, $bytes := .Files.Glob "config/*" }}...{{ end }}Codificar el contenido de los archivos
Los datos binarios o secretos deben codificarse en base64. Encadene .Files.Get con b64enc para incrustarlos de forma segura en un recurso Secret.
ca.crt: {{ .Files.Get "certs/ca.crt" | b64enc }}El objeto Template
El objeto .Template describe el archivo que se está renderizando. .Template.Name es su ruta, útil en comentarios y mensajes de error.
# rendered from {{ .Template.Name }}BasePath apunta a templates
.Template.BasePath proporciona la ruta del directorio templates del chart que se está renderizando. Se combina con .Template.Name para localizarse.
Pasar la raíz a los helpers
Las plantillas con nombre solo ven el contexto que se les entrega. Pasar $ o el punto raíz garantiza que un helper pueda seguir accediendo a .Values y .Release.
{{ include "mychart.labels" $ }}Comprobación rápida
Se encuentra dentro de un bucle de rango en el que el punto se ha reasignado al elemento de una lista.
Repaso: archivos y contexto raíz
Ha aprendido que el punto es el contexto raíz, que $ siempre permite acceder a él, y que .Files y .Template permiten insertar archivos incluidos y localizar la plantilla actual.
Preguntas frecuentes
¿La lección «Files, Template y el contexto raíz» es gratis?
Sí — el texto completo de «Files, Template y el contexto raíz» 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 «Files, Template y el contexto raíz»?
Acceda a archivos incluidos y al ámbito del punto 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 4 de 4.
¿Cuánto tiempo toma la lección «Files, Template y el contexto raíz»?
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
- El objeto Values y el acceso anidado
- Metadatos del release mediante .Release
- Objetos Chart y Capabilities
- Files, Template y el contexto raíz