Docker/Compose/02 Einführung: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Die Seite wurde neu angelegt: „5.2 Hello Compose! Das folgende Einführungsbeispiel für die Syntax von compose.yaml beschreibt ein Docker-Setup, das aus zwei Services besteht: zum einen aus einem Datenbankserver (MariaDB in der gerade aktuellen Version), zum anderen aus dem CMS WordPress. Ein Großteil der Einstellungen für die beiden Services sollte ohne Weiteres verständ- lich sein: Zur Speicherung der Datenbankdateien bzw. der HTML-Dateien werden jeweils benannte Volumes verwend…“
 
Keine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
5.2 Hello Compose!
== Hello Compose! ==
Das folgende Einführungsbeispiel für die Syntax von compose.yaml beschreibt ein
Das folgende Einführungsbeispiel für die Syntax von compose.yaml beschreibt ein Docker-Setup, das aus zwei Services besteht: zum einen aus einem Datenbankserver
Docker-Setup, das aus zwei Services besteht: zum einen aus einem Datenbankserver
(MariaDB in der gerade aktuellen Version), zum anderen aus dem CMS WordPress.
(MariaDB in der gerade aktuellen Version), zum anderen aus dem CMS WordPress.
Ein Großteil der Einstellungen für die beiden Services sollte ohne Weiteres verständ-
Ein Großteil der Einstellungen für die beiden Services sollte ohne Weiteres verständlich sein:
lich sein:


Zur Speicherung der Datenbankdateien bzw. der HTML-Dateien werden jeweils
Zur Speicherung der Datenbankdateien bzw. der HTML-Dateien werden jeweils benannte Volumes verwendet. (Die Namen der Volumes müssen zweimal angegeben werden, einmal bei der Beschreibung der jeweiligen Services und ein zweites Mal – üblicherweise am Ende der Datei compose.yaml – in einem separaten Abschnitt volumes.)
benannte Volumes verwendet. (Die Namen der Volumes müssen zweimal ange-
In MariaDB sollen die Datenbank wp und der dazugehörende Benutzer wpuser mit dem Passwort geheim eingerichtet werden. Als root-Passwort kann eine zufällige Zeichenkette verwendet werden – es ist für das Setup nicht relevant.
geben werden, einmal bei der Beschreibung der jeweiligen Services und ein zwei-
Damit WordPress auf die Datenbank zugreifen kann, müssen die entsprechenden WORDPRESS -Variablen initialisiert werden. DB_HOST verweist auf den Servicenamen db und die Defaultportnummer des MariaDB-Servers.
tes Mal – üblicherweise am Ende der Datei compose.yaml – in einem separaten
Der für WordPress zuständige Webserver nutzt im Container Port 80. Dieser Port soll mit Port 8082 des Host-Rechners verbunden werden.
Abschnitt volumes.)
In MariaDB sollen die Datenbank wp und der dazugehörende Benutzer wpuser mit
dem Passwort geheim eingerichtet werden. Als root-Passwort kann eine zufällige
Zeichenkette verwendet werden – es ist für das Setup nicht relevant.
Damit WordPress auf die Datenbank zugreifen kann, müssen die entsprechenden
WORDPRESS -Variablen initialisiert werden. DB_HOST verweist auf den Servicenamen db
und die Defaultportnummer des MariaDB-Servers.
Der für WordPress zuständige Webserver nutzt im Container Port 80. Dieser Port
soll mit Port 8082 des Host-Rechners verbunden werden.


# Datei compose . yaml
# Datei compose . yaml
services :
services :
db :
  db :
image : mariadb : latest
image : mariadb : latest
volumes :
volumes :
- vol - db :/ var / lib /mysql
-vol-db :/ var / lib /mysql
environm en t :
environm en t :
MYSQL_RAN D O M_ R O O T _P A S S W OR D :  1
MYSQL_RAN D O M_ R O O T _P A S S W OR D :  1
MYSQL_DAT A B AS E :                        wp
MYSQL_DAT A B AS E :                        wp
MYSQL_USE R :                                wpuser
MYSQL_USE R :                                wpuser
MYSQL_PAS S W OR D :                        geheim
MYSQL_PAS S W OR D :                        geheim
restart : always
restart : always
wordpres s :
image : wordpress : latest
volumes :
-vol-www :/ var / www / html /wp-content
ports :
-"8082:80 "
environm en t :
WORDPRESS _ D B_ H O S T :        db :3306
WORDPRESS _ D B_ U S E R :        wpuser
WORDPRESS _ D B_ N A M E :        wp
WORDPRESS _ D B_ P A S S WO R D : geheim
restart : always


wordpres s :
volumes :
image : wordpress : latest
vol-www :
volumes :
vol-db :
- vol - www :/ var / www / html /wp - content
ports :
- "8082:80 "
environm en t :
WORDPRESS _ D B_ H O S T :        db :3306
WORDPRESS _ D B_ U S E R :        wpuser
WORDPRESS _ D B_ N A M E :        wp
WORDPRESS _ D B_ P A S S WO R D : geheim
restart : always


