Docker/Grundlagen/09 Administration: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
K Textersetzung - „bzw. “ durch „oder “
 
(21 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 9: Zeile 9:
</noinclude>
</noinclude>


== Beschreibung ==
== Administration ==
== Administration ==
; Kommandos
; Kommandos
Zeile 15: Zeile 14:
* Zu solchen Verwaltungsaufgaben zählen etwa das Auflisten und Löschen von Images, Containern und Volumes
* Zu solchen Verwaltungsaufgaben zählen etwa das Auflisten und Löschen von Images, Containern und Volumes


; siehe auch
siehe auch
[[Docker/Befehle]]
: [[Docker/Befehle]]


=== Platzbedarf ===
=== Platzbedarf ===
Zeile 24: Zeile 23:


Diese Frage beantworten die Kommandos  
Diese Frage beantworten die Kommandos  
* [[docker/images]]
* ''docker images''
* [[docker/ps]] -a -s
* ''docker ps -a -s''


; docker images
; docker images
Zeile 31: Zeile 30:
* Mit Größenangabe
* Mit Größenangabe


<syntaxhighlight lang="bash" highlight="1" copy >
docker images
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="" line >
<syntaxhighlight lang="bash" highlight="" line >
  docker images
  REPOSITORY            TAG     ... CREATED       SIZE
REPOSITO R Y TAG ... CREATED SIZE
  wordpress            latest     17 hours ago 550 MB
  wordpres s latest 17 hours ago 550 MB
  mariadb               latest     7 days ago   405 MB
  mariadb latest 7 days ago 405 MB
  phpmyadmin/phpmyadmin latest     2 months ago 477 MB
  phpmyadmin/phpmyadmin latest 2 months ago 477 MB
</syntaxhighlight>
</syntaxhighlight>


Zeile 57: Zeile 58:


<syntaxhighlight lang="bash" highlight="" line >
<syntaxhighlight lang="bash" highlight="" line >
CONTAINE R ID IMAGE ... SIZE
CONTAINER ID IMAGE         ... SIZE
  2 bf9e954b 4 b 7 wordpress 20.1 MB ( virtual 571 MB )
2bf9e954b4b7 wordpress         20.1 MB (virtual 571 MB)
  3 af937080 2 2 8 phpmyadmi n/... 70 B ( virtual 477 MB )
3af937080228 phpmyadmin/...     70 B (virtual 477 MB)
  ac98aca3 7 f 7 a mariadb 2 B (virtual 405 MB )
ac98aca37f7a mariadb           2 B (virtual 405 MB)
</syntaxhighlight>
</syntaxhighlight>


=== Daten löschen ===
=== Daten löschen ===
; Container und Images löschen
; Container und Images löschen
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker rm <id> bzw. docker rm <name> löscht den angegebenen Container
docker rm <id>
</syntaxhighlight>
oder
<syntaxhighlight lang="bash" highlight="1" copy>
docker rm <name>
</syntaxhighlight>
</syntaxhighlight>


Container- IDs und -Namen können Sie gegebenenfalls mit docker ps -a ermitteln
Container- IDs und -Namen können Sie gegebenenfalls mit docker ps -a ermitteln
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" line copy>
docker rm ac98aca3 7f 7 a
docker rm ac98aca37f7a
</syntaxhighlight>
</syntaxhighlight>


; !Vorsicht
; Vorsicht
: docker rm hat große Ähnlichkeiten mit dem klassischen rm-Kommando unter Linux
: docker rm hat große Ähnlichkeiten mit dem klassischen rm-Kommando unter Linux
* Es löscht ohne Rückfrage und ohne die Möglichkeit, die Operation rückgängig zu machen!
:* Es löscht ohne Rückfrage und ohne die Möglichkeit, die Operation rückgängig zu machen!


Das folgende Kommando erzeugt zuerst mit ps eine Liste aller IDs von Containern, die vom Image ubuntu abgeleitet sind
Das folgende Kommando erzeugt zuerst mit ps eine Liste aller IDs von Containern, die vom Image ubuntu abgeleitet sind
* Diese Liste wird an docker rm weitergegeben, um alle Container zu löschen
* Diese Liste wird an docker rm weitergegeben, um alle Container zu löschen
* Wenn Sie also eine Weile mit docker run ubuntu experimentiert haben, können Sie so alle bei dieser Gelegenheit erzeugten Container wieder löschen
* Wenn Sie also eine Weile mit ''docker run ubuntu'' experimentiert haben, können Sie so alle bei dieser Gelegenheit erzeugten Container wieder löschen
* Die hier präsentierte Verkettung zweier Kommandos setzt voraus, dass eine Shell wie bash oder zsh verwendet wird, wie dies unter Linux oder macOS standardmäßig der Fall ist
* Die hier präsentierte Verkettung zweier Kommandos setzt voraus, dass eine Shell wie bash oder zsh verwendet wird, wie dies unter Linux oder macOS standardmäßig der Fall ist


Unter Windows funktioniert das Kommando ebenfalls, sofern Sie die PowerShell verwenden
Unter Windows funktioniert das Kommando ebenfalls, sofern Sie die PowerShell verwenden
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker rm $ ( docker ps -a -q -f ancestor = ubuntu )
docker rm $(docker ps -a -q -f ancestor=ubuntu)
</syntaxhighlight>
</syntaxhighlight>


Noch radikaler ist das nächste Kommando: Es löscht alle existierenden Container!
; Alle existierenden Container löschen
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" line copy>
docker rm $ ( docker ps -aq )
docker rm $(docker ps -aq)
</syntaxhighlight>
</syntaxhighlight>


; docker rmi imagename löscht das angegebene Image
; ''docker rm imagename'' löscht das angegebene Image
Das ist nur möglich, wenn es keine von dem Image abgeleiteten Container gibt
Das ist nur möglich, wenn es keine von dem Image abgeleiteten Container gibt


; Löschen alle hello-world-Container und dann das hello-world-Image
; Löschen alle hello-world-Container und dann das hello-world-Image
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker rm $ ( docker ps -a -q -f ancestor = hello - world )
docker rm $(docker ps -a -q -f ancestor=hello-world)
</syntaxhighlight>
</syntaxhighlight>


; Löschen deshello-world-Images
; Löschen des hello-world-Images
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker rmi hello - world
docker rmi hello-world
</syntaxhighlight>
</syntaxhighlight>


Beachten Sie, dass docker rmi nur lokal ausgeführt wird
Beachten Sie, dass ''docker rmi'' nur lokal ausgeführt wird
* Wenn Sie ein eigenes Image in den Docker Hub hochgeladen haben, bleibt das Image dort erhalten
* Wenn Sie ein eigenes Image in den Docker Hub hochgeladen haben, bleibt das Image dort erhalten
* Sie können es bei Bedarf in der Weboberfläche von https://hub.docker.com löschen
* Sie können es bei Bedarf in der Weboberfläche von https://hub.docker.com löschen


=== Volumes verwalten ===
=== Volumes verwalten ===
Volumes werden getrennt von den Containern und Images in einem eigenen Verzeichnis gespeichert, unter Linux z.&nbsp;B.&nbsp;in/var/lib/docker/volumes
Volumes werden getrennt von den Containern und Images in einem eigenen Verzeichnis gespeichert, unter Linux z.&nbsp;B.&nbsp;in ''/var/lib/docker/volumes''
* Beim Löschen von Containern rührt Docker Volumes generell nicht an
* Beim Löschen von Containern rührt Docker Volumes generell nicht an
* Sie können aber wie folgt eine


Liste mit den Namen oder IDs aller Volumes erstellen, zu denen der dazugehörende Container nicht mehr existiert
Sie können aber eine Liste mit den Namen oder IDs aller Volumes erstellen, zu denen der dazugehörende Container nicht mehr existiert
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker volume ls -q -f dangling = true
docker volume ls -q -f dangling=true
</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="" line >
<syntaxhighlight lang="bash" highlight="" line >
4 df85efbf 1 2 40 b 7 4 29 f 7 b f 55 4 e 2 e ad 5 2 b 9 0a 1 9 3 4 87 5 d 5 7 77 3 c 1 c 80 c 4 0 5 d6 4 a
4df85efbf1240b7429f7bf554e2ead52b90a1934875d57773c1c80c405d64a
6 eec95274 4 a 21 b 5 5 c7 1 b 8 e 6d c 2 8 d a8 2 2 b f 3c 8 1 4 7 ed 5 4 3 5 1d c b 8 8 c3 0 0 9 4 eb 1 b
6eec952744a21b55c71b8e6dc28da822bf3c8147ed54351dcb88c30094eb1b
</syntaxhighlight>
</syntaxhighlight>


; Größe der Volumes ermitteln
; Größe der Volumes ermitteln
Die Größe der Volumes ermitteln Sie, indem Sie das obige Ergebnis an du weiterleiten
Die Größe der Volumes wird ermittelt, indem Sie das obige Ergebnis an ''du'' weiterleiten
* Das funktioniert in dieser Form allerdings nur auf einem Linux-Host
* Das funktioniert in dieser Form allerdings nur auf einem Linux-Host


Zeile 132: Zeile 136:
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo du -h --max 0 \
sudo du -h --max 0 \
/var/lib/docker/volumes/$ ( docker volume ls -q -f dangling = true )
/var/lib/docker/volumes/$(docker volume ls -q -f dangling = true)
</syntaxhighlight>
</syntaxhighlight>


Zeile 138: Zeile 142:


Falls Sie Docker Desktop verwenden, befinden sich die Volumes in einer virtuellen Maschine
Falls Sie Docker Desktop verwenden, befinden sich die Volumes in einer virtuellen Maschine
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="" line>
/var/lib/docker/volumes (Docker Engine )
/var/lib/docker/volumes (Docker Engine )
</syntaxhighlight>
.local/share/docker/volumes (Rootless Docker )
 
<syntaxhighlight lang="bash" highlight="1" line copy>
local/share/docker/volumes (Rootless Docker )
<syntaxhighlight lang="bash" highlight="1" line copy>
</syntaxhighlight>
</syntaxhighlight>
   
   
<syntaxhighlight lang="bash" highlight="1" line copy>
local/share/container s/storage/volumes (Podman )
</syntaxhighlight>
Falls Sie mit Docker Desktop arbeiten, ist eine Bestimmung der Volume-Größe per Kommando nicht ohne Weiteres möglich
Falls Sie mit Docker Desktop arbeiten, ist eine Bestimmung der Volume-Größe per Kommando nicht ohne Weiteres möglich
* Die Volumes befinden sich in WSL-Verzeichnissen (Windows) oder in einer virtuellen Maschine (macOS, Linux)
* Die Volumes befinden sich in WSL-Verzeichnissen (Windows) oder in einer virtuellen Maschine (macOS, Linux)
* Aber dafür reicht nun ein Klick auf den Volumes-Tab in Docker Desktop aus, um diese Informationen zu ermitteln
* Aber dafür reicht nun ein Klick auf den Volumes-Tab in Docker Desktop aus, um diese Informationen zu ermitteln


; Verwaisten Volumes löschen
; Verwaiste Volumes löschen
Alle verwaisten Volumes können Sie bei Bedarf mit dem folgenden Kommando löschen
Alle verwaisten Volumes können Sie bei Bedarf mit dem folgenden Kommando löschen


: Die Rückfrage können Sie mit -f unterdrücken
: Die Rückfrage können Sie mit -f unterdrücken
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker volume prune
docker volume prune
WARNING!
</syntaxhighlight>
This will remove all volumes not used by at least one container  
<syntaxhighlight lang="bash" highlight="" line>
Are you sure you want to continue ? [ y/N ] y
WARNING!
This will remove all volumes not used by at least one container  
Are you sure you want to continue? [y/N] y
</syntaxhighlight>
</syntaxhighlight>


Zeile 169: Zeile 167:
Mitunter ist es riskant, ein Volume einfach zu löschen, wenn Sie sich nicht mehr genau erinnern können, wozu das Volume verwendet wurde
Mitunter ist es riskant, ein Volume einfach zu löschen, wenn Sie sich nicht mehr genau erinnern können, wozu das Volume verwendet wurde
* Vielleicht befinden sich dort doch noch Daten, die Sie später brauchen
* Vielleicht befinden sich dort doch noch Daten, die Sie später brauchen
Wenn Sie Docker Desktop bzw. Podman Desktop installiert haben, können Sie unkompliziert in Volumes »hineinsehen«, also wie in einem Dateimanager alle Verzeichnisse des Volumes öffnen und die dort gespeicherten Dateien auflisten (siehe Abbildung 3.4)
Dazu starten Sie einfach einen Container und binden das Volume dort ein  
* Den Inhalt der Dateien können Sie sich dabei leider nicht ansehen, aber Sie können einzelne Dateien in das Dateisystem Ihres Host-Computers übertragen und dann dort öffnen
 
Abbildung 3.4 Blick in ein Volume in Docker Desktop
 
Wenn Sie ohne Docker Desktop arbeiten, gelingt der Blick in das Volume beinahe ebenso einfach: Dazu starten Sie einfach einen Container und binden das Volume dort ein
* In der Folge können Sie interaktiv alle Verzeichnisse erforschen
* In der Folge können Sie interaktiv alle Verzeichnisse erforschen
* Prinzipiell reicht für diesen Zweck ein Minimal-Image (z.&nbsp;B.&nbsp;Alpine Linux oder BusyBox)
* Prinzipiell reicht für diesen Zweck ein Minimal-Image (z.&nbsp;B.&nbsp;Alpine Linux oder BusyBox)
* Mehr Komfort, gerade bei der Vervollständigung von Dateiund Verzeichnisnamen, bietet aber ein Image, das die Shell bash enthält'''Docker/Grundlagen/Administration'''
* Mehr Komfort, gerade bei der Vervollständigung von Datei und Verzeichnisnamen, bietet aber ein Image, das die Shell bash enthält
 
== Administration ==
Dieser Abschnitt gibt einen ersten Überblick über Kommandos, mit denen Sie Ihr Container-System administrieren können
* Zu solchen Verwaltungsaufgaben zählen beispielsweise das Auflisten und Löschen von Images, Containern und Volumes
* Eine detaillierte Beschreibung aller wichtigen docker-Kommandos folgt in Kapitel 7, »Kommandoreferenz«
* Selbstverständlich funktionieren alle im Folgenden beschriebenen Kommandos analog auch mit podman
 
=== Platzbedarf ===
Platzbedarf von Images und Containern ermitteln Wie groß ist eigentlich der Platzbedarf für Images bzw. für den Container-Layer (also für die Daten eines Containers, die vom ursprünglichen Image abweichen)? Diese Frage beantworten die Kommandos docker images und docker ps -a -s
docker images liefert eine Liste aller heruntergeladenen bzw. selbst erzeugten Images samt Größenangabe
 
docker images
REPOSITO R Y TAG ... CREATED SIZE
wordpres s latest 17 hours ago 550 MB
mariadb latest 7 days ago 405 MB
phpmyadm i n/phpmyadmi n latest 2 months ago 477 MB
 
; docker ps
listet nur laufende Container auf
* -a weitet die Ausgabe auf alle jemals eingerichteten Container aus. -s fügt die Spalte SIZE hinzu
 
Sie gibt an, wie viel Platz die gegenüber dem Image geänderten Dateien beanspruchen
* Sofern die meisten veränderlichen Daten in einem Volume ausgelagert sind, ist der zusätzliche Platzbedarf oft winzig
* Wenn es aber Änderungen gibt, dann ist der tatsächliche Platzbedarf im lokalen Dateisystem oft spürbar größer, als docker ps vermuten lässt
* Das liegt am Overhead des Dateisystems bei der Speicherung vieler kleiner Dateien


Die Informationen in Klammern (virtual) beziehen sich auf die Gesamtgröße des Containers inklusive der Read-only-Images
; Beispiel mit Ubuntu
 
Diese Daten sind insofern virtuell, als sich mehrere Container gemeinsame Images gleichsam teilen können
<syntaxhighlight lang="bash" highlight="1" copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker ps -a -s
docker run -it --rm -v 98b95d8...:/myvol ubuntu
</syntaxhighlight>
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="" line >
CONTAINE R ID IMAGE ... SIZE
2 bf9e954b 4 b 7 wordpress 20.1 MB ( virtual 571 MB )
3 af937080 2 2 8 phpmyadmi n/... 70 B ( virtual 477 MB )
ac98aca3 7 f 7 a mariadb 2 B (virtual 405 MB )
</syntaxhighlight>


=== Container und Images löschen ===
<syntaxhighlight lang="bash" highlight="1" copy>
docker rm <id> bzw. docker rm <name> löscht den angegebenen Container
ls /myvol
 
Container- IDs und -Namen können Sie gegebenenfalls mit docker ps -a ermitteln
<syntaxhighlight lang="bash" highlight="1" line copy>
docker rm ac98aca3 7f 7 a
</syntaxhighlight>
</syntaxhighlight>


; !Vorsicht
<syntaxhighlight lang="bash" highlight="1" copy>
: docker rm hat große Ähnlichkeiten mit dem klassischen rm-Kommando unter Linux
cat /myvol/index.php
* Es löscht ohne Rückfrage und ohne die Möglichkeit, die Operation rückgängig zu machen!
 
Das folgende Kommando erzeugt zuerst mit ps eine Liste aller IDs von Containern, die vom Image ubuntu abgeleitet sind
* Diese Liste wird an docker rm weitergegeben, um alle Container zu löschen
* Wenn Sie also eine Weile mit docker run ubuntu experimentiert haben, können Sie so alle bei dieser Gelegenheit erzeugten Container wieder löschen
* Die hier präsentierte Verkettung zweier Kommandos setzt voraus, dass eine Shell wie bash oder zsh verwendet wird, wie dies unter Linux oder macOS standardmäßig der Fall ist
 
Unter Windows funktioniert das Kommando ebenfalls, sofern Sie die PowerShell verwenden
<syntaxhighlight lang="bash" highlight="1" line copy>
docker rm $ ( docker ps -a -q -f ancestor = ubuntu )
</syntaxhighlight>
</syntaxhighlight>


Noch radikaler ist das nächste Kommando: Es löscht alle existierenden Container!
Anstatt das Volume interaktiv zu erforschen, können Sie auch find anwenden
<syntaxhighlight lang="bash" highlight="1" line copy>
docker rm $ ( docker ps -aq )
</syntaxhighlight>


 
Dazu reicht das winzige busybox-Image aus:
; docker rmi imagename löscht das angegebene Image
<syntaxhighlight lang="bash" highlight="1" copy>
* Das ist nur möglich, wenn es keine von dem Image abgeleiteten Container gibt
docker run --rm -v 98b95d8...:/myvol busybox find /myvol
 
Die folgenden Kommandos löschen zuerst alle hello-world-Container und dann das hello-world-Image
<syntaxhighlight lang="bash" highlight="1" line copy>
docker rm $ ( docker ps -a -q -f ancestor = hello - world )
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" line copy>
docker rmi hello - world
</syntaxhighlight>
</syntaxhighlight>


Zur Auswahl des Volumes müssen Sie seine vollständige ID (siehe ''docker volume ls'') oder bei einem benannten Volume dessen Namen angeben. Die ID haben wir in den obigen Beispielen nur aus Platzgründen verkürzt.


Beachten Sie, dass docker rmi nur lokal ausgeführt wird
=== Gesamtüberblick ===
* Wenn Sie ein eigenes Image in den Docker Hub hochgeladen haben, bleibt das Image dort erhalten
Einen kompakten Überblick über den Speicherbedarf aller Images, Container, Volumes und des Build Caches gibt docker system df:
* Sie können es bei Bedarf in der Weboberfläche von https://hub.docker.com löschen
<syntaxhighlight lang="bash" highlight="1" copy>
 
docker system df
=== Volumes verwalten ===
Volumes werden getrennt von den Containern und Images in einem eigenen Verzeichnis gespeichert, unter Linux z.&nbsp;B.&nbsp;in/var/lib/docker/volumes
* Beim Löschen von Containern rührt Docker Volumes generell nicht an
* Sie können aber wie folgt eine
 
Liste mit den Namen oder IDs aller Volumes erstellen, zu denen der dazugehörende Container nicht mehr existiert
docker volume ls -q -f dangling = true
4 df85efbf 1 2 40 b 7 4 29 f 7 b f 55 4 e 2 e ad 5 2 b 9 0a 1 9 3 4 87 5 d 5 7 77 3 c 1 c 80 c 4 0 5 d6 4 a
6 eec95274 4 a 21 b 5 5 c7 1 b 8 e 6d c 2 8 d a8 2 2 b f 3c 8 1 4 7 ed 5 4 3 5 1d c b 8 8 c3 0 0 9 4 eb 1 b
 
Die Größe der Volumes ermitteln Sie, indem Sie das obige Ergebnis an du weiterleitest
 
Das funktioniert in dieser Form allerdings nur auf einem Linux-Host
 
Unter Windows und macOS werden die Docker-Dateien in einem eigenen Dateisystem innerhalb einer virtuellen Maschine gespeichert, auf die Sie von außen keinen direkten Zugriff haben
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo du -h --max 0 \
/var/lib/docker/volumes/$ ( docker volume ls -q -f dangling = true )
</syntaxhighlight>
 
Dabei müssen Sie den Ort angeben, wo die Volumes auf Ihrem System gespeichert werden
 
Falls Sie Docker Desktop verwenden, befinden sich die Volumes in einer virtuellen Maschine
* /var/lib/docker/volumes (Docker Engine )
* local/share/docker/volumes (Rootless Docker )
* local/share/container s/storage/volumes (Podman )
 
Falls Sie mit Docker Desktop arbeiten, ist eine Bestimmung der Volume-Größe per Kommando nicht ohne Weiteres möglich
* Die Volumes befinden sich in WSL- Verzeichnissen (Windows) bzw. in einer virtuellen Maschine (macOS, Linux)
* Aber dafür reicht nun ein Klick auf den Volumes-Tab in Docker Desktop aus, um diese Informationen zu ermitteln
Alle verwaisten Volumes können Sie bei Bedarf mit dem folgenden Kommando löschen
 
Die Rückfrage können Sie mit -f unterdrücken
<syntaxhighlight lang="bash" highlight="1" line copy>
 
docker volume prune
WARNING ! This will remove all volumes not used by at least
one container
Are you sure you want to continue ? [ y/N ] y
<syntaxhighlight lang="bash" highlight="1" line copy>
</syntaxhighlight>
</syntaxhighlight>
 
TYPE          TOTAL  ACTIVE  SIZE      RECLAIMABLE
=== Inhalt eines Volumes ansehen ===
Images        18    11      10.72 GB  1.854 GB (17%)
Mitunter ist es riskant, ein Volume einfach zu löschen, wenn Sie sich nicht mehr genau erinnern können, wozu das Volume verwendet wurde
Containers    33    4      496 MB    495.9 MB (99%)
* Vielleicht befinden sich dort doch noch Daten, die Sie später brauchen
  Local Volumes  2      1      169 MB    119.8 MB (70%)
Wenn Sie Docker Desktop bzw. Podman Desktop installiert haben, können Sie unkompliziert in Volumes »hineinsehen«, also wie in einem Dateimanager alle Verzeichnisse des Volumes öffnen und die dort gespeicherten Dateien auflisten (siehe Abbildung 3.4)
  Build Cache    0      0      0B        0B
* Den Inhalt der Dateien können Sie sich dabei leider nicht ansehen, aber Sie können einzelne Dateien in das Dateisystem Ihres Host-Computers übertragen und dann dort öffnen
 
Abbildung 3.4 Blick in ein Volume in Docker Desktop
 
Wenn Sie ohne Docker Desktop arbeiten, gelingt der Blick in das Volume beinahe ebenso einfach: Dazu starten Sie einfach einen Container und binden das Volume dort ein
* In der Folge können Sie interaktiv alle Verzeichnisse erforschen
* Prinzipiell reicht für diesen Zweck ein Minimal-Image (z.&nbsp;B.&nbsp;Alpine Linux oder BusyBox)
* Mehr Komfort, gerade bei der Vervollständigung von Dateiund Verzeichnisnamen, bietet aber ein Image, das die Shell bash enthält
* Wir haben deswegen im folgenden Beispiel mit Ubuntu gearbeitet
 
  docker run -it --rm -v 98 b95d8 ...:/myvol ubuntu
 
root # ls/myvol
 
  index
* php wp - comments - post
* php wp - includes
license
* txt wp - config -docker
* php wp - links - opml
* php
readme
* html wp - config -sample
* php wp - load
* php
wp - activate
* php wp - config .php wp - login
* php
   
   
Wenn Sie Docker schon lange in Betrieb haben und es entsprechend viele Images, Container und Volumes gibt, kann die Ausführung dieses Kommandos eine Weile dauern.
* Mit der zusätzlichen Option ''-v'' listet das Kommando sämtliche Images, Container, Volumes usw. einzeln auf.


root # cat/myvol/index .php
=== Ungenutzten Speicher freigeben ===
 
Statt nach Images, Containern und Volumes zu suchen und sie einzeln zu löschen, können Sie für Ihre Aufräumarbeiten docker system prune zu Hilfe nehmen.  
* Dieses Kommando löscht alle gerade nicht laufenden Container sowie alle Images, die nicht von anderen Images benötigt werden (dangling images).
 
root # exit
 
Anstatt das Volume interaktiv zu erforschen, können Sie auch find anwenden
* Dazu reicht das winzige busybox-Image aus
 
docker run --rm -v 98 b95d8 ...:/myvol busybox find/myvol
 
Zur Auswahl des Volumes müssen Sie seine vollständige ID (siehe docker volume ls)
oder bei einem benannten Volume dessen Namen angeben
* Die ID haben wir in den obigen Beispielen nur aus Platzgründen verkürzt
 
Gesamtüberblick Einen kompakten Überblick über den Speicherbedarf aller Images, Container, Volumes und des Build Caches gibt docker system df


docker system df
Noch intensiver wird der Großputz durch zusätzliche Optionen:
TYPE TOTAL ACTIVE SIZE RECLAIMAB L E
* -a oder --all löscht auch Images, die nicht von Containern verwendet werden.
Images 18 11 10.72 GB 1.854 GB (17%)
* --volumes löscht auch Volumes, die mit keinem Container verbunden sind. (Vorsicht!)
Containe r s 33 4 496 MB 495.9 MB (99%)
Local Volumes 2 1 169 MB 119.8 MB (70%)
Build Cache 0 0 0B 0B
 
Wenn Sie Docker schon lange in Betrieb haben und es entsprechend viele Images, Container und Volumes gibt, kann die Ausführung dieses Kommandos eine Weile dauern
Mit der zusätzlichen Option -v listet das Kommando sämtliche Images, Container, Volumes usw
* einzeln auf
 
Ungenutzten Speicher freigeben Statt nach Images, Containern und Volumes zu suchen und sie einzeln zu löschen, können Sie für Ihre Aufräumarbeiten docker system prune zu Hilfe nehmen
* Dieses Kommando löscht alle gerade nicht laufenden Container sowie alle Images, die nicht von anderen Images benötigt werden (dangling images)
Noch intensiver wird der Großputz durch zusätzliche Optionen
 
-a bzw. --all löscht auch Images, die nicht von Containern verwendet werden
--volumes löscht auch Volumes, die mit keinem Container verbunden sind. (Vorsicht!)


  docker system prune -a --volumes
  docker system prune -a --volumes
 
WARNING ! This will remove :
WARNING ! This will remove  
  - all stopped container s
  - all stopped container s
  - all networks not used by at least one containe r
  - all networks not used by at least one container
  - all volumes not used by at least one containe r
  - all volumes not used by at least one container
  - all images without at least one containe r associate d
  - all images without at least one container associated to them
to them
  - all build cache
  - all build cache
Are you sure you want to continue ? [y/N]


Are you sure you want to continue ? [ y/N ]
; docker system prune
ist bequem anzuwenden, schießt aber manchmal über das Ziel hinaus.
* Sicherer ist es, in kleinen Schritten vorzugehen.
* Die beiden folgenden Kommandos ermitteln zuerst alle Volumes, die nicht mehr in Verwendung sind.
* Gegebenenfalls können Sie diese Volumes dann in einem zweiten Schritt löschen. Beachten Sie die Option -q im zweiten Kommando, die die Ausgabe von docker volume ls auf die IDs verkürzt.
<syntaxhighlight lang="bash" highlight="1" copy>
docker volume ls -f dangling = true
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" copy>
docker volume rm $(docker volume ls -q -f dangling = true )
</syntaxhighlight>


docker system prune ist bequem anzuwenden, schießt aber manchmal über das Ziel hinaus
<syntaxhighlight lang="bash" highlight="1" copy>
* Sicherer ist es, in kleinen Schritten vorzugehen
docker ps -a | grep Exit
* Die beiden folgenden Kommandos ermitteln zuerst alle Volumes, die nicht mehr in Verwendung sind
</syntaxhighlight>
* Gegebenenfalls können Sie diese Volumes dann in einem zweiten Schritt löschen
listet alle beendeten Container auf. Das zweite Kommando extrahiert die erste Spalte mit den IDs aus der Liste und löscht diese Container:
* Beachten Sie die Option -q im zweiten Kommando, die die Ausgabe von docker volume ls auf die IDs verkürzt


docker volume ls -f dangling = true
<syntaxhighlight lang="bash" highlight="1" copy>
docker volume rm $ (docker volume ls -q -f dangling = true )
 
docker ps -a | grep Exit listet alle beendeten Container auf
 
Das zweite Kommando extrahiert die erste Spalte mit den IDs aus der Liste und löscht diese Container
<syntaxhighlight lang="bash" highlight="1" line copy>
docker ps -a | grep Exit
docker ps -a | grep Exit
docker rm $ ( docker ps -a | grep Exit | cut -d ' ' -f 1)
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" copy>
docker rm $(docker ps -a | grep Exit | cut -d ' ' -f 1)
</syntaxhighlight>
</syntaxhighlight>


Vielleicht gibt es einige Container, die Sie nicht löschen möchten
Vielleicht gibt es einige Container, die Sie nicht löschen möchten.
* Anstatt das obige Kommando auszuführen, eliminieren Sie dann mit grep -E -v zuerst alle Zeilen, die einen der durch | getrennten Suchbegriffe enthalten
* Anstatt das obige Kommando auszuführen, eliminieren Sie dann mit grep -E -v zuerst alle Zeilen, die einen der durch | getrennten Suchbegriffe enthalten.


Wenn Sie mit der nun angezeigten Liste einverstanden sind, dann löschen Sie mit dem zweiten Kommando diese Container
Wenn Sie mit der nun angezeigten Liste einverstanden sind, dann löschen Sie mit dem zweiten Kommando diese Container.
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker ps -a | grep Exit | grep -E -v 'mysql | mariadb '
docker ps -a | grep Exit | grep -E -v 'mysql | mariadb '
docker rm $ ( docker ps -a | grep Exit | \
</syntaxhighlight>
grep -E -v 'mysql | mariadb ' | cut -d ' ' -f 1)
<syntaxhighlight lang="bash" highlight="1" copy>
docker rm $(docker ps -a | grep Exit | \
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" copy>
grep -E -v 'mysql | mariadb ' | cut -d ' ' -f 1)
</syntaxhighlight>
</syntaxhighlight>


Die folgenden beiden Kommandos listen zuerst alle Images auf, die von keinem Container verwendet werden, und löschen diese dann
Die folgenden beiden Kommandos listen zuerst alle Images auf, die von keinem Container verwendet werden, und löschen diese dann:
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker images -f dangling = true
docker images -f dangling=true
docker rmi $ ( docker images -q -f dangling = true )
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="1" line copy>
<syntaxhighlight lang="bash" highlight="1" copy>
docker rmi $(docker images -q -f dangling = true)
</syntaxhighlight>
</syntaxhighlight>


* Wir haben deswegen im folgenden Beispiel mit Ubuntu gearbeitet
docker run -it --rm -v 98 b95d8 ...:/myvol ubuntu
root # ls/myvol
index
* php wp - comments - post
* php wp - includes
license
* txt wp - config -docker
* php wp - links - opml
* php
readme
* html wp - config -sample
* php wp - load
* php
wp - activate
* php wp - config .php wp - login
* php
root # cat/myvol/index .php
root # exit
Anstatt das Volume interaktiv zu erforschen, können Sie auch find anwenden
* Dazu reicht das winzige busybox-Image aus
docker run --rm -v 98 b95d8 ...:/myvol busybox find/myvol
Zur Auswahl des Volumes müssen Sie seine vollständige ID (siehe docker volume ls)
oder bei einem benannten Volume dessen Namen angeben
* Die ID haben wir in den obigen Beispielen nur aus Platzgründen verkürzt
Gesamtüberblick Einen kompakten Überblick über den Speicherbedarf aller Images, Container, Volumes und des Build Caches gibt docker system df
docker system df
TYPE TOTAL ACTIVE SIZE RECLAIMAB L E
Images 18 11 10.72 GB 1.854 GB (17%)
Containe r s 33 4 496 MB 495.9 MB (99%)
Local Volumes 2 1 169 MB 119.8 MB (70%)
Build Cache 0 0 0B 0B
Wenn Sie Docker schon lange in Betrieb haben und es entsprechend viele Images, Container und Volumes gibt, kann die Ausführung dieses Kommandos eine Weile dauern
Mit der zusätzlichen Option -v listet das Kommando sämtliche Images, Container, Volumes usw
* einzeln auf
Ungenutzten Speicher freigeben Statt nach Images, Containern und Volumes zu suchen und sie einzeln zu löschen, können Sie für Ihre Aufräumarbeiten docker system prune zu Hilfe nehmen
* Dieses Kommando löscht alle gerade nicht laufenden Container sowie alle Images, die nicht von anderen Images benötigt werden (dangling images)
Noch intensiver wird der Großputz durch zusätzliche Optionen
-a bzw. --all löscht auch Images, die nicht von Containern verwendet werden
--volumes löscht auch Volumes, die mit keinem Container verbunden sind. (Vorsicht!)
docker system prune -a --volumes
WARNING ! This will remove
- all stopped container s
- all networks not used by at least one containe r
- all volumes not used by at least one containe r
- all images without at least one containe r associate d
to them
- all build cache
Are you sure you want to continue ? [ y/N ]
docker system prune ist bequem anzuwenden, schießt aber manchmal über das Ziel hinaus
* Sicherer ist es, in kleinen Schritten vorzugehen
* Die beiden folgenden Kommandos ermitteln zuerst alle Volumes, die nicht mehr in Verwendung sind
* Gegebenenfalls können Sie diese Volumes dann in einem zweiten Schritt löschen
* Beachten Sie die Option -q im zweiten Kommando, die die Ausgabe von docker volume ls auf die IDs verkürzt
docker volume ls -f dangling = true
docker volume rm $ (docker volume ls -q -f dangling = true )
docker ps -a | grep Exit listet alle beendeten Container auf
* Das zweite Kommando
extrahiert die erste Spalte mit den IDs aus der Liste und löscht diese Container
docker ps -a | grep Exit
docker rm $ ( docker ps -a | grep Exit | cut -d ' ' -f 1)
Vielleicht gibt es einige Container, die Sie nicht löschen möchten
* Anstatt das obige Kommando auszuführen, eliminieren Sie dann mit grep -E -v zuerst alle Zeilen, die einen der durch | getrennten Suchbegriffe enthalten
* Wenn Sie mit der nun angezeigten Liste einverstanden sind, dann löschen Sie mit dem zweiten Kommando diese Container
docker ps -a | grep Exit | grep -E -v 'mysql | mariadb '
docker rm $ ( docker ps -a | grep Exit | \
grep -E -v 'mysql | mariadb ' | cut -d ' ' -f 1)
Die folgenden beiden Kommandos listen zuerst alle Images auf, die von keinem Container verwendet werden, und löschen diese dann
docker images -f dangling = true
docker rmi $ ( docker images -q -f dangling = true )


<noinclude>
<noinclude>
Zeile 527: Zeile 278:
----
----
-->
-->
== Anhang ==
== Anhang ==
=== Siehe auch ===
=== Siehe auch ===

Aktuelle Version vom 18. November 2026, 14:58 Uhr

Docker/Grundlagen/09 Administration - Docker administrieren


Administration

Kommandos

Mit denen das Container-System administriert wird

  • Zu solchen Verwaltungsaufgaben zählen etwa das Auflisten und Löschen von Images, Containern und Volumes

siehe auch

Docker/Befehle

Platzbedarf

Platzbedarf von Images und Containern ermitteln
  • für Container-Layer
  • also für die Daten eines Containers, die vom ursprünglichen Image abweichen

Diese Frage beantworten die Kommandos

  • docker images
  • docker ps -a -s
docker images

Gibt eine Liste aller heruntergeladenen und selbst erzeugten Images aus

  • Mit Größenangabe
docker images
 REPOSITORY            TAG     ... CREATED       SIZE
 wordpress             latest      17 hours ago  550 MB
 mariadb               latest      7 days ago    405 MB
 phpmyadmin/phpmyadmin latest      2 months ago  477 MB
docker ps

Listet laufende Container auf

  • -a weitet die Ausgabe auf alle jemals eingerichteten Container aus
  • -s fügt die Spalte SIZE hinzu

Sie gibt an, wie viel Platz die gegenüber dem Image geänderten Dateien beanspruchen

  • Sofern die meisten veränderlichen Daten in einem Volume ausgelagert sind, ist der zusätzliche Platzbedarf oft winzig
  • Wenn es aber Änderungen gibt, dann ist der tatsächliche Platzbedarf im lokalen Dateisystem oft spürbar größer, als docker ps vermuten lässt
  • Das liegt am Overhead des Dateisystems bei der Speicherung vieler kleiner Dateien

Die Informationen in Klammern (virtual) beziehen sich auf die Gesamtgröße des Containers inklusive der Read-only-Images

Diese Daten sind insofern virtuell, als sich mehrere Container gemeinsame Images gleichsam teilen können

docker ps -a -s
CONTAINER ID  IMAGE          ... SIZE
2bf9e954b4b7  wordpress          20.1 MB (virtual 571 MB)
3af937080228  phpmyadmin/...     70 B (virtual 477 MB)
ac98aca37f7a  mariadb            2 B (virtual 405 MB)

Daten löschen

Container und Images löschen
docker rm <id>

oder

docker rm <name>

Container- IDs und -Namen können Sie gegebenenfalls mit docker ps -a ermitteln

docker rm ac98aca37f7a
Vorsicht
docker rm hat große Ähnlichkeiten mit dem klassischen rm-Kommando unter Linux
  • Es löscht ohne Rückfrage und ohne die Möglichkeit, die Operation rückgängig zu machen!

Das folgende Kommando erzeugt zuerst mit ps eine Liste aller IDs von Containern, die vom Image ubuntu abgeleitet sind

  • Diese Liste wird an docker rm weitergegeben, um alle Container zu löschen
  • Wenn Sie also eine Weile mit docker run ubuntu experimentiert haben, können Sie so alle bei dieser Gelegenheit erzeugten Container wieder löschen
  • Die hier präsentierte Verkettung zweier Kommandos setzt voraus, dass eine Shell wie bash oder zsh verwendet wird, wie dies unter Linux oder macOS standardmäßig der Fall ist

Unter Windows funktioniert das Kommando ebenfalls, sofern Sie die PowerShell verwenden

docker rm $(docker ps -a -q -f ancestor=ubuntu)
Alle existierenden Container löschen
docker rm $(docker ps -aq)
docker rm imagename löscht das angegebene Image

Das ist nur möglich, wenn es keine von dem Image abgeleiteten Container gibt

Löschen alle hello-world-Container und dann das hello-world-Image
docker rm $(docker ps -a -q -f ancestor=hello-world)
Löschen des hello-world-Images
docker rmi hello-world

Beachten Sie, dass docker rmi nur lokal ausgeführt wird

  • Wenn Sie ein eigenes Image in den Docker Hub hochgeladen haben, bleibt das Image dort erhalten
  • Sie können es bei Bedarf in der Weboberfläche von https://hub.docker.com löschen

Volumes verwalten

Volumes werden getrennt von den Containern und Images in einem eigenen Verzeichnis gespeichert, unter Linux z. B. in /var/lib/docker/volumes

  • Beim Löschen von Containern rührt Docker Volumes generell nicht an

Sie können aber eine Liste mit den Namen oder IDs aller Volumes erstellen, zu denen der dazugehörende Container nicht mehr existiert

docker volume ls -q -f dangling=true
4df85efbf1240b7429f7bf554e2ead52b90a1934875d57773c1c80c405d64a
6eec952744a21b55c71b8e6dc28da822bf3c8147ed54351dcb88c30094eb1b
Größe der Volumes ermitteln

Die Größe der Volumes wird ermittelt, indem Sie das obige Ergebnis an du weiterleiten

  • Das funktioniert in dieser Form allerdings nur auf einem Linux-Host
Windows

Unter Windows und macOS werden die Docker-Dateien in einem eigenen Dateisystem innerhalb einer virtuellen Maschine gespeichert, auf die Sie von außen keinen direkten Zugriff haben

sudo du -h --max 0 \
/var/lib/docker/volumes/$(docker volume ls -q -f dangling = true)

Dabei müssen Sie den Ort angeben, wo die Volumes auf Ihrem System gespeichert werden

Falls Sie Docker Desktop verwenden, befinden sich die Volumes in einer virtuellen Maschine

/var/lib/docker/volumes (Docker Engine )
.local/share/docker/volumes (Rootless Docker )

Falls Sie mit Docker Desktop arbeiten, ist eine Bestimmung der Volume-Größe per Kommando nicht ohne Weiteres möglich

  • Die Volumes befinden sich in WSL-Verzeichnissen (Windows) oder in einer virtuellen Maschine (macOS, Linux)
  • Aber dafür reicht nun ein Klick auf den Volumes-Tab in Docker Desktop aus, um diese Informationen zu ermitteln
Verwaiste Volumes löschen

Alle verwaisten Volumes können Sie bei Bedarf mit dem folgenden Kommando löschen

Die Rückfrage können Sie mit -f unterdrücken
docker volume prune
WARNING!
This will remove all volumes not used by at least one container 
Are you sure you want to continue? [y/N] y

Inhalt eines Volumes ansehen

Mitunter ist es riskant, ein Volume einfach zu löschen, wenn Sie sich nicht mehr genau erinnern können, wozu das Volume verwendet wurde

  • Vielleicht befinden sich dort doch noch Daten, die Sie später brauchen

Dazu starten Sie einfach einen Container und binden das Volume dort ein

  • In der Folge können Sie interaktiv alle Verzeichnisse erforschen
  • Prinzipiell reicht für diesen Zweck ein Minimal-Image (z. B. Alpine Linux oder BusyBox)
  • Mehr Komfort, gerade bei der Vervollständigung von Datei und Verzeichnisnamen, bietet aber ein Image, das die Shell bash enthält
Beispiel mit Ubuntu
docker run -it --rm -v 98b95d8...:/myvol ubuntu
ls /myvol
cat /myvol/index.php

Anstatt das Volume interaktiv zu erforschen, können Sie auch find anwenden

Dazu reicht das winzige busybox-Image aus:

docker run --rm -v 98b95d8...:/myvol busybox find /myvol

Zur Auswahl des Volumes müssen Sie seine vollständige ID (siehe docker volume ls) oder bei einem benannten Volume dessen Namen angeben. Die ID haben wir in den obigen Beispielen nur aus Platzgründen verkürzt.

Gesamtüberblick

Einen kompakten Überblick über den Speicherbedarf aller Images, Container, Volumes und des Build Caches gibt docker system df:

docker system df
TYPE           TOTAL  ACTIVE  SIZE      RECLAIMABLE
Images         18     11      10.72 GB  1.854 GB (17%)
Containers     33     4       496 MB    495.9 MB (99%)
Local Volumes  2      1       169 MB    119.8 MB (70%)
Build Cache    0      0       0B        0B

Wenn Sie Docker schon lange in Betrieb haben und es entsprechend viele Images, Container und Volumes gibt, kann die Ausführung dieses Kommandos eine Weile dauern.

  • Mit der zusätzlichen Option -v listet das Kommando sämtliche Images, Container, Volumes usw. einzeln auf.

Ungenutzten Speicher freigeben

Statt nach Images, Containern und Volumes zu suchen und sie einzeln zu löschen, können Sie für Ihre Aufräumarbeiten docker system prune zu Hilfe nehmen.

  • Dieses Kommando löscht alle gerade nicht laufenden Container sowie alle Images, die nicht von anderen Images benötigt werden (dangling images).

Noch intensiver wird der Großputz durch zusätzliche Optionen:

  • -a oder --all löscht auch Images, die nicht von Containern verwendet werden.
  • --volumes löscht auch Volumes, die mit keinem Container verbunden sind. (Vorsicht!)
docker system prune -a --volumes
WARNING ! This will remove :
- all stopped container s
- all networks not used by at least one container
- all volumes not used by at least one container
- all images without at least one container associated to them
- all build cache
Are you sure you want to continue ? [y/N]
docker system prune

ist bequem anzuwenden, schießt aber manchmal über das Ziel hinaus.

  • Sicherer ist es, in kleinen Schritten vorzugehen.
  • Die beiden folgenden Kommandos ermitteln zuerst alle Volumes, die nicht mehr in Verwendung sind.
  • Gegebenenfalls können Sie diese Volumes dann in einem zweiten Schritt löschen. Beachten Sie die Option -q im zweiten Kommando, die die Ausgabe von docker volume ls auf die IDs verkürzt.
docker volume ls -f dangling = true
docker volume rm $(docker volume ls -q -f dangling = true )
docker ps -a | grep Exit

listet alle beendeten Container auf. Das zweite Kommando extrahiert die erste Spalte mit den IDs aus der Liste und löscht diese Container:

docker ps -a | grep Exit
docker rm $(docker ps -a | grep Exit | cut -d ' ' -f 1)

Vielleicht gibt es einige Container, die Sie nicht löschen möchten.

  • Anstatt das obige Kommando auszuführen, eliminieren Sie dann mit grep -E -v zuerst alle Zeilen, die einen der durch | getrennten Suchbegriffe enthalten.

Wenn Sie mit der nun angezeigten Liste einverstanden sind, dann löschen Sie mit dem zweiten Kommando diese Container.

docker ps -a | grep Exit | grep -E -v 'mysql | mariadb '
docker rm $(docker ps -a | grep Exit | \
grep -E -v 'mysql | mariadb ' | cut -d ' ' -f 1)

Die folgenden beiden Kommandos listen zuerst alle Images auf, die von keinem Container verwendet werden, und löschen diese dann:

docker images -f dangling=true
docker rmi $(docker images -q -f dangling = true)



Anhang

Siehe auch



Dokumentation

Projekt