Formateur YAML
Pourquoi formater les fichiers YAML ?
Le YAML est extrêmement sensible à l'indentation — un seul espace en trop peut provoquer des erreurs d'analyse ou une corruption silencieuse des données. Des outils comme Kubernetes, Docker Compose, GitHub Actions et Ansible utilisent tous des fichiers de configuration YAML, où des erreurs de formatage peuvent paralyser des déploiements entiers. Notre formateur YAML valide la syntaxe, normalise l'indentation et s'assure que votre YAML est toujours correct.
Normalisation de l'indentation
Normalise les indentations mixtes vers un format cohérent de 2 espaces dans tout le document
Validation de la syntaxe
Détecte les erreurs d'indentation, les mélanges tabulations/espaces et les problèmes structurels avant les pannes en production
Ancres et alias
Prend entièrement en charge les ancres YAML (&) et les alias (*) pour la réutilisation de documents et les configurations DRY
Formater du YAML en 3 étapes
Collez votre YAML
Collez votre manifeste Kubernetes, votre workflow GitHub Actions ou tout fichier de configuration YAML
Formater et valider
L'outil valide la syntaxe et reformate automatiquement avec une indentation cohérente
Copiez et déployez
Copiez le YAML formaté dans votre fichier, pipeline CI ou outil de déploiement
Cas d'utilisation du formatage YAML
Manifestes Kubernetes
Formatez les fichiers YAML Deployment, Service et ConfigMap avant de les appliquer à un cluster
Pipelines CI/CD
Validez les workflows GitHub Actions, GitLab CI et CircleCI pour éviter les échecs de pipeline
Playbooks Ansible
Formatez et validez les tâches, variables et fichiers d'inventaire Ansible pour un code d'infrastructure propre
Docker Compose
Assurez-vous que les fichiers docker-compose.yml sont correctement formatés avant d'exécuter docker compose up
Bonnes pratiques YAML
✓ Utilisez des espaces, jamais des tabulations
YAML interdit strictement les tabulations pour l'indentation. Configurez toujours votre éditeur pour insérer des espaces lors de l'appui sur Tab dans les fichiers YAML.
✓ Mettez entre guillemets les caractères spéciaux
Les chaînes contenant : # [ ] { } ou commençant par des caractères spéciaux doivent être entre guillemets pour éviter une mauvaise interprétation par YAML.
✓ Utilisez les ancres pour réduire la duplication
Les ancres YAML (&nom) et les alias (*nom) permettent de réutiliser des valeurs dans un document, réduisant la répétition dans les configurations complexes.
✓ Lintez avant de commiter
Exécutez yamllint ou utilisez ce formateur dans votre hook pre-commit pour détecter les problèmes de formatage avant qu'ils n'atteignent le dépôt.
❓ Foire aux questions
Pourquoi le YAML échoue-t-il avec les tabulations au lieu des espaces ?
La spécification YAML interdit explicitement les caractères de tabulation pour l'indentation, car différents éditeurs affichent les tabulations avec des largeurs différentes. Les espaces offrent une indentation cohérente et non ambiguë que tous les parseurs YAML peuvent interpréter de manière identique.
Que font les ancres (&) et les alias (*) en YAML ?
Les ancres définissent un bloc réutilisable avec &nom-ancre: et les alias le référencent avec *nom-ancre. Cela vous permet de définir des valeurs une seule fois et de les réutiliser plusieurs fois, gardant les configurations DRY.
Quelle est la différence entre YAML et JSON ?
YAML est un surensemble de JSON — tout JSON valide est du YAML valide. YAML ajoute la prise en charge des commentaires, des ancres, des chaînes multi-lignes et une syntaxe plus lisible. JSON est préférable pour l'échange de données machine à machine ; YAML est plus adapté à la configuration éditée par des humains.
Pourquoi choisir YAML plutôt que TOML pour la configuration ?
YAML bénéficie d'un support d'outils plus large (Kubernetes, Ansible, la plupart des systèmes CI) et peut représenter des structures imbriquées complexes de manière concise. TOML est plus simple et moins sujet aux erreurs pour les configurations de base. Pour la configuration DevOps, YAML est le standard.