Docker/Compose/02 Einführung: Unterschied zwischen den Versionen
K Textersetzung - „bzw. “ durch „oder “ |
|||
| (3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
'''Docker/Compose/02 Einführung''' - | '''Docker/Compose/02 Einführung''' - Einführungrendes Beispiel | ||
== Beschreibung == | == Beschreibung == | ||
| Zeile 8: | Zeile 8: | ||
== Einstellungen == | == Einstellungen == | ||
Zur Speicherung der Datenbankdateien | 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 56: | Zeile 55: | ||
** hier: ''wordpress-beispiel '' | ** hier: ''wordpress-beispiel '' | ||
; Achtung | |||
docker compose up -d sucht im aktuellen Verzeichnis nach der Datei compose.yaml | :* 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 140: | Zeile 152: | ||
</syntaxhighlight> | </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 | 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 | Dieser Name wird den Netzwerk-, Volume- und Servicenamen vorangestellt | ||
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