volumes :
vol - www :
vol - db :


=== docker compose ===
5 Container-Setups mit »compose«
Um docker compose auszuprobieren, wechseln Sie zuerst in das Verzeichnis mit der Datei compose.yaml – hier wordpress-beispiel . Beachten Sie, dass der Verzeichnisname zur Benennung der Container, Volumes, Netzwerke usw. verwendet wird.
docker compose up -d sucht im aktuellen Verzeichnis nach der Datei compose.yaml, lädt die erforderlichen Images herunter (natürlich nur, wenn diese noch nicht zur Verfügung stehen), erzeugt die Container, verbindet diese in einem eigens dafür erzeugten Netzwerk und startet sie als Hintergrundprozesse (Option -d). Der gesamte Vorgang dauert nur wenige Sekunden (plus gegebenenfalls die Zeit zum Download der Images). Beachten Sie, dass die Container wegen restart: always auch nach einem Reboot des Rechners automatisch neu gestartet werden.


docker compose
cd wordpress-beispiel      ( Verzeichn i s mit compose . yaml )
Um docker compose auszuprobieren, wechseln Sie zuerst in das Verzeichnis mit der
docker compose up -d
Datei compose.yaml – hier wordpress-beispiel . Beachten Sie, dass der Verzeichnisname
Creating network wordpress-beispiel_ d e f a ul t " with the default
zur Benennung der Container, Volumes, Netzwerke usw. verwendet wird.
driver
docker compose up -d sucht im aktuellen Verzeichnis nach der Datei compose.yaml,
Creating wordpress-beispiel _ wo r d p r es s _ 1 ... done
lädt die erforderlichen Images herunter (natürlich nur, wenn diese noch nicht zur
Creating wordpress-beispiel _ db _ 1              ... done
Verfügung stehen), erzeugt die Container, verbindet diese in einem eigens dafür
erzeugten Netzwerk und startet sie als Hintergrundprozesse (Option -d). Der gesamte
Vorgang dauert nur wenige Sekunden (plus gegebenenfalls die Zeit zum Download
der Images). Beachten Sie, dass die Container wegen restart: always auch nach
einem Reboot des Rechners automatisch neu gestartet werden.


cd wordpress - beispiel      ( Verzeichn i s mit compose . yaml )
Das Kommando docker ps zeigt die beiden laufenden Container. (Die Ausgabe ist aus Platzgründen stark gekürzt.) Nach wenigen Sekunden, die für die Initialisierung des Containers erforderlich sind, können Sie WordPress unter der Adresse localhost:8082
docker compose up -d
Creating network wordpress - beispiel_ d e f a ul t " with the default
driver
Creating wordpress - beispiel _ wo r d p r es s _ 1 ... done
Creating wordpress - beispiel _ db _ 1              ... done
 
Das Kommando docker ps zeigt die beiden laufenden Container. (Die Ausgabe ist aus
Platzgründen stark gekürzt.) Nach wenigen Sekunden, die für die Initialisierung des
Containers erforderlich sind, können Sie WordPress unter der Adresse localhost:8082
nutzen.
nutzen.


docker ps
docker ps
ID          PORTS                          NAMES
ID          PORTS                          NAMES
5211...    0.0.0.0:8082 - >80/tcp        wordpress -beispiel _ w o rd p r e s s_ 1
5211...    0.0.0.0:8082->80/tcp        wordpress -beispiel _ w o rd p r e s s_ 1
d9dc ...    3306/ tcp                      wordpress -beispiel _ d b _1
d9dc ...    3306/ tcp                      wordpress -beispiel _ d b _1


Um die Ausführung aller zusammengehörenden Container zu stoppen, führen Sie
Um die Ausführung aller zusammengehörenden Container zu stoppen, führen Sie docker compose stop aus. Analog setzt docker compose start die Ausführung fort.
docker compose stop aus. Analog setzt docker compose start die Ausführung fort.
Diese Kommandos setzen jeweils voraus, dass sich compose.yaml im aktuellen Verzeichnis befindet.
Diese Kommandos setzen jeweils voraus, dass sich compose.yaml im aktuellen Ver-
Mit docker compose down stoppen und löschen Sie alle Container der Setups. Die Volumes bleiben erhalten. Bei Bedarf können Sie die Container unter Beibehaltung der bisherigen Daten mit docker compose up wieder neu einrichten:
zeichnis befindet.
Mit docker compose down stoppen und löschen Sie alle Container der Setups. Die Vol-
umes bleiben erhalten. Bei Bedarf können Sie die Container unter Beibehaltung der
bisherigen Daten mit docker compose up wieder neu einrichten:


docker compose down                ( Containe r stoppen und l ö schen )
docker compose down                ( Containe r stoppen und l ö schen )
...
...
docker compose up -d                ( Containe r neu einrichte n )
docker compose up -d                ( Containe r neu einrichte n )


Wenn Sie die Container und die dazugehörenden Volumes löschen möchten, führen
Wenn Sie die Container und die dazugehörenden Volumes löschen möchten, führen Sie für das vorliegende Beispiel die folgenden Kommandos aus:
Sie für das vorliegende Beispiel die folgenden Kommandos aus:


