Docker/Compose/01 YAML
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)
- Syntaxregeln
| --- | 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.
|
| 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 Variantem in geschwungenen Klammern: { 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 erhalten: textblock : > Zusammenghörender Text. Hier beginnt der zweite Absatz. |
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' zugeordnet .
key2 : |
code line 1
code line 2
- Fortgeschrittene Syntaxelemente
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.
Installation (Debian)
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: