Eine Umgebungsvariable ist ein benannter Wert, den ein Programm lesen kann. Compose kann Variablen an zwei Stellen nutzen. Beim Einlesen der Datei kann es einen Wert in die Konfiguration einsetzen. Außerdem kann es Werte an ein Programm im Container übergeben.
Docker Compose · Lektion 5
Umgebungsvariablen
Lerne, wie du Werte, die Compose in eine Datei einsetzt, von Werten unterscheidest, die im Container ankommen.
Einen Wert in die Datei einsetzen
Speichere dieses Beispiel als compose.env.yaml in deinem Übungsordner. Der Ausdruck ${PAGE_MODE:-demo} verwendet den Wert von PAGE_MODE, wenn die Variable gesetzt und ihr Wert nicht leer ist. Andernfalls verwendet Compose demo.
services:
toolbox:
image: busybox:1.36
environment:
PAGE_MODE: "${PAGE_MODE:-demo}"
Compose wertet den Ausdruck aus, bevor es den Container erstellt. Das nennt man Interpolation. Mit derselben Technik lässt sich etwa in einer anderen Datei ein Host-Port oder ein Image-Tag auswählen.
Welcher Wert steht in der ausgegebenen Konfiguration, wenn PAGE_MODE nicht gesetzt ist?
Den eingesetzten Wert anzeigen
Eine Variablenzuweisung vor einem Befehl setzt die Variable für genau diesen Aufruf. Damit kannst du ausprobieren, wie sich ein anderer Wert auswirkt. Der Befehl config gibt die aufgelösten Einstellungen aus, ohne einen Container zu erstellen.
$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml config
Suche in den Umgebungseinstellungen des Dienstes nach PAGE_MODE: review. Der Wert review dient nur als Beispiel. Vertrauliche Werte gehören weder in Beispielkonfigurationen noch in deren Ausgabe.
Die ausgegebene Konfiguration zeigt review. Was ist bis hierhin passiert?
Einen Wert an den Container übergeben
Der Abschnitt environment übergibt den eingesetzten Wert an einen neuen Container. Mit printenv lässt du den Wert im eigens für den Aufruf gestarteten Container ausgeben.
$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml run --rm toolbox printenv PAGE_MODE
Erwarte die Ausgabe review. Die Interpolation bestimmt den Wert, und der Umgebungseintrag übergibt ihn an den Container. Eine Variable, die nur den Host-Port festlegt, wird dadurch nicht automatisch Teil der Programmumgebung.
Wie prüfst du, welchen Wert das Programm im Werkzeugcontainer erhält?
Lektion abgeschlossen
Sie haben Umgebungsvariablen abgeschlossen
Du kannst jetzt die beiden Verwendungen von Umgebungsvariablen unterscheiden.
Lies einen Ausdruck mit Standardwert in einer Compose-Datei.
Prüfe die aufgelöste Konfiguration vor dem Containerstart.
Prüfe den Wert in der Umgebung des gestarteten Programms.
Lernfortschritt speichern
Erstellen Sie ein kostenloses Konto, um diese Lektion zu speichern und auf jedem Gerät weiterzulernen.
Kostenloses Konto erstellen