docker compose down
docker compose down
docker volume rm wordpress - beispiel_vol - db \
docker volume rm wordpress-beispiel_vol-db \
wordpress - beispiel_vol - www
  wordpress-beispiel_vol-www


podman-compose
=== docker stack deploy ===
Das Beispiel funktioniert unverändert auch mit Podman, wenn Sie docker compose
Statt mit docker compose können Sie die Datei compose.yaml auch mit dem Kommando docker stack deploy verarbeiten. docker stack setzt voraus, dass der Computer Mitglied eines Docker-Schwarms ist. Sie müssen aber durchaus keinen Docker-Cluster bilden, um docker stack verwenden zu können. Es reicht vollkommen aus, wenn Sie auf Ihrem Rechner einmalig docker swarm init ausführen. Damit bildet Ihr Computer einen Docker-Schwarm, der allerdings nur aus einem einzigen Mitglied besteht.
durch das Kommando podman-compose ersetzen. Es gibt aber einen kleinen Unter-
(Wie Sie »richtige« Docker-Cluster nutzen, die aus mehreren Computern zusammengesetzt sind, zeigen wir Ihnen in Kapitel 19, »Swarm«.)
schied: Unter Docker bewirken die beiden Zeilen restart: always einen automati-
schen Neustart der Container nach einem Reboot des Rechners. Bei Podman gibt es
keinen Hintergrunddienst, der sich darum kümmern kann. Dementsprechend müs-
sen Sie das Container-Setup bei Bedarf selbst wieder neu starten.


docker stack deploy
docker swarm init
Statt mit docker compose können Sie die Datei compose.yaml auch mit dem Kommando
Swarm initiali z e d : current node ( eqbx ...) is now a manager .
docker stack deploy verarbeiten. docker stack setzt voraus, dass der Computer Mit-
To add a worker to this swarm , run the following command :
glied eines Docker-Schwarms ist. Sie müssen aber durchaus keinen Docker-Cluster
docker swarm join --token SWMTKN -xxx 10.0.0.1: 2 3 7 7
bilden, um docker stack verwenden zu können. Es reicht vollkommen aus, wenn Sie
To add a manager to this swarm , run
auf Ihrem Rechner einmalig docker swarm init ausführen. Damit bildet Ihr Compu-
'docker swarm join-token manager ' and follow the instruct i on s .
ter einen Docker-Schwarm, der allerdings nur aus einem einzigen Mitglied besteht.
(Wie Sie »richtige« Docker-Cluster nutzen, die aus mehreren Computern zusammen-
gesetzt sind, zeigen wir Ihnen in Kapitel 19, »Swarm«.)


docker swarm init
Um die in compose.yaml beschriebenen Container samt einem Netzwerk einzurichten, übergeben Sie an docker stack deploy mit der Option -c den Dateinamen der Compose-Datei und als weiteren Parameter den Namen des Setups bzw. des Stacks.
Swarm initiali z e d : current node ( eqbx ...) is now a manager .
Dieser Name wird den Netzwerk-, Volume- und Servicenamen vorangestellt. (docker compose verwendet anstelle dieses Namens standardmäßig den Namen des Verzeichnisses, in dem sich compose.yaml befindet.)
To add a worker to this swarm , run the following command :
docker swarm join --token SWMTKN -xxx 10.0.0.1: 2 3 7 7
To add a manager to this swarm , run
'docker swarm join - token manager ' and follow the instruct i on s .


Um die in compose.yaml beschriebenen Container samt einem Netzwerk einzurich-
docker stack deploy -c compose .yaml stacktest
ten, übergeben Sie an docker stack deploy mit der Option -c den Dateinamen der
Ignoring unsupport e d options : restart
Compose-Datei und als weiteren Parameter den Namen des Setups bzw. des Stacks.
Creating network stacktes t _ d ef a u l t
Dieser Name wird den Netzwerk-, Volume- und Servicenamen vorangestellt. (docker
Creating service stacktes t _ w or d p r e ss
compose verwendet anstelle dieses Namens standardmäßig den Namen des Verzeich-
Creating service stacktes t _ d b
nisses, in dem sich compose.yaml befindet.)


docker stack deploy -c compose .yaml stacktest
docker stack ls beweist, dass der neue Stack eingerichtet wurde und aus zwei Services besteht:
Ignoring unsupport e d options : restart
Creating network stacktes t _ d ef a u l t
Creating service stacktes t _ w or d p r e ss
Creating service stacktes t _ d b


docker stack ls
NAME        SERVICES            ORCHESTR A T O R
stacktes t  2                  Swarm


5 Container-Setups mit »compose«
Mit docker service ls können Sie sich nun davon überzeugen, dass die Services tatsächlich erzeugt und ausgeführt werden. Die Ausgabe wurde wie üblich um einige Spalten gekürzt:


