{"canonical_url":"https://engineer.company/de/glossary/yaml/","content_markdown":"# YAML\n\n## Was es ist\n\nYAML ist ein Textformat für verschachtelte Daten. Es kennzeichnet Struktur durch\nEinrückungen, Doppelpunkte und Bindestriche statt durch Klammern und\nAnführungszeichen. Deshalb ist es eine übliche Wahl für Konfigurationen, die\nMenschen von Hand schreiben und prüfen. Der Name ist ein rekursives Akronym:\n„YAML Ain't Markup Language“, also „YAML ist keine Auszeichnungssprache“.\nDateien enden auf `.yaml` oder `.yml`. Der im Februar 2024 veröffentlichte\nRFC 9512 registrierte den Medientyp `application/yaml` und nannte `.yaml` als\nbevorzugte Dateiendung.\n\nHinter den wenigen Satzzeichen steckt ein kleines Datenmodell. Es gibt\nZuordnungen, die Schlüssel und Werte paaren, Sequenzen als geordnete Listen und\nSkalare: Zeichenfolgen, Zahlen, boolesche Werte und null. Darum herum ergänzt die\nSprache, was Menschen beim Bearbeiten einer Datei brauchen: mit `#` beginnende\nKommentare, Blockskalare, die mit `|` Zeilenumbrüche erhalten oder mit `\u003e`\nzusammenfalten, mehrere durch `---` getrennte Dokumente in einer Datei, Anker und\nAliasse (`\u0026name` und `*name`), mit denen ein Wert anderswo wiederverwendet werden\nkann, und Tags, die einen Typ ausdrücklich angeben.\n\nDas erste YAML-Framework wurde 2001 in Perl geschrieben. Version 1.1 der\nSpezifikation folgte 2005 und Version 1.2 im Jahr 2009. Deren Hauptziel war,\nYAML zu einer echten Obermenge von JSON zu machen; viele ältere Regeln zur\nimpliziten Typisierung wurden entfernt. Die im Oktober 2021 veröffentlichte\nRevision 1.2.2 korrigierte Fehler und präzisierte Formulierungen, ohne die Sprache\nzu ändern. Viele Programme lesen jedoch noch nach den älteren Regeln. Die\nAnsible-Dokumentation hält fest, dass PyYAML und libyaml YAML 1.1 implementieren.\n\nYAML steht damit zwischen zwei Nachbarn. JSON ist eine echte Teilmenge: knapp und\neindeutig, für den Datenaustausch zwischen Programmen gemacht. TOML ist ein\nflacheres Konfigurationsformat, in dem jede Zeichenfolge in Anführungszeichen\nsteht und ihr Typ daher nie erraten wird. YAML bietet mehr als beide. Genau diese\nzusätzliche Freiheit ist die Ursache seiner Schwierigkeiten.\n\n## Warum es wichtig ist\n\nDie eigentliche Entscheidung lautet, welches Format eine über Jahre von Menschen\ngepflegte Datei bekommen soll: Deployment-Beschreibungen, CI-Abläufe oder\nServerkonfigurationen. Ansible-Playbooks sind YAML, ebenso die Konfigurationsdateien\nvieler anderer Infrastrukturwerkzeuge. Für einen großen Teil dieser Arbeit ist\ndie Entscheidung daher schon vorgelagert gefallen. Offen bleibt, wie streng man\ndas Format schreibt.\n\nFür YAML spricht die Lesbarkeit. Ein Prüfer kann einen Änderungsvergleich lesen,\nohne Klammern zu zählen. Ein Kommentar erklärt den Grund für einen Wert, und ein\nmehrzeiliges Skript oder Zertifikat passt ohne Escapezeichen in einen Blockskalar.\nDagegen steht, dass Leerraum Bedeutung trägt: Ein um zwei Leerzeichen zu weit\neingerückter Schlüssel kann in einer anderen Zuordnung landen, während die Datei\nweiterhin gültig eingelesen wird. Tabulatoren sind zum Einrücken ganz verboten.\nNicht in Anführungszeichen gesetzte Werte erhalten ihren Typ nach ihrer\nSchreibweise; die Regeln dafür unterscheiden sich zwischen 1.1 und 1.2.\nVorlagen legen eine zweite Syntax darüber. In Ansible muss ein mit `{{`\nbeginnender Wert in Anführungszeichen stehen, sonst liest ihn der Parser als\nZuordnung.\n\nDen Ausschlag gibt, wie die Datei geprüft wird. Mit einem Linter und der\nGewohnheit, Zeichenfolgen in Anführungszeichen zu setzen, ist YAML ein angenehmes\nFormat für gemeinsam bearbeitete Konfigurationen. Fehlt beides, kann eine gültige\nDatei etwas anderes aussagen als von ihrem Autor beabsichtigt. Für Daten zwischen\nProgrammen ist JSON die sicherere Standardwahl. Für eine kurze Einstellungsdatei\nmit wenigen Verschachtelungsebenen ist TOML einfacher.\n\n## Wie es in der Praxis aussieht\n\nDas Infrastruktur-Repository des Unternehmens umfasst öffentlich betriebene\nDienste und die Konfiguration weiterer Komponenten, darunter Datenbank-, Backup-,\nMailtransport- und DNS-Rollen. Die dokumentierte Implementierung umfasste\n[19 Ansible-Playbooks und 34 Rollen mit insgesamt 12.065 Zeilen](/de/portfolio/servers-you-can-rebuild-from-scratch/).\nDas ist eine historische Zählung, nicht die aktuelle Repository-Größe. Die\nBackup- und Mailautomatisierung hat einen von ihrer Konfiguration getrennten\nbetrieblichen Aktivierungsschritt. Die Zusammensetzung steckt in Daten statt in\nSchaltern. Jeder Host gehört zu einer Gruppe einer Infrastrukturebene. Deren\nYAML-Variablen listen die Rollen des Hosts auf. Ein Provisionierungslauf braucht\ndaher keine Argumente, um alle Hosts in den von ihrer Gruppe deklarierten Zustand\nzu bringen. Hier dient YAML als Sprache des deklarierten Zustands. Der Erfolg\nwird geprüft, nicht vorausgesetzt: Ein bereits in diesen Zustand gebrachter Host\nmuss null Änderungen melden. YAML kostet dabei Geschwindigkeit. Jede Änderung\ndauert länger als das direkte Bearbeiten einer Datei auf dem Server. Weil ein\nnur halb angewendeter Lauf schlimmer ist als ein abgewiesener, steht inzwischen\nein Play für Vorabprüfungen davor.\n\nZwölftausend Zeilen YAML sollte zuerst eine Maschine lesen und erst dann ein\nMensch. Im dokumentierten Implementierungsstand vom August 2026 gehörte\n[YAML zu den Sprachen einer verbindlichen Qualitätsprüfung mit 22 Lintern vor jedem Commit](/de/portfolio/built-a-22-linter-commit-gate/),\nneben HTML, CSS, JavaScript, Python, Markdown und Shell. Eine Warnstufe gibt es\nnicht: Jede Diagnose verhindert den Commit. Unterdrückungen direkt in der Datei\nsind grundsätzlich verboten; weder ein Ignorierkommentar noch eine\nDeaktivierungsanweisung ist ein Ausweg. Für YAML zählt das besonders, weil die\nmeisten folgenden Fallen syntaktisch völlig gültig sind. Nur eine Regel, die sie\nzurückweist, fängt sie ab, bevor sie einen Host erreichen.\n\n## Wo es schiefgeht\n\nDie folgenden Fallen haben eines gemeinsam: Die Datei lässt sich fehlerfrei\neinlesen und bedeutet etwas anderes.\n\n**Ein Ländercode wird zum Wahrheitswert falsch.** Nach den Regeln von YAML 1.1 sind die nicht\nin Anführungszeichen gesetzten Werte `yes`, `no`, `on`, `off`, `y` und `n` in\nmehreren Groß- und Kleinschreibungen boolesch. Das Core-Schema von YAML 1.2\nbehält nur `true` und `false`, in drei Schreibweisen. RFC 9512 warnt, dass ein\nParser mit älterer Syntax `{insecure: n}` als falsch statt als den Buchstaben n\nlesen kann. Eine Liste nordischer Länder zeigt das Problem:\n\n```yaml\ncountries:\n    - DK\n    - SE\n    - NO # YAML 1.1 reads this as false\n```\n\nSetzen Sie jede Zeichenfolge, die anders gelesen werden könnte, in\nAnführungszeichen. Schreiben Sie boolesche Werte nur als `true` und `false`\nund lassen Sie einen Linter beides durchsetzen.\n\n**Eine Versionsnummer verliert eine Ziffer.** Nicht in Anführungszeichen gesetzte\nZahlen werden umgewandelt. So kommt `version: 1.10` als Gleitkommazahl 1,1 an.\nNach den Regeln von 1.1 markiert eine führende Null zudem eine Oktalzahl: Ein als\n`010` geschriebener Code wird zu 8. Genau deshalb fordert Ansible seine Benutzer\nauf, eine Version wie `\"1.0\"` in Anführungszeichen zu setzen. Tun Sie das bei\nKennungen, Codes und Versionen: Es sind Zeichenfolgen, die zufällig Ziffern\nenthalten.\n\n**Ein Schlüssel landet unter dem falschen Elternknoten.** Die Einrückung legt\nfest, zu welcher Zuordnung ein Schlüssel gehört. Eine um zwei Leerzeichen\nverschobene Zeile verlegt eine Einstellung deshalb ohne Fehler an eine andere\nStelle. Die Spezifikation verlangt außerdem, dass jeder Schlüssel einer Zuordnung\neindeutig ist. Eine weit unten in einem langen Block wiederholte Angabe ist bei\nder Prüfung leicht zu übersehen. yamllint hat daher für beide Fehler eine Regel.\nFühren Sie es aus, bevor die Datei verwendet wird.\n\n**Das Laden einer Datei führt Code aus.** Tags können sprachspezifische Typen\nbenennen. Ein Loader, der sie berücksichtigt, erzeugt jedes von der Datei\nverlangte Objekt. Die PyYAML-Dokumentation vergleicht das Laden mit `yaml.load`\n(bei Verwendung eines unsicheren Loaders) mit `pickle.load`: Dabei können Objekte erzeugt und\nPython-Funktionen aufgerufen werden. Die Wahl des Loaders ist entscheidend;\naktuelle Versionen verlangen sie ausdrücklich. `yaml.safe_load` erkennt nur\ngrundlegende YAML-Tags. RFC 9512 verlangt, dass die Codeausführung in\nDeserialisierern standardmäßig abgeschaltet ist. Verwenden Sie für gewöhnliche\nKonfigurationsdateien den sicheren Loader.\n\n**Eine kurze Datei füllt den Speicher.** Anker und Aliasse machen ein\nYAML-Dokument zu einem Graphen statt zu einem Baum. Wiederholt jeder Anker den\nvorherigen zweimal, verdoppelt jede zusätzliche Zeile die Größe. Dreißig kurze\nZeilen beschreiben so mehr als eine Milliarde Zeichenfolgen, sobald ein Programm\ndas Ergebnis als einfachen Baum durchläuft. RFC 9512 nennt dies exponentielle\nDatenausweitung, den Billion-Laughs-Angriff, und fordert dafür Prozessoren, die die\nRekursionstiefe von Ankern begrenzen. Nehmen Sie YAML von außen nur über einen\nsolchen Prozessor an und testen Sie die Grenze mit dem tatsächlich verwendeten\nParser.\n\n## Weiterführende Lektüre\n\n- [YAML-Spezifikation 1.2.2](https://yaml.org/spec/1.2.2/) — die Sprache selbst,\n  einschließlich des Core-Schemas zur Typisierung nicht in Anführungszeichen\n  gesetzter Werte.\n- [RFC 9512: YAML Media Type](https://www.rfc-editor.org/rfc/rfc9512) — die\n  Registrierung von `application/yaml` mit Sicherheitshinweisen zu booleschen\n  Werten, Codeausführung und Aliasexpansion.\n- [Änderungen der YAML-Spezifikation](https://yaml.org/spec/1.2.2/ext/changes/)\n  — die Änderungen jeder Revision, von 1.2.1 bis 1.2.2.\n- [Ansible: YAML-Syntax](https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html)\n  — die von Ansible verwendete Teilmenge und ihre Fallen bei Anführungszeichen.\n- [yamllint-Regeln](https://yamllint.readthedocs.io/en/stable/rules.html) —\n  Prüfungen auf boolesch interpretierte Werte, doppelte Schlüssel, Oktalzahlen\n  und Einrückungen.\n- [PyYAML-Dokumentation](https://pyyaml.org/wiki/PyYAMLDocumentation) — der\n  Unterschied zwischen `load` und `safe_load` in den Worten der Bibliothek.\n\n\u003chttps://engineer.company/de/glossary/yaml/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Was YAML ist, wann es für von Hand gepflegte Dateien statt JSON oder TOML passt und wie boolesche Werte, Einrückungen und unsichere Loader Fehler auslösen.","formats":{"gemtext":"https://engineer.company/de/glossary/yaml/index.gmi","gopher":"https://engineer.company/de/glossary/yaml/gophermap","html":"https://engineer.company/de/glossary/yaml/","json":"https://engineer.company/de/glossary/yaml/index.json","markdown":"https://engineer.company/de/glossary/yaml/index.md","pdf":"https://engineer.company/de/glossary/yaml/index.pdf"},"kind":"page","language":"de","title":"Was ist YAML?","url":"https://engineer.company/de/glossary/yaml/","version":1}