Docker/Compose/02 Einführung: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
Keine Bearbeitungszusammenfassung |
||
| Zeile 1: | Zeile 1: | ||
== Hello Compose! == | == 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 | 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 | (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: | 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 | Zur Speicherung der Datenbankdateien bzw. der HTML-Dateien werden jeweils benannte Volumes verwendet | ||
In MariaDB sollen die Datenbank wp und der dazugehörende Benutzer wpuser mit dem Passwort geheim eingerichtet werden | * 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 | ||
Damit WordPress auf die Datenbank zugreifen kann, müssen die entsprechenden WORDPRESS -Variablen initialisiert werden | In MariaDB sollen die Datenbank wp und der dazugehörende Benutzer wpuser mit dem Passwort geheim eingerichtet werden | ||
Der für WordPress zuständige Webserver nutzt im Container Port 80 | * 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 : | ||
| Zeile 21: | Zeile 25: | ||
MYSQL_PAS S W OR D : geheim | MYSQL_PAS S W OR D : geheim | ||
restart : always | restart : always | ||
wordpres s : | wordpres s : | ||
image : wordpress : latest | image : wordpress : latest | ||
| Zeile 41: | Zeile 45: | ||
=== docker compose === | === docker compose === | ||
Um docker compose auszuprobieren, wechseln Sie zuerst in das Verzeichnis mit der Datei compose.yaml – hier wordpress-beispiel | Um docker compose auszuprobieren, wechseln Sie zuerst in das Verzeichnis mit der Datei compose.yaml – 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) | * 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 ) | cd wordpress-beispiel ( Verzeichn i s mit compose.* yaml ) | ||
docker compose up -d | docker compose up -d | ||
Creating network wordpress-beispiel_ d e f a ul t " with the default | Creating network wordpress-beispiel_ d e f a ul t " with the default | ||
| Zeile 52: | Zeile 59: | ||
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 | 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 | ||
| Zeile 59: | Zeile 66: | ||
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 docker compose stop aus | Um die Ausführung aller zusammengehörenden Container zu stoppen, führen Sie docker compose stop aus | ||
Diese Kommandos setzen jeweils voraus, dass sich compose.yaml im aktuellen Verzeichnis befindet | * Analog setzt docker compose start die Ausführung fort | ||
Mit docker compose down stoppen und löschen Sie alle Container der Setups | |||
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 down ( Containe r stoppen und l ö schen ) | ||
| Zeile 74: | Zeile 86: | ||
=== docker stack deploy === | === 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 | |||
* 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«.) | (Wie Sie »richtige« Docker-Cluster nutzen, die aus mehreren Computern zusammengesetzt sind, zeigen wir Ihnen in Kapitel 19, »Swarm«.) | ||
docker swarm init | docker swarm init | ||
Swarm initiali z e d : current node ( eqbx ...) is now a manager | Swarm initiali z e d : current node ( eqbx ...) is now a manager | ||
To add a worker to this swarm , run the following command : | 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 | docker swarm join --token SWMTKN -xxx 10.0.0.1: 2 3 7 7 | ||
To add a manager to this swarm , run | To add a manager to this swarm , run | ||
'docker swarm join-token manager ' and follow the instruct i on s | '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 | 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.) | 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.) | ||
| Zeile 99: | Zeile 116: | ||
stacktes t 2 Swarm | 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 | 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 | docker service ls | ||
| Zeile 106: | Zeile 124: | ||
ghdrn0z2 g i 5 n stacktest _ w o r dp r e s s 1/1 * :8082->80/ tcp | ghdrn0z2 g i 5 n stacktest _ w o r dp r e s s 1/1 * :8082->80/ tcp | ||
Entscheidend ist die REPLICAS -Spalte | 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 | docker service ps sometest --no-trunc | ||
... NAME ... ERROR | ... | ||
* NAME ... | |||
* ERROR | |||
stacktest _ d b .1 starting container failed : Invalid | stacktest _ d b .1 starting container failed : Invalid | ||
address 10.0.1.14 : It does not belong | address 10.0.1.14 : It does not belong | ||
to any of this network ' s subnets | 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 | 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 | 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 rm stacktes t | ||
| Zeile 122: | Zeile 148: | ||
Removing network stacktes t _ d ef a u l t | Removing network stacktes t _ d ef a u l t | ||
Die in compose.yaml angegebenen Volumes bleiben dabei erhalten | 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 | docker stack deploy -c compose .yaml stacktest | ||
| Zeile 132: | Zeile 159: | ||
=== Debugging === | === Debugging === | ||
Im Idealfall geht beim Start der Container durch docker compose up alles gut | Im Idealfall geht beim Start der Container durch docker compose up alles gut | ||
Ein erstes Hilfsmittel zur Fehlersuche besteht darin, docker compose up ohne die Option -d auszuführen | * Was aber, wenn Fehler auftreten? | ||
Alternativ können Sie mit docker ps einen Blick in die Container-Liste werfen | 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«: | Wie üblich können Sie mit docker exec einen zusätzlichen interaktiven Shell-Prozess starten und so in einen laufenden Container »hineinsehen«: | ||
| Zeile 151: | Zeile 184: | ||
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: | ||
# 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 | ||
| Zeile 158: | Zeile 191: | ||
image : alpine | 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 | 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 stack deploy -c compose .yaml test4 | ||
| Zeile 167: | Zeile 203: | ||
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 | ||
| Zeile 174: | Zeile 211: | ||
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 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 | ||
--rm bewirkt, dass der Container nach dem Verlassen der Shell gelöscht wird | * 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 | docker compose run --rm myservice 1 | ||
| Zeile 185: | Zeile 224: | ||
exit | exit | ||
Eine vergleichbare interaktive Nutzungsvariante für docker stack deploy gibt es nicht | 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 | |||
Version vom 17. November 2026, 15:43 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