docker stack ls beweist, dass der neue Stack eingerichtet wurde und aus zwei Ser-
docker service ls
vices besteht:
ID              NAME                              REPLICAS  PORTS        ...
skz4ab9p 7 1 v a stacktest _ d b                    1/1
ghdrn0z2 g i 5 n stacktest _ w o r dp r e s s      1/1        * :8082->80/ tcp


docker stack ls
Entscheidend ist die REPLICAS -Spalte. Steht hier 0/1, ist beim Start ein Fehler aufgetreten. Aufschluss über die Fehlerursache kann die ERROR-Spalte der Ausgabe von docker service ps <sid/stackname> geben, wobei Sie die Service-ID oder den Namen des Stacks als Parameter übergeben. Das Kommando gibt an, welche Tasks in einem Service ausgeführt werden. Die ERROR-Spalte ist normalerweise so stark verkürzt, dass sie nicht aufschlussreich ist. Abhilfe schafft dann die Option --no-trunc:
NAME        SERVICES            ORCHESTR A T O R
stacktes t  2                  Swarm


Mit docker service ls können Sie sich nun davon überzeugen, dass die Services tat-
docker service ps sometest --no-trunc
sächlich erzeugt und ausgeführt werden. Die Ausgabe wurde wie üblich um einige
... NAME              ... ERROR
Spalten gekürzt:
stacktest _ d b .1    starting container failed : Invalid
  address 10.0.1.14 : It does not belong
  to any of this network ' s subnets


docker service ls
Mit docker ps können Sie sich davon überzeugen, dass für jeden Service ein entsprechender Container erstellt und gestartet wurde.
ID              NAME                              REPLICAS  PORTS        ...
Anders als bei Containern gibt es bei Stacks keine Möglichkeit, sie zu stoppen und später wieder zu starten. Sie können den gesamten Stack mit all seinen Services und Netzwerken aber mit docker stack rm löschen:
skz4ab9p 7 1 v a stacktest _ d b                    1/1
ghdrn0z2 g i 5 n stacktest _ w o r dp r e s s      1/1        * :8082 - >80/ tcp
Entscheidend ist die REPLICAS -Spalte. Steht hier 0/1, ist beim Start ein Fehler auf-
getreten. Aufschluss über die Fehlerursache kann die ERROR-Spalte der Ausgabe von
docker service ps <sid/stackname> geben, wobei Sie die Service-ID oder den Namen
des Stacks als Parameter übergeben. Das Kommando gibt an, welche Tasks in einem
Service ausgeführt werden. Die ERROR-Spalte ist normalerweise so stark verkürzt, dass
sie nicht aufschlussreich ist. Abhilfe schafft dann die Option --no-trunc:


docker service ps sometest --no - trunc
docker stack rm stacktes t
... NAME              ... ERROR
Removing service stacktes t _ d b
stacktest _ d b .1    starting container failed : Invalid
  Removing service stacktes t _ w or d p r e ss
  address 10.0.1.14 : It does not belong
  Removing network stacktes t _ d ef a u l t
  to any of this network ' s subnets


Mit docker ps können Sie sich davon überzeugen, dass für jeden Service ein entspre-
Die in compose.yaml angegebenen Volumes bleiben dabei erhalten. Daher ist es möglich, den Stack später ohne Verlust von Daten wieder einzurichten und neuerlich auszuführen:
chender Container erstellt und gestartet wurde.
Anders als bei Containern gibt es bei Stacks keine Möglichkeit, sie zu stoppen und
später wieder zu starten. Sie können den gesamten Stack mit all seinen Services und
Netzwerken aber mit docker stack rm löschen:


docker stack rm stacktes t
docker stack deploy -c compose .yaml stacktest
Removing service stacktes t _ d b
Removing service stacktes t _ w or d p r e ss
Removing network stacktes t _ d ef a u l t


Die in compose.yaml angegebenen Volumes bleiben dabei erhalten. Daher ist es mög-
Wenn Sie das Setup nicht mehr benötigen, löschen Sie sowohl den Stack als auch die zugeordneten Volumes:
lich, den Stack später ohne Verlust von Daten wieder einzurichten und neuerlich
auszuführen:


docker stack deploy -c compose .yaml stacktest
docker stack rm stacktes t
docker volume rm stacktest_vol -db stacktest_vol-www


Wenn Sie das Setup nicht mehr benötigen, löschen Sie sowohl den Stack als auch die
=== Debugging ===
zugeordneten Volumes:
Im Idealfall geht beim Start der Container durch docker compose up alles gut. Was aber, wenn Fehler auftreten?
Ein erstes Hilfsmittel zur Fehlersuche besteht darin, docker compose up ohne die Option -d auszuführen. Damit erfolgen sämtliche Logging-Ausgaben aller Container direkt in der Konsole. Sie können also zu einem gewissen Grad mitverfolgen, was in den Containern vor sich geht.
Alternativ können Sie mit docker ps einen Blick in die Container-Liste werfen. Dort erkennen Sie in der Regel sofort, ob es Container gibt, die nicht wie geplant laufen oder die ständig neu gestartet werden. Mit docker logs <cname> können Sie dann die Logging-Ausgaben der betroffenen Container lesen. docker compose logs zeigt das kombinierte Logging aller Container der Gruppe.
Wie üblich können Sie mit docker exec einen zusätzlichen interaktiven Shell-Prozess starten und so in einen laufenden Container »hineinsehen«:


