Docker/Compose/02 Einführung: Unterschied zwischen den Versionen
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: | ||
'''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 | |||
image : | <syntaxhighlight lang="yaml" highlight="0" line copy> | ||
volumes : | # Dateicompose.yaml | ||
- vol - | services: | ||
db: | |||
image: mariadb:latest | |||
volumes: | |||
- vol-db:/var/lib/mysql | |||
environment: | |||
MYSQL_RANDOM_ROOT_PASSWORD: 1 | |||
MYSQL_DATABASE: wp | |||
restart : always | MYSQL_USER: wpuser | ||
MYSQL_PASSWORD: geheim | |||
restart: always | |||
volumes : | wordpress: | ||
vol - www : | 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: | |||
</syntaxhighlight> | |||
docker compose | == docker compose == | ||
; docker compose starten | |||
Datei compose.yaml | * wechseln Sie zuerst in das Verzeichnis mit der Datei compose.yaml | ||
** hier: ''wordpress-beispiel '' | |||
cd 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> | |||
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 - | </syntaxhighlight> | ||
driver | <syntaxhighlight lang="bash" highlight="" line> | ||
Creating wordpress - | Creating network wordpress-beispiel_default with the default driver | ||
Creating wordpress - | Creating wordpress-beispiel_wordpress_1 ... done | ||
Creating wordpress-beispiel_db_1 ... done | |||
</syntaxhighlight> | |||
; docker ps | |||
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 | 5211... 0.0.0.0:8082->80/tcp wordpress -beispiel_wordpress_1 | ||
d9dc ... 3306/ tcp wordpress - | d9dc ... 3306/ tcp wordpress -beispiel_db_1 | ||
</syntaxhighlight> | |||
; docker compose stop | |||
Ausführung aller zusammengehörenden Container stoppen | |||
* Analog setzt ''docker compose start'' die Ausführung fort | |||
docker compose down | Diese Kommandos setzen voraus, dass sie in dem Verzeichnis mit compose.yaml gestartet werden | ||
docker compose up | ; 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> | |||
; Container neu einrichten | |||
<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> | ||
<syntaxhighlight lang="bash" highlight="1" line copy> | |||
docker volume rm wordpress-beispiel_vol-db wordpress-beispiel_vol-www | |||
</syntaxhighlight> | |||
== 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 | |||
keinen | * 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 | 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: | 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 | '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 | |||
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 | <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 | docker stack ls | ||
NAME SERVICES | </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 | |||
<syntaxhighlight lang="bash" highlight="1" line copy> | |||
docker service ls | docker service ls | ||
ID NAME | </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 | |||
* 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 | |||
docker stack rm | ; Stack löschen | ||
docker | 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: | |||
<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 | |||
den | </syntaxhighlight> | ||
docker | == 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 | ; 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 | |||
<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> | |||
# Datei compose . yaml | == Interaktive Nutzung == | ||
# | Es ist keine gute Idee, in compose.yaml ein Image anzugeben, in dem kein Prozess dauerhaft läuft | ||
<syntaxhighlight lang="yaml" highlight="" line copy> | |||
services : | # Datei compose.yaml | ||
# 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 | 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: | |||
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 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: | |||
natürlich auch nicht | |||
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 | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker service ps 1t8cfulkpxoz | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="1" line> | |||
ID | 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 | |||
* 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 | <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]] | |||
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