Docker/Compose/02 Einführung: Unterschied zwischen den Versionen
K Textersetzung - „bzw. “ durch „oder “ |
|||
| (20 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
== | '''Docker/Compose/02 Einführung''' - Einführungrendes Beispiel | ||
== Beschreibung == | |||
Beispiele für die Syntax von [[compose.yaml]] | |||
* zwei Services | * zwei Services | ||
** Datenbankserver MariaDB | ** Datenbankserver: MariaDB | ||
** CMS WordPress | ** 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 | * 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 | * 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 | ** 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 | * 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 | ** 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 | *Der für WordPress zuständige Webserver nutzt im Container Port 80 | ||
** Dieser Port soll mit Port 8082 des Host-Rechners verbunden werden | ** Dieser Port soll mit Port 8082 des Host-Rechners verbunden werden | ||
; compose.yaml | ; compose.yaml | ||
| Zeile 49: | Zeile 50: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== 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 | |||
<syntaxhighlight lang="bash" highlight="1" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
cd wordpress-beispiel # (Verzeichnis mit compose.yaml) | cd wordpress-beispiel # (Verzeichnis mit compose.yaml) | ||
| Zeile 63: | Zeile 79: | ||
<syntaxhighlight lang="bash" highlight="1" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker compose up -d | docker compose up -d | ||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="" line> | |||
Creating network wordpress-beispiel_default with the default driver | Creating network wordpress-beispiel_default with the default driver | ||
Creating wordpress-beispiel_wordpress_1 ... done | Creating wordpress-beispiel_wordpress_1 ... done | ||
| Zeile 112: | Zeile 130: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== docker stack deploy == | |||
Statt mit docker compose können Sie die Datei compose.yaml auch mit dem Kommando docker stack deploy verarbeiten | 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 | * docker stack setzt voraus, dass der Computer Mitglied eines Docker-Schwarms ist | ||
| Zeile 118: | Zeile 136: | ||
* Es reicht vollkommen aus, wenn Sie auf Ihrem Rechner einmalig docker swarm init ausführen | * 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 | * Damit bildet Ihr Computer einen Docker-Schwarm, der allerdings nur aus einem einzigen Mitglied besteht | ||
Siehe auch | |||
* [[Docker/Swarm]] | |||
; docker swarm init | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker swarm init | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="" line> | |||
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 | |||
</syntaxhighlight> | |||
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 | |||
docker stack | 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 | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
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 | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="" line> | |||
NAME SERVICES ORCHESTRATOR | |||
stacktest 2 Swarm | |||
</syntaxhighlight> | |||
Mit docker service ls können Sie sich nun davon überzeugen, dass die Services tatsächlich erzeugt und ausgeführt werden | 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 | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="1" line copy> | |||
ID NAME REPLICAS PORTS ... | |||
skz4ab9p71va stacktest_db 1/1 | |||
ghdrn0z2gi5n stacktest_wordpress 1/1 *:8082->80/ tcp | |||
</syntaxhighlight> | |||
; 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 | * Die ERROR-Spalte ist normalerweise so stark verkürzt, dass sie nicht aufschlussreich ist | ||
* Abhilfe schafft dann die Option --no-trunc: | * Abhilfe schafft dann die Option --no-trunc: | ||
<syntaxhighlight lang="bash" highlight="1" line copy> | |||
docker service ps sometest --no-trunc | |||
</syntaxhighlight> | |||
<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> | |||
; 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 | |||
<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> | |||
; Stack widerherstellen | |||
In ''compose.yaml'' angegebenen Volumes bleiben erhalten | |||
* So kann der Stack ohne Verlust von Daten wieder eingerichtet und gestartet werden | |||
<syntaxhighlight lang="bash" highlight="1" line copy> | |||
docker stack deploy -c compose.yaml stacktest | |||
</syntaxhighlight> | |||
Wenn Sie das Setup nicht mehr benötigen, löschen Sie sowohl den Stack als auch die zugeordneten Volumes: | Wenn Sie das Setup nicht mehr benötigen, löschen Sie sowohl den Stack als auch die zugeordneten Volumes: | ||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker stack rm stacktest | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="" line> | |||
docker volume rm stacktest_vol-db stacktest_vol-www | |||
</syntaxhighlight> | |||
== 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 | 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 | * 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 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 | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker exec -it test_wordpress_1 /bin/sh | |||
</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> | |||
== Interaktive Nutzung == | |||
Es ist keine gute Idee, in compose.yaml ein Image anzugeben, in dem kein Prozess dauerhaft läuft | |||
Es ist keine gute Idee, in compose.yaml ein Image anzugeben, in dem kein Prozess dauerhaft läuft | <syntaxhighlight lang="yaml" highlight="" line copy> | ||
# Datei compose.yaml | |||
# Container/Service endet sofort, weil es keinen Hintergrundprozess gibt | |||
services: | |||
myservice1: | |||
image: alpine | |||
</syntaxhighlight> | |||
Führen Sie nun docker compose up aus, wird der betreffende Container zwar eingerichtet und gestartet, aber die Ausführung endet sofort wieder | 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 | * 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 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: | * Die REPLICAS-Spalte von ''docker service ls'' zeigt 0/1, und ''docker service ps'' listet diverse Startversuche auf, zeigt aber keine Fehlermeldungen: | ||
<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> | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker service ps 1t8cfulkpxoz | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="1" line> | |||
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 | |||
</syntaxhighlight> | |||
Es wird wohl eher ein Ausnahmefall sein, aber es ist möglich, mit docker compose einen Container für die interaktive Nutzung zu erzeugen | 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 | * Dazu führen Sie mit docker 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 | |||
<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> | |||
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 | |||
[[Kategorie:Docker/Compose]] | [[Kategorie:Docker/Compose]] | ||
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 …
- Verzeichnisname wird zur Benennung verwendet
- 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