docker stack rm stacktes t
docker exec -it test_wor dp r e s s _1 / bin / sh
docker volume rm stacktest_vol -db stacktest_vol - www
 
Podman
Unter Podman fehlen Kommandos, die mit docker swarm und docker stack kompati-
bel sind. Dafür gibt es mit podman pod eine andere Möglichkeit, Container-Gruppen zu
erzeugen. In diesem Buch gehen wir auf podman pod gar nicht und auf docker stack
nur noch am Rande ein. (Dafür beschäftigen wir uns ausführlich mit Docker Swarm,
siehe Kapitel 19.) Unser Fokus bleibt stattdessen auf dem Compose-Feature, das in
beiden Systemen zur Verfügung steht und in der Praxis von größter Bedeutung ist.
 
Debugging
Im Idealfall geht beim Start der Container durch docker compose up alles gut. Was aber,
wenn Fehler auftreten?
Ein erstes Hilfsmittel zur Fehlersuche besteht darin, docker compose up ohne die
Option -d auszuführen. Damit erfolgen sämtliche Logging-Ausgaben aller Container
direkt in der Konsole. Sie können also zu einem gewissen Grad mitverfolgen, was in
den Containern vor sich geht.
Alternativ können Sie mit docker ps einen Blick in die Container-Liste werfen. Dort
erkennen Sie in der Regel sofort, ob es Container gibt, die nicht wie geplant laufen
oder die ständig neu gestartet werden. Mit docker logs <cname> können Sie dann
die Logging-Ausgaben der betroffenen Container lesen. docker compose logs zeigt das
kombinierte Logging aller Container der Gruppe.
Wie üblich können Sie mit docker exec einen zusätzlichen interaktiven Shell-Prozess
starten und so in einen laufenden Container »hineinsehen«:
 
docker exec -it test_wor dp r e s s _1 / bin / sh
 
ps -ax
PID TTY                STAT        TIME COMMAND
1 ?                  Ss          0:00 apache2 -DFOREGRO U N D
66 ?                  S            0:00 apache2 -DFOREGRO U N D
...
78 pts /0            Ss          0:00 / bin / sh
83 pts /0            R+          0:00 ps -ax


ps -ax
PID TTY                STAT        TIME COMMAND
1 ?                  Ss          0:00 apache2 -DFOREGRO U N D
  66 ?                  S            0:00 apache2 -DFOREGRO U N D
  ...
  78 pts /0            Ss          0:00 / bin / sh
  83 pts /0            R+          0:00 ps -ax


5 Container-Setups mit »compose«


Interaktive Nutzung
=== Interaktive Nutzung ===
Es ist keine gute Idee, in compose.yaml ein Image anzugeben, in dem kein Prozess dau-
Es ist keine gute Idee, in compose.yaml ein Image anzugeben, in dem kein Prozess dauerhaft läuft:
erhaft läuft:


# Datei compose . yaml
# Datei compose . yaml
# Containe r / Service endet sofort , weil es
# Containe r / Service endet sofort , weil es
# keinen Hintergr u nd p r o z es s gibt
# keinen Hintergr u nd p r o z es s gibt
services :
services :
myservic e 1 :
myservic e 1 :
image : alpine
image : alpine


Führen Sie nun docker compose up aus, wird der betreffende Container zwar einge-
Führen Sie nun docker compose up aus, wird der betreffende Container zwar eingerichtet und gestartet, aber die Ausführung endet sofort wieder. Analog sieht es aus, wenn Sie docker stack deploy ausführen: Der Service wird eingerichtet und gestartet, aber mangels Hintergrundprozess endet die Ausführung sofort wieder. Die Schwarmlogik von Docker versucht nun immer wieder, den Service zu starten – aber das hilft natürlich auch nicht. Die REPLICAS -Spalte von docker service ls zeigt 0/1, und docker service ps listet diverse Startversuche auf, zeigt aber keine Fehlermeldungen:
richtet und gestartet, aber die Ausführung endet sofort wieder. Analog sieht es aus,
wenn Sie docker stack deploy ausführen: Der Service wird eingerichtet und gestartet,
aber mangels Hintergrundprozess endet die Ausführung sofort wieder. Die Schwarm-
logik von Docker versucht nun immer wieder, den Service zu starten – aber das hilft
natürlich auch nicht. Die REPLICAS -Spalte von docker service ls zeigt 0/1, und docker
service ps listet diverse Startversuche auf, zeigt aber keine Fehlermeldungen:


docker stack deploy -c compose .yaml test4
docker stack deploy -c compose .yaml test4


docker service ls
docker service ls
ID              NAME                              REPLICAS  IMAGE
ID              NAME                              REPLICAS  IMAGE
1 t8cfulkp x o z test4_mys e r v i ce 1            0/1        alpine :latest
1 t8cfulkp x o z test4_mys e r v i ce 1            0/1        alpine :latest


