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…“
 
K Textersetzung - „bzw. “ durch „oder “
 
(31 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
5.2 Hello Compose!
'''Docker/Compose/02 Einführung''' - Einführungrendes Beispiel
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
== Beschreibung ==
benannte Volumes verwendet. (Die Namen der Volumes müssen zweimal ange-
Beispiele für die Syntax von [[compose.yaml]]
geben werden, einmal bei der Beschreibung der jeweiligen Services und ein zwei-
* zwei Services
tes Mal – üblicherweise am Ende der Datei compose.yaml – in einem separaten
** Datenbankserver: MariaDB
Abschnitt volumes.)
** CMS: WordPress
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
== Einstellungen ==
services :
Zur Speicherung der Datenbankdateien oder der HTML-Dateien werden jeweils benannte Volumes verwendet
db :
* 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
image : mariadb : latest
* In MariaDB sollen die Datenbank wp und der dazugehörende Benutzer wpuser mit dem Passwort geheim eingerichtet werden
volumes :
** Als root-Passwort kann eine zufällige Zeichenkette verwendet werden – es ist für das Setup nicht relevant
- vol - db :/ var / lib /mysql
* Damit WordPress auf die Datenbank zugreifen kann, müssen die entsprechenden WORDPRESS‑Variablen initialisiert werden
environm en t :
** DB_HOST verweist auf den Servicenamen db und die Defaultportnummer des MariaDB-Servers
MYSQL_RAN D O M_ R O O T _P A S S W OR D :  1
*Der für WordPress zuständige Webserver nutzt im Container Port 80
MYSQL_DAT A B AS E :                        wp
** Dieser Port soll mit Port 8082 des Host-Rechners verbunden werden
MYSQL_USE R :                                wpuser
MYSQL_PAS S W OR D :                        geheim
restart : always


wordpres s :
; compose.yaml
image : wordpress : latest
<syntaxhighlight lang="yaml" highlight="0" line copy>
volumes :
# Dateicompose.yaml
- vol - www :/ var / www / html /wp - content
services:
ports :
db:
- "8082:80 "
  image: mariadb:latest
environm en t :
  volumes:
WORDPRESS _ D B_ H O S T :        db :3306
    - vol-db:/var/lib/mysql
WORDPRESS _ D B_ U S E R :       wpuser
  environment:
WORDPRESS _ D B_ N A M E :        wp
      MYSQL_RANDOM_ROOT_PASSWORD:   1
WORDPRESS _ D B_ P A S S WO R D : geheim
      MYSQL_DATABASE:               wp
restart : always
      MYSQL_USER:                   wpuser
      MYSQL_PASSWORD:               geheim
  restart: always


volumes :
  wordpress:
vol - www :
    image: wordpress:latest
vol - db :
    volumes:
    - vol-www:/var/www/html/wp-content
    ports:
    - "8082:80 "
    environment:
      WORDPRESS_DB_HOST:        db:3306
      WORDPRESS_DB_USER:        wpuser
      WORDPRESS_DB_NAME:        wp
      WORDPRESS_DB_PASSWORD:    geheim
    restart: always


  volumes:
5 Container-Setups mit »compose«
    vol-www:
    vol-db:
</syntaxhighlight>


docker compose
== docker compose ==
Um docker compose auszuprobieren, wechseln Sie zuerst in das Verzeichnis mit der
; docker compose starten
Datei compose.yaml – hier wordpress-beispiel . Beachten Sie, dass der Verzeichnisname
* wechseln Sie zuerst in das Verzeichnis mit der Datei compose.yaml
zur Benennung der Container, Volumes, Netzwerke usw. verwendet wird.
** hier: ''wordpress-beispiel ''
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 )
; Achtung
:* Verzeichnisname wird zur Benennung verwendet
:** Container
:** Volumes
:** Netzwerke …
 
: docker compose up -d
* sucht im aktuellen Verzeichnis nach der Datei compose.yaml
* lädt erforderliche Images herunter
* erzeugt die Container
* verbindet diese in einem dafür erzeugten Netzwerk
* startet Hintergrundprozesse (Option -d)
 
Der gesamte Vorgang dauert nur wenige Sekunden
* plus die Zeit zum Download der Images
 
; restart: always
Container werden wegen ''restart: always'' nach einem Neustart des Rechners automatisch gestartet
<syntaxhighlight lang="bash" highlight="1" copy>
cd wordpress-beispiel      # (Verzeichnis mit compose.yaml)
</syntaxhighlight>
 
