YAML Syntax & Validierung: Häufige Fehler und Lösungen

YAML ist das Standard-Konfigurationsformat für Docker, Kubernetes und CI/CD-Pipelines. Trotz der menschenfreundlichen Syntax ist es überraschend fehleranfällig.

Wo YAML verwendet wird

• Docker Compose
• Kubernetes Manifeste
• GitHub Actions / GitLab CI
• Ansible Playbooks
• Konfigurationsdateien

Grundlegende Syntaxregeln

Einrückung

YAML verwendet Leerzeichen (keine Tabs):

# ✅ 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!

Schlüssel-Wert-Paare

Durch Doppelpunkt und Leerzeichen getrennt:

# ✅ Correct
name: John Doe
port: 8080

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

Mehrzeilige Strings

YAML bietet zwei Block-Skalar-Stile:

# | (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.

Datentypen

Das "Norwegen-Problem"

In YAML 1.1 wird `NO` als boolean `false` interpretiert:

# ❌ 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"

Sammlungen

# 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 YAML-Fehler

YAML vs JSON vs TOML

Best Practices

• YAML-Linter in CI/CD verwenden
• Leerzeichen im Editor anzeigen
• 2 Leerzeichen verwenden
• Mehrdeutige Strings quoten
• Schema-Validierung nutzen
• Dateien klein und modular halten

FAQ