docker service ps 1t8cfulkp x o z
docker service ps 1t8cfulkp x o z
ID              ... DESIRED STATE              CURRENT STATE              ERROR
ID              ... DESIRED STATE              CURRENT STATE              ERROR
kolqn5wn z g p 2    Ready                      Ready 4 seconds ago
kolqn5wn z g p 2    Ready                      Ready 4 seconds ago
yrzb2d0g 4 a r c    Shutdown                  Complete 10 seconds ago
yrzb2d0g 4 a r c    Shutdown                  Complete 10 seconds ago
y3ojrkgf v 6 s w    Shutdown                  Complete a minute ago
y3ojrkgf v 6 s w    Shutdown                  Complete a minute ago
y54o8unh q f 8 s    Shutdown                  Complete a minute ago
y54o8unh q f 8 s    Shutdown                  Complete a minute ago
xayg2nje h i y j    Shutdown                  Complete 2 minutes ago
xayg2nje h i y j    Shutdown                  Complete 2 minutes ago


Es wird wohl eher ein Ausnahmefall sein, aber es ist möglich, mit docker compose
Es wird wohl eher ein Ausnahmefall sein, aber es ist möglich, mit docker compose einen Container für die interaktive Nutzung zu erzeugen. Dazu führen Sie mit docker compose das Kommando run <servicename> anstelle von up aus. Die zusätzliche Option
einen Container für die interaktive Nutzung zu erzeugen. Dazu führen Sie mit docker
compose das Kommando run <servicename> anstelle von up aus. Die zusätzliche Option
--rm bewirkt, dass der Container nach dem Verlassen der Shell gelöscht wird.
--rm bewirkt, dass der Container nach dem Verlassen der Shell gelöscht wird.


docker compose run --rm myservice 1
docker compose run --rm myservice 1


  cat / etc / os -release
  cat / etc / os -release
Zeile 275: Zeile 185:
  exit
  exit


Eine vergleichbare interaktive Nutzungsvariante für docker stack deploy gibt es
Eine vergleichbare interaktive Nutzungsvariante für docker stack deploy gibt es nicht. docker stack setzt auf dem Konzept von Services auf. Der interaktive Betrieb eines Service wäre aber unsinnig.
nicht. docker stack setzt auf dem Konzept von Services auf. Der interaktive Betrieb
eines Service wäre aber unsinnig.

Version vom 17. November 2026, 15:31 Uhr

Hello Compose!

Das folgende Einführungsbeispiel für die Syntax von compose.yaml beschreibt ein Docker-Setup, das aus zwei Services besteht: zum einen aus einem Datenbankserver (MariaDB in der gerade aktuellen Version), zum anderen aus dem CMS WordPress. Ein Großteil der Einstellungen für die beiden Services sollte ohne Weiteres verständlich sein:

Zur Speicherung der Datenbankdateien bzw. der HTML-Dateien werden jeweils benannte Volumes verwendet. (Die Namen der Volumes müssen zweimal angegeben werden, einmal bei der Beschreibung der jeweiligen Services und ein zweites Mal – üblicherweise am Ende der Datei compose.yaml – in einem separaten Abschnitt volumes.) In MariaDB sollen die Datenbank wp und der dazugehörende Benutzer wpuser mit dem Passwort geheim eingerichtet werden. Als root-Passwort kann eine zufällige Zeichenkette verwendet werden – es ist für das Setup nicht relevant. Damit WordPress auf die Datenbank zugreifen kann, müssen die entsprechenden WORDPRESS -Variablen initialisiert werden. DB_HOST verweist auf den Servicenamen db und die Defaultportnummer des MariaDB-Servers. Der für WordPress zuständige Webserver nutzt im Container Port 80. Dieser Port soll mit Port 8082 des Host-Rechners verbunden werden.

# Datei compose . yaml
services :
 db :
image : mariadb : latest
volumes :

-vol-db :/ var / lib /mysql

environm en t :
MYSQL_RAN D O M_ R O O T _P A S S W OR D :   1
MYSQL_DAT A B AS E :                         wp
MYSQL_USE R :                                wpuser
MYSQL_PAS S W OR D :                         geheim
restart : always

wordpres s :
image : wordpress : latest
volumes :

-vol-www :/ var / www / html /wp-content

ports :

-"8082:80 "

environm en t :
WORDPRESS _ D B_ H O S T :        db :3306
WORDPRESS _ D B_ U S E R :        wpuser
WORDPRESS _ D B_ N A M E :        wp
WORDPRESS _ D B_ P A S S WO R D : geheim
restart : always
volumes :
vol-www :
vol-db :


docker compose

Um docker compose auszuprobieren, wechseln Sie zuerst in das Verzeichnis mit der Datei compose.yaml – hier wordpress-beispiel . Beachten Sie, dass der Verzeichnisname zur Benennung der Container, Volumes, Netzwerke usw. verwendet wird. docker compose up -d sucht im aktuellen Verzeichnis nach der Datei compose.yaml, lädt die erforderlichen Images herunter (natürlich nur, wenn diese noch nicht zur Verfügung stehen), erzeugt die Container, verbindet diese in einem eigens dafür erzeugten Netzwerk und startet sie als Hintergrundprozesse (Option -d). Der gesamte Vorgang dauert nur wenige Sekunden (plus gegebenenfalls die Zeit zum Download der Images). Beachten Sie, dass die Container wegen restart: always auch nach einem Reboot des Rechners automatisch neu gestartet werden.

