YAML-Dokumente hübsch drucken, validieren und untersuchen mit optionaler Schlüsselsortierung und Anker/Alias-Erweiterungssteuerung.
YAML-Dokumente hübsch drucken, validieren und untersuchen mit optionaler Schlüsselsortierung und Anker/Alias-Erweiterungssteuerung. YAML-Dokumente hübsch drucken, validieren und untersuchen mit optionaler Schlüsselsortierung und Anker/Alias-Erweiterungssteuerung.
YAML („YAML Ain't Markup Language") ist ein menschenfreundliches
Datenserialisierungsformat, das weithin für Konfigurationsdateien
verwendet wird (docker-compose.yml, Kubernetes-Manifests, GitHub
Actions-Workflows, Ansible-Playbooks usw.). Es tauscht die Strenge von
JSON gegen ein einrückungsbasiertes Strukturmodell und ein reicheres
Typsystem, das Daten, Mehrzeilenzeichenketten und Referenzen umfasst.
Weil YAML auf Einrückung beruht, um Verschachtelung auszudrücken, kann eine fehlende Leerstelle die Bedeutung eines gesamten Dokuments ändern, und die meisten Editoren heben die Hierarchie nicht visuell hervor. Ein Viewer parst das Dokument und gibt es mit konsistenter Einrückung neu aus und deckt dabei Einrückungsfehler auf, während er die Struktur sichtbar macht.
Die meisten Viewer lassen dich einige Verhaltensweisen umschalten:
Schlüssel alphabetisch für stabile Diffs sortieren, YAML-Anker und
-Aliase (die & / *-Syntax) erweitern oder entfernen, und die
Einrückungsbreite wählen. Die Sortieroption ist besonders wertvoll beim
Vergleich zweier Schnappschüsse derselben Konfiguration – ohne sie kann
das Umordnen von Schlüsseln zwischen Releases echte Änderungen maskieren.
Die Byte- und Top-Level-Schlüssel-Statistik hilft dir zu sehen, wie schwer das Dokument ist und wo der Großteil liegt. Wenn du wissen musst, ob dein YAML in ein Limit für Umgebungsvariablen oder ein Kubernetes-ConfigMap-Größenbudget passt, steht diese Zahl direkt da.
Wenn du einen Parse-Fehler debuggst, kopiere das Dokument in einen
frischen Viewer-Tab und schalte die Optionen nacheinander um: eine
&anchor-Syntax sieht vielleicht wie ein Tippfehler aus, bis du sie
erweitert siehst. Für sehr lange Pipelines verwende eine
4-Leerzeichen-Einrückung, um gängigen Styleguides zu entsprechen; für
Inline-Review oder Chat-Einfügungen ist 2-Leerzeichen kompakter. Bewahre
beim Committen von Konfiguration immer die ursprüngliche
Dokumentstruktur: Ein Viewer dient der Inspektion, nicht der
Normalisierung.