Docker/Volume: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
K Textersetzung - „bzw. “ durch „oder “ |
||
| (31 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 13: | Zeile 13: | ||
* Was würde sich besser zur Beantwortung dieser Fragen eignen als ein Container mit einem Datenbankserver? | * Was würde sich besser zur Beantwortung dieser Fragen eignen als ein Container mit einem Datenbankserver? | ||
* Wir haben uns hier für das mit MySQL kompatible Datenbanksystem MariaDB entschieden | * Wir haben uns hier für das mit MySQL kompatible Datenbanksystem MariaDB entschieden | ||
Im Docker Hub gibt es für die Datenbankserver MySQL und MariaDB diverse Images | Im Docker Hub gibt es für die Datenbankserver MySQL und MariaDB diverse Images | ||
* Hier wird das offizielle MariaDB-Image eingesetzt | |||
Siehe auch | Siehe auch | ||
| Zeile 31: | Zeile 28: | ||
Wir bleiben hier bei MYSQL_xxx, weil diese Variablennamen universell für MariaDB- und für MySQL-Images funktionieren | Wir bleiben hier bei MYSQL_xxx, weil diese Variablennamen universell für MariaDB- und für MySQL-Images funktionieren | ||
<syntaxhighlight lang="bash" highlight="" | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker run -d --name mariadb-test \ | docker run -d --name mariadb-test \ | ||
-e MYSQL_ROOT_PASSWORD=geheim mariadb | -e MYSQL_ROOT_PASSWORD=geheim mariadb | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Das Kommando [[Docker/Befehle|docker run]] gibt zwar die ID des neuen Containers aus, zeigt aber ansonsten keine Statusinformationen an, die auf einen erfolgreichen Start hinweisen | |||
Das Kommando [[Docker/Befehle|docker | |||
Sie können sich mit docker ps davon überzeugen, dass der Container wirklich läuft | Sie können sich mit docker ps davon überzeugen, dass der Container wirklich läuft | ||
| Zeile 55: | Zeile 43: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Sollte docker ps keine Ausgaben liefern | Sollte docker ps keine Ausgaben liefern oder sollte mariadb-test in der Liste der aktiven Container fehlen, ergründen Sie am besten mit ''docker logs'' die Fehlerursache | ||
Wenn Sie beispielsweise vergessen haben, das gewünschte Passwort mit der Option -e zu übergeben, erhalten Sie mit docker logs die folgende Fehlermeldung | Wenn Sie beispielsweise vergessen haben, das gewünschte Passwort mit der Option -e zu übergeben, erhalten Sie mit docker logs die folgende Fehlermeldung | ||
| Zeile 79: | Zeile 67: | ||
:* Unter Linux und macOS haben Sie nun die Wahl, ob Sie das Kommando einfach in einer Zeile eingeben oder ob Sie das Kommando wie im Buch abgedruckt mehrzeilig samt aller \-Zeichen eingeben | :* Unter Linux und macOS haben Sie nun die Wahl, ob Sie das Kommando einfach in einer Zeile eingeben oder ob Sie das Kommando wie im Buch abgedruckt mehrzeilig samt aller \-Zeichen eingeben | ||
; Container anhalten | |||
Wenn der Start erfolgreich war, läuft der Datenbankserver wegen der Option -d im Hintergrund weiter, bis der Container explizit wieder gestoppt wird | Wenn der Start erfolgreich war, läuft der Datenbankserver wegen der Option -d im Hintergrund weiter, bis der Container explizit wieder gestoppt wird | ||
<syntaxhighlight lang="bash" highlight="" copy> | |||
<syntaxhighlight lang="bash" highlight="" | |||
docker stop mariadb-test | docker stop mariadb-test | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Zeile 97: | Zeile 85: | ||
auf dem Host-Rechner ein | auf dem Host-Rechner ein | ||
Wenn Sie mit Rootless Docker arbeiten, landet das Unterverzeichnis entsprechend in | Wenn Sie mit [[Rootless Docker]] arbeiten, landet das Unterverzeichnis entsprechend in | ||
.local/share/docker/volumes | .local/share/docker/volumes | ||
* Den genauen Verzeichnisnamen können Sie mit ''docker inspect mariadb-test'' ermitteln, wenn Sie in der mehrseitigen Ausgabe dieses Kommandos nach Mounts suchen | * Den genauen Verzeichnisnamen können Sie mit ''docker inspect mariadb-test'' ermitteln, wenn Sie in der mehrseitigen Ausgabe dieses Kommandos nach Mounts suchen | ||
| Zeile 111: | Zeile 99: | ||
== Volumes analysieren == | == Volumes analysieren == | ||
; docker inspect | |||
liefert in einem mehr als 100 Zeilen langen Listing unzählige Details zu einem bestimmten Container | |||
Von Interesse sind hier hauptsächlich die Volume-Daten | |||
<syntaxhighlight lang="bash" highlight="" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker inspect mariadb-test | docker inspect mariadb-test | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="" line> | <syntaxhighlight lang="bash" highlight="" line> | ||
... | ... | ||
| Zeile 139: | Zeile 127: | ||
Das Volume befindet sich physikalisch im folgenden Verzeichnis | Das Volume befindet sich physikalisch im folgenden Verzeichnis | ||
<syntaxhighlight lang="bash" highlight="" | <syntaxhighlight lang="bash" highlight=""> | ||
/home/user/local/share/docker/volumes/d19f5b86 .../_data | /home/user/local/share/docker/volumes/d19f5b86 .../_data | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Zeile 147: | Zeile 135: | ||
<syntaxhighlight lang="bash" highlight="1" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker inspect -f '{{ . Mounts }} ' mariadb-test | docker inspect -f '{{ .Mounts }}' mariadb-test | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="" line> | <syntaxhighlight lang="bash" highlight="" line> | ||
[{volume d19f5b86... | [{volume d19f5b86... | ||
/home/user/local/share/docker/volumes/d19f5b86 .../_data | /home/user/local/share/docker/volumes/d19f5b86.../_data | ||
/var/lib/mysql | /var/lib/mysql | ||
local | local | ||
| Zeile 203: | Zeile 191: | ||
== MariaDB-Client aufrufen == | == 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 | 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 oder analysieren können | ||
* Das ist insofern nicht ganz trivial, als eine interaktive Nutzung des Containers nicht vorgesehen ist | * 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. | * Sie können aber mit ''docker exec'' innerhalb des im Hintergrund laufenden Containers das interaktive Kommando ''mariadb'' starten. | ||
| Zeile 213: | Zeile 201: | ||
Wenn Sie die vorherigen Kommandos exakt nachvollzogen haben, lautet es geheim | Wenn Sie die vorherigen Kommandos exakt nachvollzogen haben, lautet es geheim | ||
<syntaxhighlight lang="bash" highlight="1" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker exec -it mariadb - test mariadb -u root -p | docker exec -it mariadb-test mariadb -u root -p | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Zeile 221: | Zeile 209: | ||
Server version: 11.0.2 -MariaDB | Server version: 11.0.2 -MariaDB | ||
MariaDB [( none ) ] > show status ; | MariaDB [(none)] > show status ; | ||
... | ... | ||
MariaDB [( none ) ] > exit | MariaDB [(none)] > exit | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == 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 | 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 | ||
<syntaxhighlight lang="bash" highlight="" | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker exec -it mariadb-test /bin/bash | docker exec -it mariadb-test /bin/bash | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="" line | <syntaxhighlight lang="bash" highlight="" line> | ||
root@34de866bff12:/# cat/etc/os - release | root@34de866bff12:/# cat/etc/os-release | ||
PRETTY_NAME ="Ubuntu 24.04.2 LTS" | PRETTY_NAME ="Ubuntu 24.04.2 LTS" | ||
... | ... | ||
| Zeile 258: | Zeile 246: | ||
Diese können Sie mit ''docker logs'' lesen | Diese können Sie mit ''docker logs'' lesen | ||
<syntaxhighlight lang="bash" highlight="" | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker logs mariadb-test | docker logs mariadb-test | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="" line | <syntaxhighlight lang="bash" highlight="" line> | ||
Starting MariaDB 11.0.2-MariaDB-1 as process 1 | Starting MariaDB 11.0.2-MariaDB-1 as process 1 | ||
InnoDB: Compressed tables use zlib 1.2.11 | InnoDB: Compressed tables use zlib 1.2.11 | ||
| Zeile 281: | Zeile 269: | ||
docker inspect -f '{{ .Mounts }}' mariadb-test | docker inspect -f '{{ .Mounts }}' mariadb-test | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="" | <syntaxhighlight lang="bash" highlight=""> | ||
[{volume d19f5b86... .../var/lib/mysql local true }] | [{volume d19f5b86... .../var/lib/mysql local true }] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Zeile 309: | Zeile 297: | ||
* Andernfalls birgt ''docker volume prune'' aber die Gefahr in sich, dass Sie Volumes löschen, deren Daten Sie später vielleicht noch brauchen | * 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 | 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 | * 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 | * 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 | * Die vorigen Beispiele haben gezeigt, wie übersichtlich das die weitere Verwaltung oder das Löschen von Volumes macht | ||
Zum Glück gibt es einen einfachen Ausweg: Mit einer Option können Sie Volumes eigene Namen zuweisen | 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 | * Wir verwenden für die folgenden Beispiele weiterhin MariaDB | ||
Die Option -v <vname>:<containerdir> ordnet einem Verzeichnis des Containers einen Volume-Namen zu | Die Option ''-v <vname>:<containerdir>'' ordnet einem Verzeichnis des Containers einen Volume-Namen zu | ||
<syntaxhighlight lang="bash" highlight="" line copy> | <syntaxhighlight lang="bash" highlight="" line copy> | ||
docker run -d --name mariadb-test \ | |||
-v myvolume:/var/lib/mysql \ | |||
-e MYSQL_ROOT_PASSWORD=geheim mariadb | |||
</syntaxhighlight> | </syntaxhighlight> | ||
| Zeile 328: | Zeile 315: | ||
* Die Administration des Volumes wird aber einfacher | * Die Administration des Volumes wird aber einfacher | ||
docker inspect und docker system df zeigen statt einer ID den Namen des Volumes an | ''docker inspect'' und ''docker system df'' zeigen statt einer ID den Namen des Volumes an | ||
<syntaxhighlight lang="bash" highlight="" | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker inspect -f '{{ .Mounts }}' mariadb-test | |||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="" | <syntaxhighlight lang="bash" highlight=""> | ||
[{volume myvolume /home/user/.local/share/docker/volumes/myvolume/_data/var/lib/mysql local z true }] | |||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker system df -v | |||
<syntaxhighlight lang="bash" highlight="" | |||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="" line> | |||
... | |||
VOLUME NAME LINKS SIZE | |||
myvolume 1 186.2 MB | |||
<syntaxhighlight lang="bash" highlight="" line | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== | == 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 | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker stop mariadb-test | |||
<syntaxhighlight lang="bash" highlight="" | |||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker rm mariadb-test | |||
<syntaxhighlight lang="bash" highlight="" | |||
- | |||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker pull mariadb | |||
<syntaxhighlight lang="bash" highlight="" | |||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker run -d --name mariadb-test -v myvolume:/var/lib/mysql mariadb | |||
<syntaxhighlight lang="bash" highlight="1" | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== 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 benötigen | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
<syntaxhighlight lang="bash" highlight="1" | |||
docker stop mariadb-test | docker stop mariadb-test | ||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker rm mariadb-test | |||
<syntaxhighlight lang="bash" highlight="" | |||
</syntaxhighlight> | </syntaxhighlight> | ||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker volume rm myvolume | |||
<syntaxhighlight lang="bash" highlight=" | |||
</syntaxhighlight> | </syntaxhighlight> | ||
= Volumes in eigenen Verzeichnissen = | |||
Egal, ob mit eigenem Namen oder mit einer zufälligen ID: Standardmäßig landen alle Volumes in von Docker verwalteten Verzeichnissen oder unter macOS in einer virtuellen Maschine oder unter Windows in einem WSL-Verzeichnis | |||
Es besteht die Möglichkeit, Volumes in einem eigenen Verzeichnis im lokalen Dateisystem zu speichern | |||
Es besteht | |||
* Das hat den Vorteil, dass Sie losgelöst von Docker auf den Inhalt des Verzeichnisses zugreifen können | * 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 folgenden Kommandos zeigen die Kommandoabfolge | ||
* Die erste Kommandosequenz richtet den Container mit einem lokalen Volume-Verzeichnis ein | * Die erste Kommandosequenz richtet den Container mit einem lokalen Volume-Verzeichnis ein | ||
Dabei kommt wieder die Option -v zum Einsatz, | Dabei kommt wieder die Option -v zum Einsatz, dieses Mal aber in der Form ''-v <localdir>/<containerdir>'' | ||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
mkdir /home/<username>/varlibmysql | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="" line copy> | <syntaxhighlight lang="bash" highlight="1" line copy> | ||
docker run -d --name mariadb-test \ | |||
-e MYSQL_ROOT_PASSWORD=geheim \ | |||
-e | -v /home/<username>/varlibmysql/:/var/lib/mysql mariadb | ||
-v/home/<username >/ | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Unter Linux und macOS muss der Pfad zum lokalen Volume-Verzeichnis mit/beginnen | Unter Linux und macOS muss der Pfad zum lokalen Volume-Verzeichnis mit / beginnen | ||
* Ein relativer Pfad in der Form ./name wird nicht akzeptiert | * Ein relativer Pfad in der Form ./name wird nicht akzeptiert | ||
* Wenn Sie nur name angeben, betrachtet docker run die Zeichenkette als Volume-Namen | * 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 | * Es erzeugt dann wie im vorigen Abschnitt selbst ein Volume und benennt dieses mit ''name'' | ||
== Volumes versus Mounts == | == Volumes versus Mounts == | ||
In der Docker-Dokumentation ist mal von Volumes die Rede, dann wieder von Mounts | In der Docker-Dokumentation ist mal von Volumes die Rede, dann wieder von Mounts | ||
Was ist der Unterschied? | Was ist der Unterschied? | ||
Mounts bezeichnet einen Mechanismus zum Einbetten eines externen Dateisystems in den Verzeichnisbaum des Containers | Mounts bezeichnet einen Mechanismus zum Einbetten eines externen Dateisystems in den Verzeichnisbaum des Containers | ||
; Typen von Mounts: | |||
Anstelle der | * bind | ||
* volume | |||
* tmpfs | |||
Bei einem Volume handelt es sich um einen bind-Mount | |||
* Anstelle der oft genutzten Option ''-v'' oder ''--volume'' des Kommandos ''docker run'' können Sie auch die Option ''--mount'' verwenden | |||
Aus | Aus | ||
<syntaxhighlight lang="bash" highlight="" line copy> | <syntaxhighlight lang="bash" highlight="" line copy> | ||
-v <hostdir>:<containerdir> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
wird dann | wird dann | ||
| Zeile 890: | Zeile 418: | ||
--mount type=bind,source=<hostdir>,destination=<containerdir> | --mount type=bind,source=<hostdir>,destination=<containerdir> | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Die langatmige Syntax von --mount ist der Grund, warum wir -v vorziehen | Die langatmige Syntax von --mount ist der Grund, warum wir -v vorziehen | ||
<noinclude> | <noinclude> | ||
| Zeile 928: | Zeile 453: | ||
=== Links === | === Links === | ||
# [[Docker/Grundlagen/08 | # [[Docker/Grundlagen/08 Kommunikation zwischen Containern]] | ||
# [[Docker/Grundlagen/ | # [[Docker/Grundlagen/Administration]] | ||
==== Projekt ==== | ==== Projekt ==== | ||
Aktuelle Version vom 18. November 2026, 14:58 Uhr
Docker/Volume - Speicherung in Volumes
Beschreibung
Wie und wo werden Containerdaten gespeichert?
- Was würde sich besser zur Beantwortung dieser Fragen eignen als ein Container mit einem Datenbankserver?
- Wir haben uns hier für das mit MySQL kompatible Datenbanksystem MariaDB entschieden
Im Docker Hub gibt es für die Datenbankserver MySQL und MariaDB diverse Images
- Hier wird das offizielle MariaDB-Image eingesetzt
Siehe auch
Beim Einrichten des Containers mit dem folgenden Kommando wird das root-Passwort für den Datenbankserver als Parameter übergeben
- Das ist kein optimaler Mechanismus, weil das Passwort kurz im Klartext in der Prozessliste für alle sichtbar ist
- Eine bessere Vorgehensweise findet sich in Docker/Interna/#Passwörter und andere Geheimnisse
- Der Inhalt von MYSQL_ROOT_PASSWORD kann später auch mit docker inspect mariadb-test ausgelesen werden – allerdings nur von Anwendern, die selbst docker ausführen dürfen
Anstelle von MYSQL_ROOT_PASSWORD können Sie die gleichwertige Variable MARIADB_ROOT_PASSWORD verwenden
Wir bleiben hier bei MYSQL_xxx, weil diese Variablennamen universell für MariaDB- und für MySQL-Images funktionieren
docker run -d --name mariadb-test \
-e MYSQL_ROOT_PASSWORD=geheim mariadb
Das Kommando docker run gibt zwar die ID des neuen Containers aus, zeigt aber ansonsten keine Statusinformationen an, die auf einen erfolgreichen Start hinweisen
Sie können sich mit docker ps davon überzeugen, dass der Container wirklich läuft
docker ps
CONTAINE R ID ... COMMAND CREATED NAMES
02 f5b1017a b b mysqld 52 seconds ago mariadb -test
..
Sollte docker ps keine Ausgaben liefern oder sollte mariadb-test in der Liste der aktiven Container fehlen, ergründen Sie am besten mit docker logs die Fehlerursache
Wenn Sie beispielsweise vergessen haben, das gewünschte Passwort mit der Option -e zu übergeben, erhalten Sie mit docker logs die folgende Fehlermeldung
docker logs mariadb-test
Entrypointscript for MariaDB Server 1:11.0.2+ maria~ubu2204
Switching to dedicate d user 'mysql'
Database is uninitialized and password option is not specified
You need to specify one of MARIADB_ROOT_PASSWORD,
MARIADB_ROOT_PASSWORD_HASH ...
Beachten Sie, dass Sie vor einem neuerlichen Start den zuletzt erzeugten Container löschen ausführen müssen
docker rm mariadb-test
- Mehrzeilige Kommandos
- Wenn wir in diesem Buch Kommandos aus Platzgründen über zwei Zeilen verteilen müssen, kennzeichnen wir das Ende der umgebrochenen Zeile mit dem Zeichen \
- Unter Linux und macOS haben Sie nun die Wahl, ob Sie das Kommando einfach in einer Zeile eingeben oder ob Sie das Kommando wie im Buch abgedruckt mehrzeilig samt aller \-Zeichen eingeben
- Container anhalten
Wenn der Start erfolgreich war, läuft der Datenbankserver wegen der Option -d im Hintergrund weiter, bis der Container explizit wieder gestoppt wird
docker stop mariadb-test
Speicherung der Datenbank in einem automatisch erzeugten Volume
Speicherung der Datenbank in einem automatisch erzeugten Volume MariaDB speichert grundsätzlich alle Datenbankdateien im Verzeichnis
/var/lib/mysql
- Im Dockerfile von MariaDB, also in der Beschreibung des Images, ist /var/lib/mysql aber als Volume gekennzeichnet
- Das bedeutet, dass dieses Verzeichnis außerhalb des Containers angelegt wird
Unter Linux richtet Docker dazu ein Unterverzeichnis innerhalb von
/var/lib/docker/volumes
auf dem Host-Rechner ein
Wenn Sie mit Rootless Docker arbeiten, landet das Unterverzeichnis entsprechend in
.local/share/docker/volumes
- Den genauen Verzeichnisnamen können Sie mit docker inspect mariadb-test ermitteln, wenn Sie in der mehrseitigen Ausgabe dieses Kommandos nach Mounts suchen
Was haben Sie davon, dass Docker zwischen Daten differenziert, die im Container gespeichert werden, und solchen, die außerhalb (also in einem Volume) landen? Vorerst nicht viel
- Sowohl die Container als auch die Volumes landen in einem von Docker verwalteten Verzeichnis (z. B. /var/lib/docker), auf dessen Inhalt Sie in keinem Fall direkt zugreifen sollten
Aber mit Volumes haben Sie die Möglichkeit, die Daten eines beendeten Containers später in einen neuen Container zu übernehmen
- Das ist z. B. dann sinnvoll, wenn Sie nach einem MariaDB-Update den vorhandenen Container löschen und durch einen neuen Container mit der aktuellen MariaDB-Version ersetzen möchten
- Bei einem derartigen Update wollen Sie natürlich Ihre Daten nicht verlieren
Außerdem werden Sie im nächsten Abschnitt lernen, wie Sie Volumes mit eigenen, lokalen Verzeichnissen verbinden und so gewissermaßen aus der Docker-Blackbox herauslösen können
Volumes analysieren
- docker inspect
liefert in einem mehr als 100 Zeilen langen Listing unzählige Details zu einem bestimmten Container
Von Interesse sind hier hauptsächlich die Volume-Daten
docker inspect mariadb-test
...
" Mounts ": [
{
" Type ": "volume " ,
" Name ": "d19f5b86 ..." ,
" Source ": "/home/user/local/share/docker/volumes/\
d19f5b86 .../_data",
"Destination": "/var/lib/mysql",
"Driver": "local",
"Mode": "" ,
"RW": true,
"Propagation": ""
}
],
...
Der Container mariadb-test ist also einem Volume mit der ID d19f5b86.. zugeordnet
Das Volume befindet sich physikalisch im folgenden Verzeichnis
/home/user/local/share/docker/volumes/d19f5b86 .../_data
Anstatt die Volume-Daten mühsam aus dem Listing zu extrahieren, können Sie an docker inspect eine Formatoption übergeben und nur die für Sie relevanten Daten – in diesem Fall alle Mounts herausfiltern
docker inspect -f '{{ .Mounts }}' mariadb-test
[{volume d19f5b86...
/home/user/local/share/docker/volumes/d19f5b86.../_data
/var/lib/mysql
local
true }]
Sobald Sie den Namen eines Volumes kennen (hier d19f5b86...), können Sie mit docker volume inspect weitere Informationen herausfinden.
- Beachten Sie, dass Sie dabei den gesamten, 64 Zeichen langen hexadezimalen Code angeben müssen.
- Hier sind zur besseren Übersichtlichkeit nur die ersten 8 Stellen angegeben
docker volume inspect d19f5b86 ..
[
{
"CreatedAt": "2023-05-14T18:06:16+02:00",
"Driver": "local ",
"Labels": null ,
"Mountpoint ": "/home/user/local/share/docker/volumes/d19f5b86.../_data ",
" Name": "d19f5b86 ..",
" Options": null ,
" Scope": "local "
}
]
Leider verrät docker volume inspect nicht, wie groß ein Volume ist
- Diese Information liefert docker system df, allerdings nicht spezifisch für ein Volume, sondern global für alle durch Docker verwalteten Images, Container, Volumes etc
- Dementsprechend ist die Ausgabe von docker system df zumeist recht lang
Wir haben aus dem folgenden Listing alle Informationen entfernt, die nichts mit unserem Volume zu tun haben
docker system df -v
Images space usage: ...
Containers space usage: ...
Build cache usage: ...
Local Volumes space usage
VOLUME NAME LINKS SIZE
d19f5b86... 1 186.2 MB
- Warum ist das Volume derart groß?
Wir haben noch keine Datenbanken erzeugt und mit Daten befüllt
- Die Volume-Größe hat mit einer Eigenheit des MariaDB-Servers zu tun
- Beim ersten Start werden Dateien eingerichtet, in denen später Datenbanken, Transaktionen usw. gespeichert werden
- Die minimale Größe dieser Dateien ist bereits ziemlich beträchtlich
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 oder 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 MySQ-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
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@34de866bff12:/# cat/etc/os-release
PRETTY_NAME ="Ubuntu 24.04.2 LTS"
...
root@34de866bff12:/# 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@34de866bff12:/# mariadbd --version
mariadbd Ver 11.0.2-MariaDB-1:11.0.2+maria~ubu2204 for
debian-linux-gnu on x86_64 (mariadb.org binary distribution)
root@34de866bff12:/# 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
- docker logs
Diese können Sie mit docker logs lesen
docker logs mariadb-test
Starting MariaDB 11.0.2-MariaDB-1 as process 1
InnoDB: Compressed tables use zlib 1.2.11
InnoDB: Number of transaction pools: 1
InnoDB: Using crc32 + pclmulqdq instructions
...
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 benötigen
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!
- Volume 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 oder 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_ROOT_PASSWORD=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 benötigen
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 verwalteten Verzeichnissen oder unter macOS in einer virtuellen Maschine oder unter Windows in einem WSL-Verzeichnis
Es besteht 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, dieses Mal aber in der Form -v <localdir>/<containerdir>
mkdir /home/<username>/varlibmysql
docker run -d --name mariadb-test \
-e MYSQL_ROOT_PASSWORD=geheim \
-v /home/<username>/varlibmysql/:/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
- Typen von Mounts
- bind
- volume
- tmpfs
Bei einem Volume handelt es sich um einen bind-Mount
- Anstelle der oft genutzten Option -v oder --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
Anhang
Siehe auch
Dokumentation
Links
Projekt
Weblinks