Validation de schéma avec values.schema.json
Rejetez les valeurs invalides avant le rendu.
Validation de schéma avec values.schema.json est une leçon Helm Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Helm Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Helm Academy comprend 4 leçons au total.
Protégez vos valeurs
Les utilisateurs peuvent transmettre n’importe quelles valeurs à votre chart. Un fichier values.schema.json vous permet de refuser les entrées incorrectes avant même qu’un seul modèle ne soit restitué. 🚧
Il s’agit de JSON Schema
Le fichier suit le format standard JSON Schema. Vous y décrivez la structure, les types et les champs obligatoires que vos valeurs doivent respecter.
Où il se trouve
Placez values.schema.json à la racine du chart, juste à côté de values.yaml. Helm le détecte automatiquement, sans option supplémentaire.
Un schéma minimal
Chaque schéma commence par un type object et un bloc properties qui décrit chaque valeur acceptée par votre chart.
{
"type": "object",
"properties": {}
}Définir le type d’un champ
Dans properties, vous déclarez le type de chaque champ, par exemple integer pour un nombre de répliques, afin qu’une chaîne soit refusée.
"replicaCount": { "type": "integer" }Rendre des champs obligatoires
Le tableau required répertorie les champs qui doivent être présents. Si vous en omettez un, Helm refuse de restituer le chart.
"required": ["image"]Contraindre les valeurs
Vous pouvez ajouter des limites comme minimum afin qu’un replicaCount inférieur à un soit immédiatement détecté comme invalide.
"replicaCount": { "type": "integer", "minimum": 1 }Limiter à un ensemble
Utilisez enum pour n’autoriser que certaines chaînes, par exemple un type de service égal à ClusterIP, NodePort ou LoadBalancer.
"type": { "enum": ["ClusterIP", "NodePort"] }Quand la validation s’exécute
Helm valide les valeurs par rapport au schéma pendant install, upgrade, template et lint, de sorte que les valeurs incorrectes soient bloquées partout.
Des messages d’échec clairs
Lorsque les valeurs ne respectent pas le schéma, Helm s’arrête et indique précisément quel champ est invalide, ce qui rend les corrections rapides et évidentes.
Error: values don't meet the specifications of the schema(s)Pourquoi c’est important
Un schéma transforme les erreurs de configuration silencieuses en erreurs visibles et précoces, protégeant les utilisateurs de votre chart contre les surprises en production.
Vérification rapide
Vous voulez qu’un paquet refuse une installation lorsque la valeur de l’image est absente. Qu’utilisez-vous ?
Récapitulatif
Vous avez appris que values.schema.json valide les entrées utilisateur avec JSON Schema, en utilisant type, required, minimum et enum pour bloquer rapidement les valeurs incorrectes. 🎉
Questions Fréquemment Posées
La leçon « Validation de schéma avec values.schema.json » est-elle gratuite ?
Oui — le texte complet de « Validation de schéma avec values.schema.json » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Helm Academy, passe à CoddyKit PRO. Le cours Helm Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Validation de schéma avec values.schema.json » ?
Rejetez les valeurs invalides avant le rendu. Tu pratiques Helm Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Helm Academy ?
Aucune expérience préalable n'est requise. Helm Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Validation de schéma avec values.schema.json » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Helm Academy ?
Oui. Chaque leçon Helm Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Vérifications statiques avec helm lint
- Vérifier la sortie avec helm template
- Écrire des cas de test helm
- Validation de schéma avec values.schema.json