Declaración de un tipo de chart de biblioteca
Configure el tipo como library y conozca lo que esto prohíbe.
Declaración de un tipo de chart de biblioteca 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.
Dos tipos de chart
Todo chart de Helm declara un type en Chart.yaml. El valor predeterminado es application, pero existe un segundo tipo dedicado exclusivamente a compartir lógica de templates.
# Chart.yaml
apiVersion: v2
name: my-app
type: applicationConocer el chart de biblioteca
Establezca type: library y el chart dejará de ser algo que se instala. Se convertirá en una caja de herramientas de templates con nombre que otros charts pueden reutilizar.
# Chart.yaml
apiVersion: v2
name: common
version: 0.1.0
type: libraryLos charts de biblioteca no generan nada
Un chart de biblioteca no produce objetos de Kubernetes por sí mismo. Solo define templates que los charts que lo consumen invocan durante el renderizado.
No puede instalarlo
Ejecutar helm install en un chart de biblioteca falla. No hay nada que desplegar, por lo que Helm rechaza el comando deliberadamente.
helm install c ./common
# Error: library charts are not installableSin salida de templates de nivel superior
Los archivos de la carpeta templates de un chart de biblioteca no se renderizan como manifiestos. Solo deben definir parciales; nunca deben generar YAML directamente.
La convención del guion bajo
Helm omite los archivos de templates cuyo nombre comienza con un guion bajo. Los archivos de templates de las bibliotecas usan nombres como _deployment.tpl para no renderizarse.
common/
Chart.yaml
templates/
_deployment.tplapiVersion v2 es obligatorio
Los charts de biblioteca solo existen con apiVersion: v2. Los charts v1 de la época de Helm 2 no tenían ningún concepto de tipo de biblioteca.
# Chart.yaml
apiVersion: v2
type: libraryVersionado como cualquier chart
Una biblioteca también necesita un campo version para que los consumidores puedan fijar una versión. Trátela como un artefacto de lanzamiento real, no como una carpeta suelta.
# Chart.yaml
name: common
version: 1.2.0
type: libraryPor qué usar un tipo de biblioteca
En lugar de copiar el mismo YAML de Deployment en diez charts, lo escribe una sola vez en una biblioteca y permite que todos los charts lo incorporen.
Bitnami Common es el ejemplo clásico
El chart bitnami/common, ampliamente utilizado, es una biblioteca. Cientos de charts dependen de él para obtener helpers compartidos de etiquetas, nombres e imágenes.
Application y library, lado a lado
Un chart de tipo application despliega cargas de trabajo; uno de tipo library solo proporciona templates. El único campo type determina cómo lo trata Helm.
type: application # installs resources
type: library # shares templatesComprobación rápida
Ha establecido type: library en Chart.yaml. ¿Qué ocurre cuando ejecuta helm install sobre él?
Resumen: el tipo de chart de biblioteca
Un chart type: library no genera nada y no se puede instalar. Solo existe para empaquetar templates con nombre que otros charts reutilizan. 📦
Preguntas frecuentes
¿La lección «Declaración de un tipo de chart de biblioteca» es gratis?
Sí — el texto completo de «Declaración de un tipo de chart de biblioteca» 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 «Declaración de un tipo de chart de biblioteca»?
Configure el tipo como library y conozca lo que esto prohíbe. 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 «Declaración de un tipo de chart de biblioteca»?
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
- Declaración de un tipo de chart de biblioteca
- Exportación de plantillas con nombre reutilizables
- Uso de una biblioteca como dependencia
- Sobrescritura local de valores predeterminados de biblioteca