cd wordpress-beispiel       ( Verzeichn i s mit compose . yaml )
docker compose up -d
Creating network wordpress-beispiel_ d e f a ul t " with the default
driver
Creating wordpress-beispiel _ wo r d p r es s _ 1 ... done
Creating wordpress-beispiel _ db _ 1              ... done

Das Kommando docker ps zeigt die beiden laufenden Container. (Die Ausgabe ist aus Platzgründen stark gekürzt.) Nach wenigen Sekunden, die für die Initialisierung des Containers erforderlich sind, können Sie WordPress unter der Adresse localhost:8082 nutzen.

docker ps
ID          PORTS                          NAMES
5211...     0.0.0.0:8082->80/tcp         wordpress -beispiel _ w o rd p r e s s_ 1
d9dc ...    3306/ tcp                      wordpress -beispiel _ d b _1

Um die Ausführung aller zusammengehörenden Container zu stoppen, führen Sie docker compose stop aus. Analog setzt docker compose start die Ausführung fort. Diese Kommandos setzen jeweils voraus, dass sich compose.yaml im aktuellen Verzeichnis befindet. Mit docker compose down stoppen und löschen Sie alle Container der Setups. Die Volumes bleiben erhalten. Bei Bedarf können Sie die Container unter Beibehaltung der bisherigen Daten mit docker compose up wieder neu einrichten:

docker compose down                 ( Containe r stoppen und l ö schen )
...
docker compose up -d                ( Containe r neu einrichte n )

Wenn Sie die Container und die dazugehörenden Volumes löschen möchten, führen Sie für das vorliegende Beispiel die folgenden Kommandos aus:

docker compose down
docker volume rm wordpress-beispiel_vol-db \
 wordpress-beispiel_vol-www

docker stack deploy

Statt mit docker compose können Sie die Datei compose.yaml auch mit dem Kommando docker stack deploy verarbeiten. docker stack setzt voraus, dass der Computer Mitglied eines Docker-Schwarms ist. Sie müssen aber durchaus keinen Docker-Cluster bilden, um docker stack verwenden zu können. Es reicht vollkommen aus, wenn Sie auf Ihrem Rechner einmalig docker swarm init ausführen. Damit bildet Ihr Computer einen Docker-Schwarm, der allerdings nur aus einem einzigen Mitglied besteht. (Wie Sie »richtige« Docker-Cluster nutzen, die aus mehreren Computern zusammengesetzt sind, zeigen wir Ihnen in Kapitel 19, »Swarm«.)

docker swarm init
Swarm initiali z e d : current node ( eqbx ...) is now a manager .
To add a worker to this swarm , run the following command :
docker swarm join --token SWMTKN -xxx 10.0.0.1: 2 3 7 7
To add a manager to this swarm , run
'docker swarm join-token manager ' and follow the instruct i on s .

Um die in compose.yaml beschriebenen Container samt einem Netzwerk einzurichten, übergeben Sie an docker stack deploy mit der Option -c den Dateinamen der Compose-Datei und als weiteren Parameter den Namen des Setups bzw. des Stacks. Dieser Name wird den Netzwerk-, Volume- und Servicenamen vorangestellt. (docker compose verwendet anstelle dieses Namens standardmäßig den Namen des Verzeichnisses, in dem sich compose.yaml befindet.)

docker stack deploy -c compose .yaml stacktest
Ignoring unsupport e d options : restart
Creating network stacktes t _ d ef a u l t
Creating service stacktes t _ w or d p r e ss
Creating service stacktes t _ d b

docker stack ls beweist, dass der neue Stack eingerichtet wurde und aus zwei Services besteht:

docker stack ls
NAME        SERVICES            ORCHESTR A T O R
stacktes t  2                   Swarm

Mit docker service ls können Sie sich nun davon überzeugen, dass die Services tatsächlich erzeugt und ausgeführt werden. Die Ausgabe wurde wie üblich um einige Spalten gekürzt:

docker service ls
ID               NAME                               REPLICAS   PORTS         ...
skz4ab9p 7 1 v a stacktest _ d b                    1/1
ghdrn0z2 g i 5 n stacktest _ w o r dp r e s s       1/1        * :8082->80/ tcp

Entscheidend ist die REPLICAS -Spalte. Steht hier 0/1, ist beim Start ein Fehler aufgetreten. Aufschluss über die Fehlerursache kann die ERROR-Spalte der Ausgabe von docker service ps <sid/stackname> geben, wobei Sie die Service-ID oder den Namen des Stacks als Parameter übergeben. Das Kommando gibt an, welche Tasks in einem Service ausgeführt werden. Die ERROR-Spalte ist normalerweise so stark verkürzt, dass sie nicht aufschlussreich ist. Abhilfe schafft dann die Option --no-trunc:

