Docker/Compose/01 YAML
5.1 YAML-Syntax Bevor Sie docker compose oder docker stack deploy ausführen können, müssen Sie eine Datei mit dem Namen compose.yml erstellen. Die Kennung *.yml bezeichnet das YAML-Format (YAML Ain’t Markup Language). Die Syntaxregeln von YAML haben wir Ihnen hier kurz zusammengefasst:
--- leitet einen neuen Abschnitt ein.
- startet einen Kommentar, der bis zum Ende der Zeile reicht.
Zeichenketten können in der Form "abc" oder 'abc' ausgedrückt werden. Dies ist aber nur in Ausnahmefällen zwingend erforderlich – beispielsweise dann, wenn die Zeichenkette Sonderzeichen enthält oder als ein anderer YAML-Ausdruck inter- pretiert werden kann. Mehrere mit - eingeleitete Ausdrücke bilden eine Liste:
- rot - gr ü n - blau
Alternativ können Listen auch in eckige Klammern gestellt werden:
[ rot , gr ü n , blau ]
Assoziative Listen (Key-Value-Paare) werden in der Form key: value gebildet:
name : Hermann Huber age : 37
Auch hier gibt es eine platzsparende Variante, diesmal in geschwungenen Klam- mern:
{ name : Hermann Huber , age : 37}
| leitet einen Textblock ein, in dem die Zeilenumbrüche erhalten bleiben:
codeblock : | Zeile 1 Zeile 2
> leitet einen Textblock ein, in dem Zeilenumbrüche ignoriert werden. Leere Zeilen bleiben aber erhalten:
textblock : > Zusammeng e h örender Text .
Hier beginnt der zweite Absatz .
115
5 Container-Setups mit »compose«
Alle vorgestellten Elemente können ineinander verschachtelt werden. Die Struktur wird durch Einrückungen hergestellt. Dabei müssen Leerzeichen verwendet werden (keine Tabulatoren!). Beim Zugriff auf die Elemente werden die Bezeichner (Keys) aneinandergereiht.
- Datei sample . yaml
data : list :
- item1 - item2
key1 : >
Dieser Text ist dem Schl ü ssel 'data . key1 ' zugeordn e t .
key2 : |
code line 1 code line 2
Einige fortgeschrittene Syntaxelemente von YAML, die jedoch in compose.yaml- Dateien normalerweise keine Rolle spielen, sind in der Wikipedia dokumentiert: https://en.wikipedia.org/wiki/YAML Zum Auslesen von YAML-Dateien können Sie das Python-Script shyaml verwenden. Unter Ubuntu installieren Sie das Kommando wie folgt:
sudo apt install python - pip sudo pip install shyaml shyaml get - value data . list < sample . yaml - item1 - item2
Beim Experimentieren mit YAML-Dateien sind auch die YAML-Validatoren bzw. -Parser auf den folgenden Websites hilfreich: http://www.yamllint.com https://yaml-online-parser.appspot.com https://codebeautify.org/yaml-validator