<syntaxhighlight lang="bash" highlight="1" copy>
docker compose up -d
docker compose up -d
Creating network wordpress - beispiel_ d e f a ul t " with the default
</syntaxhighlight>
driver
<syntaxhighlight lang="bash" highlight="" line>
Creating wordpress - beispiel _ wo r d p r es s _ 1 ... done
Creating network wordpress-beispiel_default with the default driver
Creating wordpress - beispiel _ db _ 1              ... done
Creating wordpress-beispiel_wordpress_1 ... done
Creating wordpress-beispiel_db_1        ... done
</syntaxhighlight>


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


<syntaxhighlight lang="bash" highlight="1" copy>
docker ps
docker ps
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" line>
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_wordpress_1
d9dc ...    3306/ tcp                      wordpress -beispiel _ d b _1
d9dc ...    3306/ tcp                      wordpress -beispiel_db_1
</syntaxhighlight>


Um die Ausführung aller zusammengehörenden Container zu stoppen, führen Sie
; docker compose stop
docker compose stop aus. Analog setzt docker compose start die Ausführung fort.
Ausführung aller zusammengehörenden Container stoppen
Diese Kommandos setzen jeweils voraus, dass sich compose.yaml im aktuellen Ver-
* Analog setzt ''docker compose start'' die Ausführung fort
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 )
Diese Kommandos setzen voraus, dass sie in dem Verzeichnis mit compose.yaml gestartet werden
...
 
docker compose up -d                ( Containe r neu einrichte n )
; docker compose down  
Stoppen und löschen Sie alle Container der Setups
* Die Volumes bleiben erhalten
 
; docker compose up
Die Container können unter Beibehaltung der bisherigen Daten neu eingerichtet werden
<syntaxhighlight lang="bash" highlight="1" line copy>
; Container stoppen und löschen
docker compose down               
</syntaxhighlight>


Wenn Sie die Container und die dazugehörenden Volumes löschen möchten, führen
; Container neu einrichten
Sie für das vorliegende Beispiel die folgenden Kommandos aus:
<syntaxhighlight lang="bash" highlight="1" line copy>
docker compose up -d               
</syntaxhighlight>


; Container löschen
<syntaxhighlight lang="bash" highlight="1" line copy>
docker compose down
docker compose down
docker volume rm wordpress - beispiel_vol - db \
</syntaxhighlight>
wordpress - beispiel_vol - www
<syntaxhighlight lang="bash" highlight="1" line copy>
docker volume rm wordpress-beispiel_vol-db wordpress-beispiel_vol-www
</syntaxhighlight>


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
durch das Kommando podman-compose ersetzen. Es gibt aber einen kleinen Unter-
* docker stack setzt voraus, dass der Computer Mitglied eines Docker-Schwarms ist
schied: Unter Docker bewirken die beiden Zeilen restart: always einen automati-
* Sie müssen aber durchaus keinen Docker-Cluster bilden, um docker stack verwenden zu können
schen Neustart der Container nach einem Reboot des Rechners. Bei Podman gibt es
* Es reicht vollkommen aus, wenn Sie auf Ihrem Rechner einmalig docker swarm init ausführen
keinen Hintergrunddienst, der sich darum kümmern kann. Dementsprechend müs-
* Damit bildet Ihr Computer einen Docker-Schwarm, der allerdings nur aus einem einzigen Mitglied besteht
sen Sie das Container-Setup bei Bedarf selbst wieder neu starten.


docker stack deploy
Siehe auch
Statt mit docker compose können Sie die Datei compose.yaml auch mit dem Kommando
* [[Docker/Swarm]]
docker stack deploy verarbeiten. docker stack setzt voraus, dass der Computer Mit-
glied 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 Compu-
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
<syntaxhighlight lang="bash" highlight="1" copy>
docker swarm init
docker swarm init
Swarm initiali z e d : current node ( eqbx ...) is now a manager .
</syntaxhighlight>
To add a worker to this swarm , run the following command :
<syntaxhighlight lang="bash" highlight="" line>
docker swarm join --token SWMTKN -xxx 10.0.0.1: 2 3 7 7
Swarm initiali z e d : current node ( eqbx ...) is now a manager  
To add a manager to this swarm , run
To add a worker to this swarm, run the following command :
'docker swarm join - token manager ' and follow the instruct i on s .
'docker swarm join --token SWMTKN -xxx 10.0.0.1:2377'
 