docker service ps sometest --no-trunc
... NAME               ... ERROR
stacktest _ d b .1     starting container failed : Invalid
 address 10.0.1.14 : It does not belong
 to any of this network ' s subnets

Mit docker ps können Sie sich davon überzeugen, dass für jeden Service ein entsprechender Container erstellt und gestartet wurde. Anders als bei Containern gibt es bei Stacks keine Möglichkeit, sie zu stoppen und später wieder zu starten. Sie können den gesamten Stack mit all seinen Services und Netzwerken aber mit docker stack rm löschen:

docker stack rm stacktes t
Removing service stacktes t _ d b
Removing service stacktes t _ w or d p r e ss
Removing network stacktes t _ d ef a u l t

Die in compose.yaml angegebenen Volumes bleiben dabei erhalten. Daher ist es möglich, den Stack später ohne Verlust von Daten wieder einzurichten und neuerlich auszuführen:

docker stack deploy -c compose .yaml stacktest

Wenn Sie das Setup nicht mehr benötigen, löschen Sie sowohl den Stack als auch die zugeordneten Volumes:

docker stack rm stacktes t
docker volume rm stacktest_vol -db stacktest_vol-www

Debugging

Im Idealfall geht beim Start der Container durch docker compose up alles gut. Was aber, wenn Fehler auftreten? Ein erstes Hilfsmittel zur Fehlersuche besteht darin, docker compose up ohne die Option -d auszuführen. Damit erfolgen sämtliche Logging-Ausgaben aller Container direkt in der Konsole. Sie können also zu einem gewissen Grad mitverfolgen, was in den Containern vor sich geht. Alternativ können Sie mit docker ps einen Blick in die Container-Liste werfen. Dort erkennen Sie in der Regel sofort, ob es Container gibt, die nicht wie geplant laufen oder die ständig neu gestartet werden. Mit docker logs <cname> können Sie dann die Logging-Ausgaben der betroffenen Container lesen. docker compose logs zeigt das kombinierte Logging aller Container der Gruppe. Wie üblich können Sie mit docker exec einen zusätzlichen interaktiven Shell-Prozess starten und so in einen laufenden Container »hineinsehen«:

docker exec -it test_wor dp r e s s _1 / bin / sh
ps -ax
PID TTY                STAT         TIME COMMAND
1 ?                  Ss           0:00 apache2 -DFOREGRO U N D
 66 ?                  S            0:00 apache2 -DFOREGRO U N D
 ...
 78 pts /0             Ss           0:00 / bin / sh
 83 pts /0             R+           0:00 ps -ax


Interaktive Nutzung

Es ist keine gute Idee, in compose.yaml ein Image anzugeben, in dem kein Prozess dauerhaft läuft:

# Datei compose . yaml
# Containe r / Service endet sofort , weil es
# keinen Hintergr u nd p r o z es s gibt
services :
myservic e 1 :
image : alpine

Führen Sie nun docker compose up aus, wird der betreffende Container zwar eingerichtet und gestartet, aber die Ausführung endet sofort wieder. Analog sieht es aus, wenn Sie docker stack deploy ausführen: Der Service wird eingerichtet und gestartet, aber mangels Hintergrundprozess endet die Ausführung sofort wieder. Die Schwarmlogik von Docker versucht nun immer wieder, den Service zu starten – aber das hilft natürlich auch nicht. Die REPLICAS -Spalte von docker service ls zeigt 0/1, und docker service ps listet diverse Startversuche auf, zeigt aber keine Fehlermeldungen:

docker stack deploy -c compose .yaml test4
docker service ls
ID               NAME                              REPLICAS   IMAGE
1 t8cfulkp x o z test4_mys e r v i ce 1            0/1        alpine :latest
docker service ps 1t8cfulkp x o z
ID               ... DESIRED STATE              CURRENT STATE               ERROR
kolqn5wn z g p 2     Ready                      Ready 4 seconds ago
yrzb2d0g 4 a r c     Shutdown                   Complete 10 seconds ago
y3ojrkgf v 6 s w     Shutdown                   Complete a minute ago
y54o8unh q f 8 s     Shutdown                   Complete a minute ago
xayg2nje h i y j     Shutdown                   Complete 2 minutes ago

Es wird wohl eher ein Ausnahmefall sein, aber es ist möglich, mit docker compose einen Container für die interaktive Nutzung zu erzeugen. Dazu führen Sie mit docker compose das Kommando run <servicename> anstelle von up aus. Die zusätzliche Option --rm bewirkt, dass der Container nach dem Verlassen der Shell gelöscht wird.

docker compose run --rm myservice 1
cat / etc / os -release
NAME =" Alpine Linux "
PRETTY_N A ME =" Alpine Linux v3 .13"
...
exit

Eine vergleichbare interaktive Nutzungsvariante für docker stack deploy gibt es nicht. docker stack setzt auf dem Konzept von Services auf. Der interaktive Betrieb eines Service wäre aber unsinnig.