Validateur YAML
Vérifiez la syntaxe YAML pour détecter les erreurs, les clés en double et d’autres problèmes, chacun étant indiqué avec sa ligne et sa colonne. L’outil s’exécute dans votre navigateur.
Entrée
Sortie
Documentation
Que vérifie le validateur YAML ?
YAML est le format de nombreux fichiers de configuration : fichiers Docker Compose, manifestes Kubernetes, workflows GitHub Actions et GitLab CI, playbooks Ansible, spécifications OpenAPI et paramètres d’innombrables applications. Comme l’indentation a une signification en YAML, un espace manquant, une tabulation isolée ou une clé répétée peut rendre un fichier inutilisable d’une manière difficile à repérer. Le validateur lit votre YAML comme le ferait un analyseur syntaxique et répertorie chaque problème avec son numéro de ligne et de colonne.
Comment l’utiliser
- Collez ou saisissez du YAML dans l’éditeur.
- Le résultat s’affiche au fur et à mesure de votre saisie : soit le YAML est valide, avec le nombre de documents qu’il contient, soit tous les problèmes sont répertoriés dans l’ordre du texte.
- Chaque problème est signalé dans l’éditeur : les erreurs en rouge et les avertissements en jaune. Cliquez sur un problème pour faire défiler l’éditeur jusqu’à celui-ci, ou cliquez sur un repère pour le retrouver dans la liste.
Ce qu’il détecte
- Erreurs de syntaxe : guillemets et crochets non fermés, éléments trop ou pas assez indentés, clé et élément de liste mélangés au même niveau, mappings imbriqués sur une seule ligne, comme
a: b: c. - Clés répétées : la même clé apparaît deux fois dans un mapping. La plupart des analyseurs syntaxiques n’en conserveraient silencieusement qu’une seule valeur, ce qui ferait perdre l’autre paramètre.
- Tabulations utilisées pour l’indentation : YAML n’autorise que les espaces pour l’indentation.
- Alias sans ancre : un alias
*namenécessite une ancre&namedéclarée plus tôt dans le même document. - Avertissements concernant les éléments qui peuvent être analysés, mais ne pas fonctionner comme prévu, par exemple un tag inconnu de l’analyseur ou une version
%YAMLnon prise en charge.
Une même clé peut apparaître dans différents mappings, et un fichier peut contenir plusieurs documents séparés par --- : les lignes sont comptées sur l’ensemble du fichier.
Ce qu’il ne vérifie pas
Le validateur vérifie que le texte est du YAML valide, mais pas qu’un programme donné l’accepte. Un fichier Docker Compose peut être du YAML valide tout en contenant un paramètre que Docker Compose ne reconnaît pas. Les messages proviennent de la bibliothèque yaml et sont en anglais.
Fonctionnement
L’outil analyse le texte avec la bibliothèque yaml, qui suit la spécification YAML 1.2 et exige que les clés soient uniques. Tout s’exécute dans votre navigateur : vos fichiers ne sont jamais téléversés.
Fonctionnalités
- Erreurs de syntaxe avec numéro de ligne et de colonne
- Clés répétées, tabulations utilisées pour l’indentation et alias sans ancre
- Erreurs et avertissements signalés dans l’éditeur, avec possibilité de faire défiler jusqu’à leur emplacement en cliquant dessus
- Fichiers contenant plusieurs documents
- Fonctionne dans votre navigateur