To add a manager to this swarm, run
Um die in compose.yaml beschriebenen Container samt einem Netzwerk einzurich-
'docker swarm join-token manager' and follow the instructions
ten, übergeben Sie an docker stack deploy mit der Option -c den Dateinamen der
</syntaxhighlight>
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 Verzeich-
nisses, 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


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 oder des Stacks


5 Container-Setups mit »compose«
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 ls beweist, dass der neue Stack eingerichtet wurde und aus zwei Ser-
<syntaxhighlight lang="bash" highlight="1" copy>
vices besteht:
docker stack deploy -c compose.yaml stacktest
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="" line>
Ignoring unsupported options: restart
Creating network stacktes t_default
Creating service stacktes t_wordpress
Creating service stacktes t_db
</syntaxhighlight>


; docker stack ls
Beweist, dass der neue Stack eingerichtet wurde und aus zwei Services besteht
<syntaxhighlight lang="bash" highlight="1" copy>
docker stack ls
docker stack ls
NAME        SERVICES           ORCHESTR A T O R
</syntaxhighlight>
stacktes t  2                   Swarm
<syntaxhighlight lang="bash" highlight="" line>
 
NAME        SERVICES   ORCHESTRATOR
Mit docker service ls können Sie sich nun davon überzeugen, dass die Services tat-
stacktest  2         Swarm
sächlich erzeugt und ausgeführt werden. Die Ausgabe wurde wie üblich um einige
</syntaxhighlight>
Spalten gekürzt:


Mit docker service ls können Sie sich nun davon überzeugen, dass die Services tatsächlich erzeugt und ausgeführt werden
<syntaxhighlight lang="bash" highlight="1" line copy>
docker service ls
docker service ls
ID              NAME                               REPLICAS  PORTS        ...
</syntaxhighlight>
skz4ab9p 7 1 v a stacktest _ d b                    1/1
<syntaxhighlight lang="bash" highlight="1" line copy>
ghdrn0z2 g i 5 n stacktest _ w o r dp r e s s      1/1        * :8082 - >80/ tcp
ID              NAME                   REPLICAS  PORTS        ...
Entscheidend ist die REPLICAS -Spalte. Steht hier 0/1, ist beim Start ein Fehler auf-
skz4ab9p71va    stacktest_db          1/1
getreten. Aufschluss über die Fehlerursache kann die ERROR-Spalte der Ausgabe von
ghdrn0z2gi5n    stacktest_wordpress    1/1        *:8082->80/ tcp
docker service ps <sid/stackname> geben, wobei Sie die Service-ID oder den Namen
</syntaxhighlight>
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
; Spalte REPLICAS
... NAME              ... ERROR
* Steht hier 0/1, ist beim Start ein Fehler aufgetreten
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 entspre-
Aufschluss über die Fehlerursache kann die ERROR-Spalte der Ausgabe von ''docker service ps <sid/stackname>'' geben
chender Container erstellt und gestartet wurde.
* Service-ID oder den Namen des Stacks als Parameter übergeben
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
Das Kommando gibt an, welche Tasks in einem Service ausgeführt werden
Removing service stacktes t _ d b
* Die ERROR-Spalte ist normalerweise so stark verkürzt, dass sie nicht aufschlussreich ist
Removing service stacktes t _ w or d p r e ss
* Abhilfe schafft dann die Option --no-trunc:
Removing network stacktes t _ d ef a u l t


Die in compose.yaml angegebenen Volumes bleiben dabei erhalten. Daher ist es mög-
<syntaxhighlight lang="bash" highlight="1" line copy>
lich, den Stack später ohne Verlust von Daten wieder einzurichten und neuerlich
docker service ps sometest --no-trunc
auszuführen:
</syntaxhighlight>


docker stack deploy -c compose .yaml stacktest
<syntaxhighlight lang="bash" highlight="1" line copy>
... NAME            ...  ERROR
    stacktest_db.1      starting container failed: Invalid
                        address 10.0.1.14: It does not belong
                        to any of this network's subnets
</syntaxhighlight>


Wenn Sie das Setup nicht mehr benötigen, löschen Sie sowohl den Stack als auch die
; docker ps
zugeordneten Volumes:
Zeigt, 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


