K Textersetzung - „kofler“ durch „user“ |
Keine Bearbeitungszusammenfassung |
||
| Zeile 260: | Zeile 260: | ||
{{:Docker/Buch/03 Grundlagen/Administration}} | {{:Docker/Buch/03 Grundlagen/Administration}} | ||
Version vom 15. November 2026, 09:44 Uhr
Docker/Buch/03 Grundlagen/05 Volumes - Datenspeicherung in Volumes
MariaDB-Client aufrufen
Bevor wir Ihnen im nächsten Abschnitt mehr Details zum effizienten Umgang mit Volumes verraten, möchten wir Ihnen kurz zeigen, wie Sie den MariaDB-Container ansehen bzw. analysieren können
- Das ist insofern nicht ganz trivial, als eine interaktive Nutzung des Containers nicht vorgesehen ist
- Sie können aber mit docker exec innerhalb des im Hintergrund laufenden Containers das interaktive Kommando mariadb starten. (mariadb ist ein Kommando, mit dem Sie SQL-Anweisungen auf einem MariaDB-Server ausführen können
- Falls Sie einen Container mit einem MySQL- Server ausführen, lautet der Kommandoname entsprechend mysql.)
Als Login-Passwort geben Sie das gleiche Passwort wie beim Erzeugen des Containers an
Wenn Sie die vorherigen Kommandos exakt nachvollzogen haben, lautet es geheim
docker exec -it mariadb - test mariadb -u root -p
Enter password : ******** ( root - Passwort fü r MariaDB )
Welcome to the MariaDB monitor
Server version : 11.0.2 -MariaDB
MariaDB [( none ) ] > show status ;
..
MariaDB [( none ) ] > exit
- Ein Blick in den Container
Wenn Sie neugierig sind und weitere Details über den Container ermitteln möchten, starten Sie parallel zum MariaDB-Server mit docker exec einen bash-Prozess für den Container
docker exec -it mariadb - test / bin / bash
root@34d e 8 6 6b f f 1 2 :/# cat / etc / os - release
PRETTY_N A ME =" Ubuntu 24.04.2 LTS "
..
root@34d e 8 6 6b f f 1 2 :/# ps -ax
PID TTY STAT TIME COMMAND
1 ? Ssl 0:00 mysqld
147 ? Ss 0:00 / bin / bash
218 ? R+ 0:00 ps -ax
root@34d e 8 6 6b f f 1 2 :/# mariadbd --version
mariadbd Ver 11.0.2 -MariaDB -1:11.0. 2 + maria ~ ubu2204 for
debian - linux - gnu on x86_64 ( mariadb
org binary distribu t io n )
root@34d e 8 6 6b f f 1 2 :/# exit
Anhand von cat /etc/os-release wissen Sie nun, dass MariaDB Ubuntu als Basis- Image verwendet
Logging
Da der MariaDB-Container im Hintergrund läuft, sehen Sie im Terminal weder Fehlermeldungen noch Logging-Ausgaben
Diese können Sie mit docker logs lesen
docker logs mariadb - test
Starting MariaDB 11.0.2 -MariaDB -1 as process 1
InnoDB : Compress ed tables use zlib 1.2.11
InnoDB : Number of transact i o n pools : 1
InnoDB : Using crc32 + pclmulqdq instruct io n s
..
- Aufräumen
Beim Löschen eines Containers bleibt das dazugehörige Volume immer erhalten
- Das ist zweckmäßig, weil sich in Volumes ja Daten befinden, die Sie in zukünftigen Containern vielleicht noch brauchen
Bei diesem Beispiel ist das aber nicht der Fall
- Wir wollen den Container und das Volume löschen
- Deswegen sollten Sie unbedingt vor docker rm mit docker inspect den Namen des zugeordneten Volumes ermitteln! Das gibt Ihnen die Möglichkeit, in der Folge auch das
- Volume zu löschen
docker inspect -f '{{
Mounts }} ' mariadb - test
[{ volume d19f5b86 ... ... / var / lib / mysql local true }]
docker stop mariadb - test
docker rm mariadb - test
docker volume rm d19f5b86 ..
Sollten Sie den Container bereits gelöscht haben, ohne vorher die zugehörige Volume- ID ermittelt zu haben, ist es schwierig, das Volume zu löschen
docker volume ls listet
zwar alle bekannten Volumes auf, verrät aber nicht, welchem Container diese Volumes zugeordnet sind Immerhin können Sie mit docker volume prune alle Volumes löschen, die keinem Container zugeordnet sind
- Wenn Sie bisher nur mit Docker experimentiert haben, ist das ungefährlich
- Andernfalls birgt docker volume prune aber die Gefahr in sich, dass Sie Volumes löschen, deren Daten Sie später vielleicht noch brauchen
Volumes mit Namen
Im vorigen Abschnitt haben Sie Volumes als Mechanismus kennen gelernt, veränderliche Daten eines Containers auszulagern, also losgelöst vom eigenen Container zu speichern
- Sofern das Image entsprechend konfiguriert ist, kümmert sich Docker nahezu um alles selbst
- Allerdings haben die automatisch erzeugten Volumes einen gravierenden Nachteil: Sie bekommen als Namen eine zufällige, 64-stellige hexadezimale Zahl
- Die vorigen Beispiele haben gezeigt, wie übersichtlich das die weitere Verwaltung bzw. das Löschen von Volumes macht
Zum Glück gibt es einen einfachen Ausweg: Mit einer Option können Sie Volumes eigene Namen zuweisen
- Wir verwenden für die folgenden Beispiele weiterhin MariaDB
Die Option -v <vname>:<containerdir> ordnet einem Verzeichnis des Containers einen Volume-Namen zu
docker run -d --name mariadb - test \
-v myvolume :/ var / lib / mysql \
-e MYSQL_RO O T _P A S S W OR D = geheim mariadb
An der Anwendung von MariaDB ändert sich nichts
- Die Administration des Volumes wird aber einfacher
docker inspect und docker system df zeigen statt einer ID den Namen des Volumes an
docker inspect -f '{{
Mounts }} ' mariadb - test
[{ volume myvolume
/ home / user /
local / share / docker /volumes / myvolume / _data
/ var / lib / mysql local z true }]
docker system df -v
..
VOLUME NAME LINKS SIZE
myvolume 1 186.2 MB
Container-Update ohne Datenverlust
Die Vorteile von Volumes werden klar, wenn Sie (z. B. nachdem im Docker Hub eine neue Version des MariaDB-Images veröffentlicht wurde) ein Container-Update durchführen möchten
- Dazu stoppen und löschen Sie den aktuellen Container, laden mit docker pull das aktuelle Image herunter, erzeugen einen neuen Container und verbinden diesen mit dem schon vorhandenen Volume!
Beachten Sie, dass bei docker run nun die Option -e zur Einstellung des Passworts entfällt
- In myvolume befinden sich nicht nur alle Datenbanken, die Sie bei der bisherigen Nutzung des Containers eingerichtet haben, sondern auch das MariaDB-Passwort
Es muss daher nicht neuerlich konfiguriert werden
docker stop mariadb - test
docker rm mariadb - test
docker pull mariadb
docker run -d --name mariadb - test \
-v myvolume :/ var / lib / mysql mariadb
- Aufräumen
Auch das Aufräumen gelingt mit benannten Volumes wesentlich einfacher
- Natürlich sollten Sie das Volume nur löschen, wenn Sie die darin enthaltenen Daten nicht mehr brauchen
Für die weiteren Beispiele dieses Kapitels ist das Volume aber nicht erforderlich – wir werden bei nächster Gelegenheit ein neues erzeugen
docker stop mariadb - test
docker rm mariadb - test
docker volume rm myvolume
Volumes in eigenen Verzeichnissen
Egal, ob mit eigenem Namen oder mit einer zufälligen ID: Standardmäßig landen alle Volumes in von Docker oder Podman verwalteten Verzeichnissen bzw. unter macOS in einer virtuellen Maschine bzw. unter Windows in einem WSL-Verzeichnis Es besteht aber auch die Möglichkeit, Volumes in einem eigenen Verzeichnis im lokalen Dateisystem zu speichern
- Das hat den Vorteil, dass Sie losgelöst von Docker auf den Inhalt des Verzeichnisses zugreifen können
- Die folgenden Kommandos zeigen die Kommandoabfolge
- Die erste Kommandosequenz richtet den Container mit einem lokalen Volume-Verzeichnis ein
Dabei kommt wieder die Option -v zum Einsatz, diesmal aber in der Form -v <localdir>/<containerdir>
mkdir / home / <username >/ varlibmys q l
docker run -d --name mariadb - test \
-e MYSQL_RO OT _ P A SS W O R D =geheim \
-v / home / <username >/ varlibmy sq l /:/ var / lib / mysql mariadb
Unter Linux und macOS muss der Pfad zum lokalen Volume-Verzeichnis mit / beginnen
- Ein relativer Pfad in der Form ./name wird nicht akzeptiert
- Wenn Sie nur name angeben, betrachtet docker run die Zeichenkette als Volume-Namen
- Es erzeugt dann wie im vorigen Abschnitt selbst ein Volume und benennt dieses mit name
Volumes versus Mounts
In der Docker-Dokumentation ist mal von Volumes die Rede, dann wieder von Mounts Was ist der Unterschied? Mounts bezeichnet einen Mechanismus zum Einbetten eines externen Dateisystems in den Verzeichnisbaum des Containers
- Es gibt drei Typen von Mounts: bind, volume und tmpfs
- Bei einem Volume handelt es sich – ein wenig verwirrend – um einen bind- Mount
Anstelle der in diesem Buch oft genutzten Option -v bzw. --volume des Kommandos docker run können Sie auch die Option --mount verwenden
Aus
-v <hostdir>:<containerdir>
wird dann
--mount type=bind,source=<hostdir>,destination=<containerdir>
Die langatmige Syntax von --mount ist der Grund, warum wir -v vorziehen
Probleme mit SELinux
Bei Fedora, RHEL und damit kompatiblen Distributionen verbietet SELinux Volumes, die sich nicht in den für Docker oder Podman reservierten Verzeichnissen befinden (z. B. /var/lib/docker/volumes )
- Sobald Sie einen eigenen Ort angeben, tritt ein Fehler auf
- Abhilfe schafft das zusätzliche Flag :z oder :Z, das Sie der Volume-Option hinzufügen müssen (also z. B. -v /home/user/varlibmysql/:/var/lib/mysql:z)
Beide Flags bewirken, dass den von Docker oder Podman erzeugten Dateien automatisch der erforderliche SELinux-Kontext zugewiesen wird. :z erlaubt eine Nutzung der Dateien durch unterschiedliche Container, während :Z die Dateien speziell dem einen zu startenden Container zuordnet
Siehe auch
Details und Hintergrundinformationen finden Sie hier
Probleme auf Windows-Hosts
- Grundsätzlich ist die Option -v zur Angabe eines lokalen Volume-Verzeichnisses auch auf Windows-Hosts erlaubt
Dabei sind drei Einschränkungen zu beachten
Die Pfadangabe kann mit dem in Windows unüblichen /-Zeichen erfolgen oder muss in Anführungszeichen gestellt werden, also z. B. so
-v C :/ Users / name / dir : volumedi r
-v " C :\ Users \ name \ dir ": volumedi r
Lokale Volume-Verzeichnisse sind mit Einschränkungen verbunden, die sich aus den unterschiedlichen internen Strukturen von Windows- und Linux-Dateisystemen ergeben
- Manche Dateioperationen funktionieren, andere wiederum nicht
Dateioperationen in lokalen Verzeichnissen sind deutlich langsamer als bei Volumes, die von Docker direkt verwaltet werden
In den Docker-Foren gibt es eine Menge Threads von Benutzern, die Probleme mit Volume-Verzeichnissen unter Windows haben
- Sie machen sich das Leben einfacher, wenn Sie unter Windows auf Volumes in eigenen Verzeichnissen verzichten
- Aufräumen
Beim Stoppen und Löschen des Containers ändert sich nichts
Um das Löschen des Volume-Verzeichnisses müssen Sie sich nun aber selbst kümmern, wobei Sie je nach Betriebssystem rm -rf verz oder rmdir /s verz ausführen
docker stop mariadb - test
docker rm mariadb - test
rmdir / s varlibmy s ql ( Windows )
sudo rm -rf varlibmys q l ( Linux , macOS )
Docker bzw. Podman erzeugen bei der Ausführung von Containern Dateien, die nicht Ihrem eigenen Account zugeordnet sind
- Deswegen scheitert das rm-Kommando, wenn Sie sudo vergessen