Syntaxe YAML et validation : Erreurs courantes et solutions

YAML est le format de configuration incontournable pour Docker, Kubernetes et les pipelines CI/CD. Malgré sa syntaxe lisible, il est étonnamment facile de se tromper.

Où YAML est utilisé

• Docker Compose
• Manifestes Kubernetes
• GitHub Actions / GitLab CI
• Playbooks Ansible
• Fichiers de configuration

Règles de syntaxe de base

Indentation

YAML utilise des espaces (jamais de tabulations) :

# ✅ Correct (2-space indentation)
server:
  host: localhost
  port: 8080
  database:
    name: myapp
    pool: 10

# ❌ Wrong (tab characters or inconsistent spaces)
server:
	host: localhost    # Tab character - INVALID!
   port: 8080        # 3 spaces - inconsistent!

Paires clé-valeur

Séparées par deux-points et espace :

# ✅ Correct
name: John Doe
port: 8080

# ❌ Wrong - missing space after colon
name:John Doe

Chaînes multi-lignes

YAML offre deux styles de scalaires bloc :

# | (literal block) - preserves newlines
description: |
  This is line one.
  This is line two.
  Each newline is preserved.

# > (folded block) - folds newlines to spaces
description: >
  This is a long paragraph
  that will be joined into
  a single line.

Types de données

Le "problème norvégien"

En YAML 1.1, `NO` est interprété comme `false`. Mettez les codes pays entre guillemets :

# ❌ YAML 1.1 interprets these as booleans!
country: NO        # → false
answer: yes        # → true
switch: on         # → true

# ✅ Fix: quote the values
country: "NO"      # → string "NO"
answer: "yes"      # → string "yes"
switch: "on"       # → string "on"

Collections

# List (sequence)
fruits:
  - apple
  - banana
  - cherry

# Nested map
database:
  host: localhost
  port: 5432
  credentials:
    user: admin
    password: secret

# Inline / Flow style
fruits: [apple, banana, cherry]
point: {x: 10, y: 20}

Top 10 des erreurs YAML

YAML vs JSON vs TOML

Bonnes pratiques

• Utiliser un linter YAML en CI/CD
• Afficher les espaces dans l'éditeur
• Utiliser 2 espaces
• Quoter les chaînes ambiguës
• Utiliser la validation de schéma
• Garder les fichiers petits

FAQ