docker stack rm stacktes t
; Stack löschen
docker volume rm stacktest_vol -db stacktest_vol - www
Gesamten Stack mit all seinen Services und Netzwerken mit ''docker stack rm'' löschen
<syntaxhighlight lang="bash" highlight="1" copy>
docker stack rm stacktest
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="" line>
Removing service stacktes t_db
Removing service stacktes t_wordpress
Removing network stacktes t_default
</syntaxhighlight>


Podman
; Stack widerherstellen
Unter Podman fehlen Kommandos, die mit docker swarm und docker stack kompati-
In ''compose.yaml'' angegebenen Volumes bleiben erhalten
bel sind. Dafür gibt es mit podman pod eine andere Möglichkeit, Container-Gruppen zu
* So kann der Stack ohne Verlust von Daten wieder eingerichtet und gestartet werden
erzeugen. In diesem Buch gehen wir auf podman pod gar nicht und auf docker stack
<syntaxhighlight lang="bash" highlight="1" line copy>
nur noch am Rande ein. (Dafür beschäftigen wir uns ausführlich mit Docker Swarm,
docker stack deploy -c compose.yaml stacktest
siehe Kapitel 19.) Unser Fokus bleibt stattdessen auf dem Compose-Feature, das in
</syntaxhighlight>
beiden Systemen zur Verfügung steht und in der Praxis von größter Bedeutung ist.


Debugging
Wenn Sie das Setup nicht mehr benötigen, löschen Sie sowohl den Stack als auch die zugeordneten Volumes:
Im Idealfall geht beim Start der Container durch docker compose up alles gut. Was aber,
<syntaxhighlight lang="bash" highlight="1" copy>
wenn Fehler auftreten?
docker stack rm stacktest
Ein erstes Hilfsmittel zur Fehlersuche besteht darin, docker compose up ohne die
</syntaxhighlight>
Option -d auszuführen. Damit erfolgen sämtliche Logging-Ausgaben aller Container
<syntaxhighlight lang="bash" highlight="" line>
direkt in der Konsole. Sie können also zu einem gewissen Grad mitverfolgen, was in
docker volume rm stacktest_vol-db stacktest_vol-www
den Containern vor sich geht.
</syntaxhighlight>
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
== Debugging ==
; Erstes Hilfsmittel
* ''docker compose up'' ohne die Option -d ausfü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


ps -ax
; docker ps
PID TTY                STAT        TIME COMMAND
Alternativ können Sie mit docker ps einen Blick in die Container-Liste werfen
1 ?                  Ss          0:00 apache2 -DFOREGRO U N D
* Dort erkennen Sie in der Regel sofort, ob es Container gibt, die nicht wie geplant laufen oder die ständig neu gestartet werden
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


; docker logs
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


5 Container-Setups mit »compose«
; docker exec
Wie üblich können Sie mit docker exec einen zusätzlichen interaktiven Shell-Prozess starten und so in einen laufenden Container hineinsehen


Interaktive Nutzung
<syntaxhighlight lang="bash" highlight="1" copy>
Es ist keine gute Idee, in compose.yaml ein Image anzugeben, in dem kein Prozess dau-
docker exec -it test_wordpress_1 /bin/sh
erhaft läuft:
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" copy>
ps -ax
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="0" line>
PID TTY      STAT    TIME  COMMAND
1  ?        Ss      0:00  apache2 -DFOREGROUND
66  ?        S      0:00  apache2 -DFOREGROUND
...
78  pts/0    Ss      0:00  /bin/sh
83  pts/0    R+      0:00  ps -ax
</syntaxhighlight>


# Datei compose . yaml
== Interaktive Nutzung ==
# Containe r / Service endet sofort , weil es
Es ist keine gute Idee, in compose.yaml ein Image anzugeben, in dem kein Prozess dauerhaft läuft
# keinen Hintergr u nd p r o z es s gibt
<syntaxhighlight lang="yaml" highlight="" line copy>
services :
# Datei compose.yaml
myservic e 1 :
# Container/Service endet sofort, weil es keinen Hintergrundprozess gibt
image : alpine
services:
  myservice1:
    image: alpine
