Validación de esquema con values.schema.json
Rechace valores no válidos antes del renderizado
Validación de esquema con values.schema.json 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.
Proteja sus valores
Los usuarios pueden pasar cualquier valor a su chart. Un archivo values.schema.json le permite rechazar entradas no válidas antes de renderizar una sola plantilla. 🚧
Es un JSON Schema
El archivo sigue el formato estándar JSON Schema. En él describe la estructura, los tipos y los campos obligatorios que deben tener sus valores.
Dónde se encuentra
Coloque values.schema.json en la raíz del chart, justo al lado de values.yaml. Helm lo detecta automáticamente sin opciones adicionales.
Un esquema mínimo
Todo esquema comienza con un tipo object y un bloque properties que describe cada valor que acepta su chart.
{
"type": "object",
"properties": {}
}Especifique el tipo de un campo
Dentro de properties, declare el type de cada campo, como integer para un número de réplicas, de modo que se rechace una cadena.
"replicaCount": { "type": "integer" }Marque los campos obligatorios
La matriz required enumera los campos que deben estar presentes. Si omite uno, Helm se niega a renderizar el chart.
"required": ["image"]Restrinja los valores
Puede añadir límites como minimum para detectar inmediatamente como no válido un replicaCount menor que uno.
"replicaCount": { "type": "integer", "minimum": 1 }Restrinja a un conjunto
Utilice enum para permitir solo cadenas específicas, como un tipo de servicio ClusterIP, NodePort o LoadBalancer.
"type": { "enum": ["ClusterIP", "NodePort"] }Cuándo se ejecuta la validación
Helm valida con el esquema durante install, upgrade, template y lint, de modo que los valores incorrectos se bloquean en todos los casos.
Mensajes de error claros
Cuando los valores infringen el esquema, Helm se detiene e indica exactamente qué campo es no válido, lo que hace que las correcciones sean rápidas y evidentes.
Error: values don't meet the specifications of the schema(s)Por qué es importante
Un esquema convierte las configuraciones incorrectas silenciosas en errores claros y tempranos, protegiendo a los usuarios de su chart de sorpresas en producción.
Comprobación rápida
Quiere que un chart rechace una instalación cuando falta el valor de la imagen. ¿Qué debe usar?
Repaso
Ha aprendido que values.schema.json valida la entrada del usuario con JSON Schema y usa type, required, minimum y enum para bloquear los valores incorrectos desde el principio. 🎉
Preguntas frecuentes
¿La lección «Validación de esquema con values.schema.json» es gratis?
Sí — el texto completo de «Validación de esquema con values.schema.json» 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 «Validación de esquema con values.schema.json»?
Rechace valores no válidos antes del renderizado 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 «Validación de esquema con values.schema.json»?
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
- Comprobaciones estáticas con helm lint
- Verificar la salida con helm template
- Escribir casos de prueba con helm test
- Validación de esquema con values.schema.json