</syntaxhighlight>


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
richtet und gestartet, aber die Ausführung endet sofort wieder. Analog sieht es aus,
* Analog sieht es aus, wenn Sie docker stack deploy ausführen:  
wenn Sie docker stack deploy ausführen: Der Service wird eingerichtet und gestartet,
** Der Service wird eingerichtet und gestartet, aber mangels Hintergrundprozess endet die Ausführung sofort wieder
aber mangels Hintergrundprozess endet die Ausführung sofort wieder. Die Schwarm-
* Die Schwarmlogik von Docker versucht nun immer wieder, den Service zu starten – aber das hilft natürlich auch nicht
logik von Docker versucht nun immer wieder, den Service zu starten – aber das hilft
* Die REPLICAS-Spalte von ''docker service ls'' zeigt 0/1, und ''docker service ps'' listet diverse Startversuche auf, zeigt aber keine Fehlermeldungen:
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
<syntaxhighlight lang="bash" highlight="1" copy>
docker stack deploy -c compose.yaml test4
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" copy>
docker service ls
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="" line>
ID              NAME                        REPLICAS  IMAGE
1t8cfulkpxoz    test4_myservice1            0/1        alpine :latest
</syntaxhighlight>


docker service ls
<syntaxhighlight lang="bash" highlight="1" copy>
ID              NAME                              REPLICAS  IMAGE
docker service ps 1t8cfulkpxoz
1 t8cfulkp x o z test4_mys e r v i ce 1            0/1        alpine :latest
</syntaxhighlight>


docker service ps 1t8cfulkp x o z
<syntaxhighlight lang="bash" highlight="1" line>
ID               ... DESIRED STATE              CURRENT STATE              ERROR
ID           ... DESIRED STATE              CURRENT STATE              ERROR
kolqn5wn z g p 2    Ready                      Ready 4 seconds ago
kolqn5wnzgp2      Ready                      Ready 4 seconds ago
yrzb2d0g 4 a r c    Shutdown                  Complete 10 seconds ago
yrzb2d0g4arc      Shutdown                  Complete 10 seconds ago
y3ojrkgf v 6 s w    Shutdown                  Complete a minute ago
y3ojrkgfv6sw      Shutdown                  Complete a minute ago
y54o8unh q f 8 s    Shutdown                  Complete a minute ago
y54o8unhqf8s      Shutdown                  Complete a minute ago
xayg2nje h i y j    Shutdown                  Complete 2 minutes ago
xayg2njehiyj      Shutdown                  Complete 2 minutes ago
</syntaxhighlight>


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
einen Container für die interaktive Nutzung zu erzeugen. Dazu führen Sie mit docker
* Dazu führen Sie mit docker compose das Kommando run <servicename> anstelle von up aus
compose das Kommando run <servicename> anstelle von up aus. Die zusätzliche Option
* 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
<syntaxhighlight lang="bash" highlight="1" line copy>
docker compose run --rm myservice1
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" line copy>
cat /etc/os-release
NAME="Alpine Linux"
PRETTY_NAME ="Alpine Linux v3 .13"
...
exit
</syntaxhighlight>


cat / etc / os -release
Eine vergleichbare interaktive Nutzungsvariante für ''docker stack deploy'' gibt es nicht
NAME =" Alpine Linux "
* ''docker stack'' setzt auf dem Konzept von Services auf
PRETTY_N A ME =" Alpine Linux v3 .13"
* Der interaktive Betrieb eines Service wäre aber unsinnig
...
exit


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

Aktuelle Version vom 18. November 2026, 13:54 Uhr

Docker/Compose/02 Einführung - Einführungrendes Beispiel

Beschreibung

Beispiele für die Syntax von compose.yaml

  • zwei Services
    • Datenbankserver: MariaDB
    • CMS: WordPress

Einstellungen

Zur Speicherung der Datenbankdateien oder 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
compose.yaml
# Dateicompose.yaml
services:
 db:
   image: mariadb:latest
   volumes:
     - vol-db:/var/lib/mysql
   environment:
      MYSQL_RANDOM_ROOT_PASSWORD:   1
      MYSQL_DATABASE:               wp
      MYSQL_USER:                   wpuser
      MYSQL_PASSWORD:               geheim
   restart: always

  wordpress:
    image: wordpress:latest
    volumes:
    - vol-www:/var/www/html/wp-content
    ports:
    - "8082:80 "
    environment:
      WORDPRESS_DB_HOST:        db:3306
      WORDPRESS_DB_USER:        wpuser
      WORDPRESS_DB_NAME:        wp
      WORDPRESS_DB_PASSWORD:    geheim
    restart: always

   volumes:
     vol-www:
     vol-db:

docker compose

docker compose starten
  • wechseln Sie zuerst in das Verzeichnis mit der Datei compose.yaml
    • hier: wordpress-beispiel
Achtung
  • Verzeichnisname wird zur Benennung verwendet
    • Container
    • Volumes
    • Netzwerke …
docker compose up -d
  • sucht im aktuellen Verzeichnis nach der Datei compose.yaml
  • lädt erforderliche Images herunter
  • erzeugt die Container
  • verbindet diese in einem dafür erzeugten Netzwerk
  • startet Hintergrundprozesse (Option -d)

Der gesamte Vorgang dauert nur wenige Sekunden

  • plus die Zeit zum Download der Images
restart
always

Container werden wegen restart: always nach einem Neustart des Rechners automatisch gestartet

cd wordpress-beispiel       # (Verzeichnis mit compose.yaml)
docker compose up -d
Creating network wordpress-beispiel_default with the default driver
Creating wordpress-beispiel_wordpress_1 ... done
Creating wordpress-beispiel_db_1        ... done
docker ps

Laufenden Container anzeigen

  • 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_wordpress_1
d9dc ...    3306/ tcp                      wordpress -beispiel_db_1
docker compose stop

Ausführung aller zusammengehörenden Container stoppen

  • Analog setzt docker compose start die Ausführung fort

Diese Kommandos setzen voraus, dass sie in dem Verzeichnis mit compose.yaml gestartet werden

docker compose down

Stoppen und löschen Sie alle Container der Setups

  • Die Volumes bleiben erhalten
docker compose up

Die Container können unter Beibehaltung der bisherigen Daten neu eingerichtet werden

; Container stoppen und löschen
docker compose down
Container neu einrichten
docker compose up -d
Container löschen
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

Siehe auch

docker swarm init
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:2377'
To add a manager to this swarm, run
 'docker swarm join-token manager' and follow the instructions

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 oder 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 unsupported options: restart
Creating network stacktes t_default
Creating service stacktes t_wordpress
Creating service stacktes t_db
docker stack ls

Beweist, dass der neue Stack eingerichtet wurde und aus zwei Services besteht

docker stack ls
NAME        SERVICES   ORCHESTRATOR
stacktest   2          Swarm

Mit docker service ls können Sie sich nun davon überzeugen, dass die Services tatsächlich erzeugt und ausgeführt werden

docker service ls
ID               NAME                   REPLICAS   PORTS         ...
skz4ab9p71va     stacktest_db           1/1
ghdrn0z2gi5n     stacktest_wordpress    1/1        *:8082->80/ tcp
Spalte REPLICAS
  • 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

  • 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_db.1       starting container failed: Invalid
                         address 10.0.1.14: It does not belong
                         to any of this network's subnets
docker ps

Zeigt, 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
Stack löschen

Gesamten Stack mit all seinen Services und Netzwerken mit docker stack rm löschen

docker stack rm stacktest
Removing service stacktes t_db
Removing service stacktes t_wordpress
Removing network stacktes t_default
Stack widerherstellen

In compose.yaml angegebenen Volumes bleiben erhalten

  • So kann der Stack ohne Verlust von Daten wieder eingerichtet und gestartet werden
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 stacktest
docker volume rm stacktest_vol-db stacktest_vol-www

Debugging

Erstes Hilfsmittel
  • docker compose up ohne die Option -d ausfü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
docker ps

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
docker logs

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
docker exec

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_wordpress_1 /bin/sh
ps -ax
PID TTY       STAT    TIME   COMMAND
1   ?         Ss      0:00   apache2 -DFOREGROUND
66  ?         S       0:00   apache2 -DFOREGROUND
...
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
# Container/Service endet sofort, weil es keinen Hintergrundprozess gibt
services:
  myservice1:
    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
1t8cfulkpxoz    test4_myservice1            0/1        alpine :latest
docker service ps 1t8cfulkpxoz
ID            ... DESIRED STATE              CURRENT STATE               ERROR
kolqn5wnzgp2      Ready                      Ready 4 seconds ago
yrzb2d0g4arc      Shutdown                   Complete 10 seconds ago
y3ojrkgfv6sw      Shutdown                   Complete a minute ago
y54o8unhqf8s      Shutdown                   Complete a minute ago
xayg2njehiyj      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 myservice1
cat /etc/os-release
NAME="Alpine Linux"
PRETTY_NAME ="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