Docker/Befehle: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Markierung: Zurückgesetzt
K Textersetzung - „bzw. “ durch „oder “
 
(5 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 137: Zeile 137:
* Für Optionen gibt es zwei Schreibweisen, siehe unten
* Für Optionen gibt es zwei Schreibweisen, siehe unten
|Platzhalter für ein Objekt als Ziel der Operation
|Platzhalter für ein Objekt als Ziel der Operation
* Handelt es sich um Docker-Objekte, wie Container und Images, kommt als ID der Name bzw. der Hash des Objekts zum Einsatz
* Handelt es sich um Docker-Objekte, wie Container und Images, kommt als ID der Name oder der Hash des Objekts zum Einsatz
|}
|}


Zeile 279: Zeile 279:
|-
|-
|docker container run <image>
|docker container run <image>
|Einen neuen Container aus dem angegebenen Image starten, bzw.&nbsp;einen Befehl in einem neuen Container ausführen
|Einen neuen Container aus dem angegebenen Image starten, oder einen Befehl in einem neuen Container ausführen
|-
|-
|docker container commit <container>
|docker container commit <container>
Zeile 471: Zeile 471:
[[Kategorie:Docker/Befehle]]
[[Kategorie:Docker/Befehle]]


</noinclude>
= TMP =
<noinclude>
<!--
----
{{Navigation|<zurück>|<nachste>}}
{{Navigation|BSI/200-3|BSI/200-3/Einleitung/Beispiele}}
----
-->
'''{{BASEPAGENAME}}'''
</noinclude>
== Kommandoreferenz ==
Sie wichtigsten Kommandos
{|
! Kommando !!! Funktion
| docker attach || die Ein- und Ausgabe eines Containers mit einem Terminal<
|}
verbinden
docker build                  neues Image laut Dockerfile erzeugen
docker commit                ein neues Image aus einem Container erzeugen
docker compose                mehrere Container erzeugen und ausführen
docker container              Container verwalten
docker create                neuen Container erzeugen, aber nicht starten
docker diff                  veränderte Dateien des Containers anzeigen
docker events                Aktionen des Docker-Systems anzeigen
docker exec                  Kommando in einem laufenden Container ausführen
docker export                Container in Dateiarchiv speichern
docker image                  Images verwalten
docker images                Images auflisten
docker import                Container aus Dateiarchiv erzeugen
docker info                  Status des Docker-Systems anzeigen
docker inspect                Konfiguration und Status eines Containers anzeigen
docker kill                  Container-Ausführung sofort beenden
docker login|logout          bei einem Docker-Account an-/abmelden
docker logs                  Logging-Ausgaben eines Containers zeigen
Tabelle 7.1 Die in diesem Kapitel vorgestellten docker-Kommandos
7 Kommandoreferenz
Kommando                  Funktion
docker network            Netzwerkkonfiguration verwalten
docker node              Knoten eines Docker-Schwarms verwalten
docker pause|unpause      Container-Ausführung anhalten/fortsetzen
docker port              Port-Zuordnungen eines Containers auflisten
docker ps                Container auflisten
docker pull              Image herunterladen bzw. aktualisieren
docker push              eigenes Image in ein Docker-Repository hochladen
docker rename            Container umbenennen
docker restart            Container beenden und neu starten
docker rm|rmi            Container bzw. Image löschen
docker run                neuen Container erzeugen und starten
docker secret            Geheimnisse für Services verwalten
docker service            Services verwalten
docker stack              Gruppe (Stack) von Services erzeugen
docker start              vorhandenen Container neu starten
docker stats              CPU- und Speicherbedarf regelmäßig anzeigen
docker stop              (im Hintergrund) laufenden Container beenden
docker swarm              Docker-Schwarm einrichten bzw. verwalten
docker system            Informationen über das Docker-System anzeigen
docker tag                Image-Namen oder -Tag ändern
docker top                Prozesse eines Containers anzeigen
docker update            Optionen eines Containers verändern
docker volume            Volumes verwalten
docker wait              auf das Ende eines Containers warten
Tabelle 7.1 Die in diesem Kapitel vorgestellten docker-Kommandos (Forts.)
Die in diesem Kapitel präsentierte Kommandoreferenz konzentriert sich auf die wich-
tigsten Kommandos und die am häufigsten benötigten Optionen. Eine vollständige
Beschreibung aller Kommandos finden Sie auf der folgenden Docker-Website:
https://docs.docker.com/engine/reference/commandline/docker
Subkommando erforderlich
Einige Docker-Kommandos erwarten Subkommandos, die angeben, was zu tun ist.
Beispielsweise kann docker container nicht für sich ausgeführt werden, sondern
muss durch ein Subkommando ergänzt werden (docker container rm oder docker
container stop). In diesem Kapitel sind derartige Kommandos in der Überschrift
durch einen Stern gekennzeichnet, also z. B. »docker container *«.
docker attach
docker attach <cname/cid> verbindet die Standardeingabe und -ausgabe eines Con-
tainers mit dem aktuellen Terminal. Das ist nur bei Containern zweckmäßig, bei
denen dies nicht ohnehin der Fall ist, die also nicht mit docker run -it oder mit
docker start -a -i gestartet wurden.
Bei im Hintergrund laufenden Docker-Containern von Serverdiensten ermöglicht es
docker attach häufig, Logging-Meldungen im laufenden Betrieb mitzulesen.
docker build
docker build [optionen] <verzeichnis/url> liest die Datei Dockerfile oder Container -
file vom angegebenen Ort und erzeugt ein entsprechendes Image (siehe auch
Abschnitt 4.2, »Dockerfile-Syntax«, und Abschnitt 4.4, »Images in den Docker Hub
hochladen«).
Mit der Option -t name:tag kann das Image mit einem Tag markiert werden. Außer-
dem können mit diversen Optionen, die identisch mit denen des Kommandos docker
run sind, Voreinstellungen für Container festgelegt werden, die später aus dem Image
erzeugt werden sollen (siehe Tabelle 7.2).
Beachten Sie, dass docker build bei aktuellen Docker-Versionen das neue Build-
System buildx verwendet. Bei älteren Versionen nutzt docker build das alte, docker
buildx das neue System. docker buildx kennt außerdem diverse zusätzliche Optionen,
die aus Kompatibilitätsgründen (vorerst) nicht für docker build zur Verfügung ste-
hen.
podman build ist prinzipiell mit docker build kompatibel, verwendet aber wieder ein
anderes Build-System.
docker commit
docker commit <cname/id> [<[accountname/]imagename[:tag]>] erzeugt aus einem
Container ein neues Image mit dem angegebenen Namen. Fehlt der zweite Parameter,
181
7 Kommandoreferenz
erhält das Image keinen Namen, sondern nur eine zufällige ID. Eventuelle Volumes
werden nicht in das Image integriert.
Sollte der Container gerade laufen, wird er während der Ausführung von docker
commit vorübergehend angehalten. Das können Sie mit --pause false verhindern. Sie
riskieren dann aber ein inkonsistentes Image, das entstehen kann, wenn sich das
Dateisystem des Containers während des Commits verändert.
Wenn Sie selbst neue Images einrichten möchten, ist es in der Regel zweckmäßiger,
ein Dockerfile zu verfassen und dann docker build auszuführen. Zwar ist docker
commit oft einfacher und bequemer anzuwenden; der Vorgang ist aber später nicht
reproduzierbar. Insofern ist docker commit eher eine Debugging-Hilfe, um einen
Container in einem bestimmten Zustand zu speichern und daraus bei Bedarf später
wieder neue, identische Container zu erzeugen.
docker compose *
docker compose startet bzw. verwaltet eine Gruppe von Containern. Das Setup der
Gruppe muss in der Datei compose.yaml beschrieben werden (siehe auch Kapitel 5,
»Container-Setups mit compose«). Alternativ kann der Dateiname mit der Option -f
angegeben werden.
Bei älteren Installationen bzw. unter Linux muss das Kommando in der Form
docker-compose ausgeführt werden. Unter Podman ist compose kein Subkommando zu
podman. Vielmehr muss das Script podman-compose extra installiert und in dieser Form
(also mit Bindestrich im Kommandonamen) ausgeführt werden.
In den folgenden Abschnitten beschreiben wir die wichtigsten Subkommandos von
docker compose . Wie üblich beschränken wir uns auf die für die Praxis wichtigsten
Varianten und Optionen. Die vollständige Dokumentation finden Sie hier:
https://docs.docker.com/compose/reference
docker compose config
docker compose config überprüft, ob compose.yaml frei von Syntaxfehlern ist, und
zeigt die Datei an. Die Datei wird freilich nicht wie durch cat oder less unverändert
ausgegeben, sondern so, wie sie von docker compose interpretiert wird. Unter ande-
rem werden dabei relative Pfade durch absolute ersetzt.
Leider bleibt die Reihenfolge der Einstellungen nicht erhalten. Vielmehr werden alle
Schlüsselwörter in jeder Hierarchieebene alphabetisch geordnet. Davon abgesehen,
kann Ihnen docker compose config helfen, zu verstehen, wie docker compose einzelne
Einstellungen intern verarbeitet.
docker compose down
docker compose down stoppt alle durch compose.yaml beschriebenen Container, Netz-
werke etc. und löscht sie.
docker compose events
docker compose events zeigt die Events aller laufenden Container des Projekts an, bis
das Kommando mit (Strg)+(C) beendet wird.
docker compose kill
docker compose kill beendet alle Container unmittelbar. Dieses Kommando ist nur
eine Notlösung, wenn docker compose stop oder down nicht fruchtet.
docker compose logs
docker compose logs [<servicename>] zeigt die Logging-Ausgaben aller Container
bzw. des angegebenen Containers an. Beachten Sie, dass das Kommando nur für
laufende Container funktioniert. Wenn der Start eines Containers scheitert, ist docker
compose logs kein Hilfsmittel zur Fehlersuche. Besser ist es, docker compose up ohne
die Option -d auszuführen, damit Sie eventuelle Fehlermeldungen sofort sehen.
Normalerweise endet docker compose logs mit der Ausgabe der Logging-Zeilen. Wenn
Sie die Logging-Ausgaben live verfolgen möchten, führen Sie das Kommando mit der
Option -f (follow) aus. Sie müssen nun (Strg)+(C) drücken, wenn Sie das Kommando
beenden möchten.
docker compose pause und docker compose unpause
docker compose pause hält die Ausführung aller in der Compose-Datei beschriebenen
Container an. docker compose unpause setzt die Ausführung fort.
docker compose ps
docker compose ps listet alle Container des Projekts auf:
docker compose ps
Name                            Command                              State
test_db_ 1                      docker - entrypoi nt . sh mysqld      Up
test_wor d p r es s _ 1        docker - entrypoi nt . sh apach ...  Up
docker compose rm
docker compose rm löscht nach einer Rückfrage alle gestoppten Container. Mit -f
verzichtet das Kommando auf die Sicherheitsabfrage, mit -v löscht es auch die dazu-
7 Kommandoreferenz
gehörenden anonymen Volumes (also Volumes, deren Ort Sie nicht selbst explizit
vorgegeben haben).
docker compose run
docker compose run <servicename> [<kommando>] startet den durch <servicename> aus-
gewählten Container und führt im Vordergrund entweder das angegebene Kom-
mando (z. B. /bin/sh) oder das Defaultkommando der Images aus. Wenn mit run eine
Shell gestartet wird, kann sie interaktiv bedient werden.
docker compose run startet zusätzlich zu dem im ersten Parameter ausgewählten Con-
tainer auch alle abhängigen Container. Solche Abhängigkeiten müssen durch das
Schlüsselwort depends_on in compose.yaml formuliert werden. Dieses Verhalten kön-
nen Sie mit der Option --no-deps verhindern.
Mit den Optionen -v <volume>, -p <port> und -e VAR=value können Sie Volumes,
Ports und Umgebungsvariablen angeben. Die zusätzliche Option --rm bewirkt, dass
der Container nach seiner Nutzung sofort wieder gelöscht wird. Mit -d wird das Kom-
mando im Hintergrund ausgeführt.
docker compose start, docker compose stop und docker compose restart
docker compose stop beendet die Ausführung der Container. docker compose start
startet die Container wieder. docker compose restart entspricht der Kombination aus
stop und start.
docker compose top
docker compose top zeigt die Prozesse aller Container an. (Im folgenden Listing fehlen
aus Platzgründen einige Spalten.)
docker compose top
test_db_ 1
UID    PID          C      STIME          TIME                CMD
-------- - -- - - - - -- - - - - -- - - - - -- - - - - -- - - - - -- - -
999  27869        3      12:51          00:00:00            mysqld
test_wor d p r es s _ 1
UID            PID          C      STIME          TIME                CMD
-------- - -- - - - - -- - - - - -- - - - - -- - - - - -- - - - - -- - - - - -- - - - - -- - - - - -- - - -
root          27979        1      12:51          00:00:00            apache2 -DFOREGROU N D
www - data    28159        0      12:51          00:00:00            apache2 -DFOREGROU N D
www - data    28160        0      12:51          00:00:00            apache2 -DFOREGROU N D
www - data    28161        0      12:51          00:00:00            apache2 -DFOREGROU N D
www - data    28162        0      12:51          00:00:00            apache2 -DFOREGROU N D
docker compose up
docker compose up erzeugt die in compose.yaml im services -Abschnitt aufgelisteten
Container und startet sie. Gleichzeitig wird für die Container-Gruppe ein Netzwerk
eingerichtet, in dem die Container miteinander kommunizieren.
Den Namen aller Container, Netzwerke, Volumes etc. wird der Name des aktuellen Ver-
zeichnisses vorangestellt. Wenn in compose.yaml also beispielsweise der Service mydb
beschrieben wird und sich compose.yaml im Verzeichnis nctest befindet, dann ergibt
sich der Container-Name nctest_mydb_1 . Wenn Sie einen anderen Projektnamen wün-
schen, können Sie ihn mit der Option -p angeben.
Mit der üblicherweise verwendeten Option -d führt docker compose die Container im
Hintergrund aus. Fehlt diese Option, läuft docker compose hingegen so lange weiter,
bis alle Container enden – bei Serverdiensten in der Regel also endlos. Das hat den
Vorteil, dass die gesammelten Logging- und Fehlermeldungen aller Container ange-
zeigt werden.
Für Debugging-Zwecke kann es also durchaus sinnvoll sein, auf die Option -d bewusst
zu verzichten. Um das Kommando zu beenden, müssen Sie nun (Strg)+(C) drücken.
Die Container werden dann gestoppt, aber nicht gelöscht. Die Ausführung der Contai-
ner kann mit docker compose start fortgesetzt werden.
docker container *
docker container ist der Startpunkt von mehr als zwei Dutzend Kommandos zur Ver-
waltung von Containern. In vielen Fällen gibt es allerdings gleichwertige kürzere Kom-
mandos, die weiter verbreitet sind und denen in diesem Buch der Vorzug gegeben
wird. Anstelle von docker container rm <name/id> führen Sie also einfach docker rm
<name/id> aus, statt docker container stop <name> einfach docker stop <name> usw.
docker create
docker create [optionen] <imagename> [<kommando> [argumente]] erzeugt ähnlich
wie docker run einen Container, der vom angegebenen Image abgeleitet ist. Anders
als bei docker run wird der Container allerdings nicht gestartet. Dazu müssen Sie zu
einem späteren Zeitpunkt docker start <containername> ausführen. Eine Übersicht
der vielen Optionen, die Sie an docker create übergeben können, finden Sie bei der
Beschreibung von docker run im weiteren Verlauf dieses Abschnitts.
docker diff
docker diff <cname/cid> liefert eine Liste aller Dateien, die sich im Container im Ver-
gleich zum Image geändert haben. Die Dateien bzw. Verzeichnisse werden mit drei
Buchstaben gekennzeichnet: A (added), D (deleted) oder C (changed).
7 Kommandoreferenz
docker diff apache
C / usr / local / apache2 / logs
A / usr / local / apache2 / logs / httpd . pid
docker events
docker events zeigt kontinuierlich an, welche Aktionen das Docker-System ausführt.
Dazu zählen z. B. der Start und das Beenden von Containern, das Herstellen von Netz-
werkverbindungen, der Verbindung von Containern mit Volumes (mount) etc. Das für
Debugging-Zwecke gedachte Kommando läuft, bis es mit (Strg)+(C) beendet wird.
docker exec
docker exec [optionen] <containername> kommando [argumente] führt in einem be-
reits laufenden Container ein weiteres Kommando aus. Wie bei docker run ermögli-
chen die Optionen -i -t eine interaktive Bedienung. Mit der Option -d (detached)
wird das Kommando im Hintergrund ausgeführt.
docker exec -it mariadb_ co n t a i ne r / bin / sh
docker export
docker export <cname/cid> > datei.tar schreibt alle Dateien eines Containers in ein
TAR-Archiv. Unter Linux und macOS kann die resultierende Datei anschließend mit
tar tf datei.tar angesehen oder mit tar xf datei.tar ausgepackt werden. Unter
Windows übernehmen ZIP-Oberflächen diese Funktionen. Mit docker import können
Sie aus der TAR-Datei ein neues Image erzeugen.
Wenn Sie das Archiv gleich komprimieren möchten, führen Sie das Kommando unter
Linux oder macOS wie folgt aus:
docker export <cname > | gzip -c > export . tar . gz
docker export verarbeitet alle Dateien des Containers, nicht nur die, die sich im
Vergleich zum zugrundeliegenden Image verändert haben. In Volumes befindliche
Dateien werden dagegen nicht berücksichtigt.
docker image *
docker image ist der Startpunkt für diverse Subkommandos zur Verwaltung von
Images. Einige Kommandos sind auch in kürzeren Formen verfügbar. Beispielsweise
entspricht docker image rm dem Kommando docker rmi.
docker image build <pfad/url> verarbeitet das Dockerfile im angegebenen Ver-
zeichnis bzw. an der angegebenen Adresse und generiert daraus ein neues Image
(siehe docker build).
docker image prune löscht nach einer Rückfrage alle Images, die nicht von ande-
ren Images benötigt werden. Wird das Kommando mit der Option -a ausgeführt,
löscht es darüber hinaus alle Images, von denen keine Container abgeleitet wur-
den.
docker image pull/push lädt ein Image vom Docker Hub herunter bzw. lädt ein
selbst erzeugtes Image hoch (siehe docker pull und docker push).
docker image rm <name/id> löscht ein Image (siehe docker rmi).
Vorsicht
Passen Sie auf, dass Sie nicht versehentlich docker images ls oder ein anderes Sub-
kommando ausführen. docker images mit Plural-s ist ein eigenes Kommando (siehe
den nächsten Abschnitt). Bei docker images xy wird xy nicht als Subkommando, son-
dern als Image-Name interpretiert. Normalerweise gibt es keine Images, die ls, prune
etc. heißen; daher führt docker images zu keinem Ergebnis – aber auch zu keiner Feh-
lermeldung. Es sieht dann so aus, als würde das Kommando nicht funktionieren.
docker images
docker images [<reponame:tag>] listet alle lokal vorhandenen Images auf. Wenn an
das Kommando der Name eines Repositorys übergeben wird, dann werden nur
Images dieser Quelle angezeigt.
An das Kommando können die folgenden Optionen übergeben werden:
Mit -a zeigt das Kommando auch Interim-Images auf, die beim Erzeugen eigener
Images mit docker build entstehen.
Mit -f "key=value" (filter) zeigt das Kommando nur Images an, die ein bestimmtes
Kriterium erfüllen. Zulässige Filter sind dangling , before , since und reference . Bei-
spielsweise liefert das Kommando mit -f "dangling=true" Images, die aktuell von
keinem Container genutzt werden.
Mit -q (quiet) liefert das Kommando nur eine Liste von Image-IDs, aber keine wei-
teren Informationen. Die Option ist dann empfehlenswert, wenn die IDs an ein
anderes Kommando weitergegeben werden sollen.
docker import
docker import <datei.tar> <imagename> erzeugt aus einem zuvor mit docker export
erzeugten TAR-Archiv ein neues Image. Wenn Sie das TAR-Archiv aus der Standardein-
gabe lesen möchten, geben Sie anstelle des Dateinamens das Zeichen - an:
gunzip -c datei . tar . gz | docker import - newimagen a m e
7 Kommandoreferenz
docker info
docker info sowie das gleichwertige Kommando docker system info zeigen umfas-
sende Informationen zur Docker-Installation an:
docker info
Client :
Version :    24.0.2
Context :    default
Debug Mode : false
Plugins :
buildx : Docker Buildx ( Docker Inc .)
Version : 0.11.0
Path :    /usr / lib / docker / cli - plugins / docker - buildx
compose : Docker Compose (Docker Inc .)
Version : 2.18.1
Path :    /usr / lib / docker / cli - plugins / docker - compose
Server :
Containe r s : 58
Running : 2
Paused : 0
Stopped : 56
Images : 118
Server Version : 24.0.2
...
Noch mehr Informationen
Detailliertere Informationen zur installierten Docker-Version liefert docker version .
Wollen Sie hingegen Informationen zu einem bestimmten Container, führt docker
inspect zum Ziel. docker system df verrät schließlich Informationen zur Speicher-
nutzung von Docker.
Die Kommandos docker events und docker stats zeigen kontinuierlich Informatio-
nen über den laufenden Betrieb des Docker-Systems an. docker stats entspricht
dabei dem unter Linux und macOS bekannten top-Kommando.
docker inspect
docker inspect <containername> liefert umfassende Informationen über den ange-
gebenen Container. Aus den in JSON-Syntax dargestellten Daten, die üblicherweise
mehr als 200 Zeilen lang sind, gehen unter anderem die folgenden Informationen
hervor: das zugrundeliegende Image, die Speicherorte für den Container und seine
Volumes, der aktuelle Status sowie diverse Konfigurations- und Netzwerkparameter.
Anstelle des Namens können Sie natürlich auch die ID des Containers an das Kom-
mando übergeben.
docker inspect -s apache -test
[
{
" Id ": " e53b ..." ,
" Created ": "2021 -05 -28 T12 :03:44.94 9 8 5 38 0 1 Z " ,
" Path ": "httpd - foregrou n d " ,
" Args ": [ ] ,
" State ": {
" Status ": " exited " ,
" Running ": false ,
...
Wenn Sie aus den Daten nur ein bestimmtes Element herausfiltern möchten, können
Sie dieses Element mit -f (format) auswählen. Die beiden folgenden Beispiele zeigen,
wie Sie den Status des Containers sowie alle Volumes anzeigen:
docker inspect -s -f "{{. State .Status }}" apache - test
exited
docker inspect -s -f "{{. Mounts }}" mariadb -test1
[{ volume 0 fbd .... / var /lib / docker / volumes /0 fbd .../ _data
/ var / lib / mysql local true }]
docker kill
docker kill <cname/id> sendet standardmäßig das Signal KILL an den Container. In
der Regel wird die Ausführung des Containers damit unmittelbar beendet. Der Pro-
zess hat keine Möglichkeit, Dateien zu schließen oder Transaktionen zu beenden. Mit
der Option -s können auch andere Signale gesendet werden, z. B. -s TERM.
In der Regel sollten Sie docker stop vorziehen, wenn Sie die Ausführung eines
Containers beenden möchten. docker stop sendet zuerst ein TERM-Signal an den
Hauptprozess des Containers und gibt dem Container so die Chance, ordentlich he-
runterzufahren. Nur wenn der Prozess nach einer bestimmten Zeit nicht reagiert,
folgt ein KILL-Signal.
docker login und docker logout
docker login stellt eine Verbindung zu einem Docker-Account her und speichert das
Authentifizierungs-Token dauerhaft. Ein Login ist beispielsweise erforderlich, bevor
Sie ein selbst erzeugtes Image mit docker push in den Docker Hub hochladen.
docker logout löscht ein mit docker login eingerichtetes Authentifizierungs-Token.
7 Kommandoreferenz
docker logs
docker logs <containername/id> zeigt die protokollierten Nachrichten des Contai-
ners an. Dieser Zugriff auf die Logging-Daten funktioniert nur, wenn das zugrunde-
liegende Image entsprechend eingerichtet wurde. Bei vielen populären Images ist
das bereits der Fall. Je nach Konfiguration werden die Logging-Nachrichten in einen
Ring-Puffer geschrieben. Sobald dieser Puffer vollläuft, überschreiben neue Logging-
Nachrichten alte.
Sollte docker logs keine Resultate liefern, können Sie im Container nach Logging-
Dateien suchen. Dazu starten Sie parallel zum Container eine Shell (z. B. mit docker
exec <cname> /bin/bash) und werfen einen Blick in das Verzeichnis /var/log.
Logging für eigene Images konfigurieren
Wenn Sie selbst Docker-Images zusammenstellen, finden Sie auf der folgenden Seite
ausführliche Informationen über die Logging-Mechanismen von Docker und deren
Anwendung und Konfiguration:
https://docs.docker.com/config/containers/logging/configure
docker network *
docker network ist der Ausgangspunkt zu mehreren Subkommandos zur Adminis-
tration der Docker-Netzwerkfunktionen. Die Kommandos betreffen nicht einzelne
Container oder Images, sondern das Docker-System in seiner Gesamtheit.
Standardmäßig stellt Docker seinen Containern über ein vorkonfiguriertes Netzwerk
mit dem Namen bridge ein privates Netzwerk mit Internetzugang zur Verfügung. Den
Containern werden IP-Adressen im Bereich 172.17.0.0/16 zugewiesen.
Zur Ausführung einzelner Container reicht die Defaultkonfiguration in der Regel aus.
Um Gruppen von Containern hingegen von anderen Containern zu trennen, wird
für sie häufig ein eigenes Netzwerk eingerichtet, in dem die Container miteinander
kommunizieren. Grundsätzlich ist dies manuell möglich, einfacher ist es aber, den
Vorgang zu automatisieren (siehe Kapitel 5, »Container-Setups mit compose«).
docker network create/rm richtet ein zusätzliches Netzwerk für Docker ein bzw.
löscht es wieder.
docker network connect <nwid> <cname/cid> verbindet ein Netzwerk mit einem
Container.
docker network inspect <nwname/nwid> liefert Details zu einem bestimmten Netz-
werk:
docker network inspect bridge
[
{
" Name ": " bridge " ,
" Id ": "91 ad2ea2 ..." ,
" Created ": "2021 -06 -01 T07 :25:42.526455 28 9+ 02 :0 0" ,
" Scope ": " local " ,
" Driver ": " bridge " ,
" EnableIPv 6 ": false ,
" IPAM ": {
" Driver ": " default " ,
" Options ": null ,
" Config ": [
{
" Subnet ": "172.17.0.0/16" ,
" Gateway ": "172.17. 0. 1 "
}
]
},
...
docker network ls listet auf, welche (virtuellen) Netzwerke Docker kennt:
docker network ls
NETWORK ID      NAME                DRIVER  SCOPE
91 ad2ea2bc c f bridge              bridge  local
416 eaaaac50 6  host                host    local
0f0d89d18 9 f 8 none                null    local
docker network prune löscht alle Netzwerke, die aktuell nicht genutzt werden. Das
Kommando ist hilfreich, um nach Experimenten mit docker compose oder docker
stack deploy verwaiste Netzwerke zu eliminieren.
Hintergrundinformationen zur Docker-Netzwerkkonfiguration finden Sie hier:
https://docs.docker.com/network
podman network funktioniert im Prinzip wie docker network , allerdings gelten andere
Defaulteinstellungen (siehe auch Abschnitt 6.8, »Podman-Interna«). Insbesondere
lautet die IPv4-Adresse für Podman-Container standardmäßig 10.0.2.100. Jeder Con-
tainer erhält zusätzlich eine IPv6-Adresse. Einen guten Überblick über Podman-
spezifische Netzwerkdetails finden Sie hier:
https://www.redhat.com/sysadmin/container-networking-podman
https://github.com/containers/podman/blob/main/docs/tutorials/
basic_networking.md
191
7 Kommandoreferenz
docker node *
Wenn Sie mehrere Docker-Instanzen als Schwarm konfigurieren (siehe docker swarm),
hilft docker node bei der Administration der Knoten des Schwarms. docker node ist
der Ausgangspunkt für diverse Subkommandos:
docker node ls listet alle Knoten auf und gibt ihre ID-Zeichenketten, Host-Namen
und Status an.
docker node inspect <nodeid/hostname> liefert Detailinformationen zu einem
Knoten. Mit der Option --pretty wird die Ausgabe besser lesbar als Text formatiert.
docker node rm <nodeid/hostname> entfernt einen Knoten aus dem Schwarm.
Dieses Kommando existiert bei Podman nicht.
docker pause und docker unpause
docker pause <cname/cid> hält die Ausführung eines Containers an.
docker unpause <cname/cid> setzt die Ausführung eines pausierten Containers fort.
docker port
docker port <cname/cid> listet alle Port-Zuordnungen eines Containers auf:
docker port apache
80/ tcp -> 0.0.0.0:8 0 8 0
Wenn Sie als zweiten Parameter einen Port des Containers angeben, liefert docker
port lediglich den entsprechenden Port auf dem Host-System:
docker port apache 80/ tcp
0.0.0.0: 8 0 8 0
podman port funktioniert weitestgehend wie docker port. Allerdings müssen Sie als
Parameter den Namen oder die ID eines Containers übergeben oder die Option -a
angeben, damit alle Ports aufgelistet werden.
docker ps
Ohne weitere Optionen gibt docker ps eine Liste aller laufenden Container zurück.
Mit der Option -a enthält die Liste alle eingerichteten Container, unabhängig davon,
ob sie gerade laufen oder nicht.
Fügen Sie noch die Option -s hinzu, erfahren Sie auch die Container-Größe. Die Größe
wird in zwei Zahlen angegeben. Die erste Zahl gibt auch den Platzbedarf der Images an.
Es ist aber möglich, dass mehrere Container gemeinsam auf ein Image zurückgreifen.
Deswegen wird in Klammern außerdem die virtuelle Größe angegeben. Das ist die
Größe der veränderlichen Overlay-Datei, also der Daten, durch die sich der Container
von seinem Basis-Image unterscheidet. (Beide Werte berücksichtigen nicht die Größe
der Volumes. Die Gesamtgröße aller Volumes finden Sie am einfachsten mit docker
system df heraus.)
Mit der Option -f <kriterium=wert> können Sie ein Filterkriterium angeben. Dabei
können Sie unter anderem die folgenden Schlüsselwörter verwenden:
id/name/label=...: Liefert Container mit einer vorgegebenen ID, einem Namen
oder Label.
status=created|restarting|running|removing|paused|exited|dead: Liefert Contai-
ner im angegebenen Zustand.
ancestor=<imagename/id>: Liefert Container, die vom angegebenen Image abgelei-
tet sind.
before=<cname/id> und since=<cname/id>: Liefert Container, die vor oder nach ei-
nem Referenz-Container erzeugt wurden.
docker pull
docker pull imagename[:tag] lädt die neueste Version eines Images herunter. Da die-
ser Vorgang im Rahmen der ersten Ausführung von docker create oder docker run
für ein bestimmtes Image ohnedies automatisch erfolgt, ist es nicht erforderlich,
docker pull vor dem Einrichten eines neuen Containers explizit auszuführen.
In der Folge verwenden docker create und docker run weiterhin einmal heruntergela-
dene Images, auch dann, wenn mittlerweile neuere Versionen zur Verfügung stehen.
Mit docker pull erzwingen Sie ein Update eines Images. Dabei ist es aber wichtig, dass
Sie die interne Vorgehensweise von Docker verstehen:
Bereits vorhandene Container, die auf einer alten Version eines Images basieren,
bleiben unverändert, werden also nicht aktualisiert. Derartige Container-Updates
sind in Docker gar nicht vorgesehen.
docker ps zeigt bei solchen Containern in der Spalte IMAGE nun nicht mehr den
Namen des Images an, sondern die ID des alten Images. Es sieht also so aus, als
gäbe es das alte Image gar nicht mehr. Tatsächlich bleiben aber alle Layerdateien
des alten Images erhalten, solange es Container gibt, die darauf aufbauen.
Nur neue Container, die von nun an mit docker create oder docker run einge-
richtet werden, verwenden die mit docker pull heruntergeladene neueste Image-
Version.
7 Kommandoreferenz
docker push
docker push <accountname/imagename[:tag]> lädt ein selbst erzeugtes Image in Ihren
Docker-Account hoch. Das setzt voraus, dass Sie sich zuvor mit docker login ange-
meldet haben und dass Sie mit docker build oder docker commit ein eigenes Image
erzeugt haben.
docker rename
docker rename <oldname/id> <newname> gibt einem Container einen neuen Namen.
docker restart
docker restart <cname/id> beendet einen Container und startet ihn dann wieder. Das
Kommando entspricht der Kombination von docker stop und docker start.
docker rm und docker rmi
docker rm <containername/id> löscht den angegebenen Container. Mit der Option -f
(force) kann das Kommando selbst dann ausgeführt werden, wenn der Container
noch läuft. Volumes bleiben standardmäßig erhalten. Diese können Sie entweder
mit der zusätzlichen Option -v sofort löschen oder zu einem späteren Zeitpunkt mit
docker volume rm <volid>.
docker rmi <imagename/id> löscht analog ein Image. Wenn es mehrere gleichnamige
Images mit unterschiedlichen Tags gibt, müssen Sie das Tag ebenfalls angeben, also
z. B. docker rmi ubuntu:18.04.
Standardmäßig können Sie nur Images löschen, die nicht von einem Container
genutzt werden. Mit der Option -f überwinden Sie diesen Schutzmechanismus. Das
Image wird dann allerdings nicht vollständig gelöscht. Vielmehr bleiben die Layer-
dateien des Images erhalten, damit der Container weiter ausgeführt werden kann.
Sie können aber keine neuen Container von diesem Image ableiten. Außerdem zeigt
docker ps in der Spalte IMAGE nicht mehr den Image-Namen, sondern nur eine ID an.
docker run
Das Kommando erzeugt einen neuen Container und führt ihn dann sofort aus. In der
Folge müssen Sie zum neuerlichen Ausführen des bereits vorhandenen Containers
aber das Kommando docker start verwenden. Die an docker run übergebenen Optio-
nen bestimmen dauerhaft die Eigenschaften des neuen Containers (siehe Tabelle 7.2).
Wir konzentrieren uns hier auf die wichtigsten Optionen. Der Manual-Text von
man docker-run würde sich in der Formatierung dieses Buchs über rund 15 Seiten
erstrecken! Die allgemeine Syntax für docker run sieht so aus:
docker run [ optionen ] <imagename > [ <kommando > [ <argumente >]]
Option                      Bedeutung
--cpus="1.25"                Der Container darf maximal 1,25 CPU-Cores auslasten.
-d                            Container als Dämon ausführen
-e VAR=value                  Umgebungsvariable für den Container setzen
-h hostname                  den Host-Namen für den Container festlegen
-i                            Container diesmal interaktiv ausführen
-m 512m                      Container-RAM auf 512 MiB limitieren
--name cname                  dem Container einen Namen zuweisen
--network nname              das angegebene Netzwerk verwenden
-p localport:cport            Ports des Containers mit Ports des Hosts verbinden
-P                            alle Ports des Containers mit zufälligen Host-Ports
verbinden
--rm                          Container löschen, sobald die Ausführung endet
--restart xxx                Restart-Verhalten festlegen (siehe Abschnitt 6.6)
-t                            Pseudoterminal mit Standardeingabe verbinden
-u uid:gid                    den Container mit diesen Rechten ausführen (statt als root)
-v cdir                      Container-Verzeichnis als Volume einrichten
-v vname:cdir                Volume mit Namen erzeugen
-v /localdir:cdir            Host-Verzeichnis mit Container-Verzeichnis verbinden
--volumes-from cn            Volumes eines anderen Containers nutzen
Tabelle 7.2 Wichtige Optionen des docker-run-Kommandos
Wenn Sie nach dem Image-Namen kein Kommando angeben, wird das für das Image
festgelegte Defaultkommando ausgeführt (siehe auch die Beschreibung der Schlüs-
selwörter CMD und ENTRYPOINT in Abschnitt 4.2, »Dockerfile-Syntax«). Bei Base-Images
für Linux-Distributionen lautet das Defaultkommando oft bash und ermöglicht so die
interaktive Verwendung des Containers.
Beachten Sie, dass Sie sich beim Erzeugen eines neuen Containers nicht nur mit den
Optionen, sondern auch mit dem auszuführenden Kommando festlegen! Wenn Sie
den mit docker run erzeugten Container später mit docker start neuerlich ausführen,
wird im Container dasselbe Kommando wie beim ersten Start ausgeführt. Immerhin
besteht die Möglichkeit, bei einem laufenden Container mit docker exec ein weiteres
Kommando parallel auszuführen. Diese Möglichkeit ist aber primär zu Debugging-
Zwecken gedacht.
7 Kommandoreferenz
Die einzelnen Optionen eines Containers können Sie dann später mit docker update
verändern.
podman run funktioniert grundsätzlich wie docker run. Der wichtigste Unterschied
betrifft die Angabe des Image-Namens. docker run lädt Images automatisch vom
Docker Hub herunter, es sei denn, Sie geben explizit eine andere Registry an.
Für Podman ist hingegen häufig unklar, auf welche Registry Sie sich beziehen. Das
Kommando listet dann die in /etc/containers/registries.conf definierten Einträge
auf, und Sie müssen die Auswahl interaktiv vornehmen. Diesen Schritt ersparen Sie
sich, indem Sie dem Image-Namen die Registry und das Repository voranstellen, bei-
spielsweise so:
podman run -d docker . io / library / httpd
Alternativ können Sie in einer *.conf-Datei in /etc/containers/registries.conf.d
für häufig benötigte Images Aliasse definieren.
docker secret *
Secrets bieten eine Möglichkeit, Passwörter, Schlüssel, Zertifikate und andere vertrau-
liche Daten so in einen Service zu übertragen, dass sie niemals persistent im Datei-
system des Containers landen. Secrets setzen voraus, dass Sie einen Docker-Schwarm
einrichten und mit Services arbeiten (siehe docker swarm und docker service).
Das Kommando docker secret ist der Startpunkt zu mehreren Subkommandos:
docker secret create <secretname> <dateiname> erzeugt ein Geheimnis, wobei die
Daten wahlweise entweder aus einer Datei oder der Standardeingabe (Dateiname -)
stammen.
echo " geheim " | docker secret create mysecret -
docker secret inspect <sid/sname> zeigt Details zum Geheimnis an, also z. B. den
Zeitpunkt, wann das Geheimnis eingerichtet wurde. Der Inhalt wird nicht ange-
zeigt.
docker secret ls listet die Namen aller Geheimnisse auf.
docker secret rm <sid/sname> löscht ein Geheimnis.
In der Praxis werden Secrets nur selten manuell administriert. Weitaus öfter wer-
den Referenzen auf vertrauliche Dateien in compose.yaml angegeben (siehe Kapitel 5).
docker stack deploy führt dann automatisch docker secret aus und übergibt die ver-
traulichen Daten an die Services.
docker service *
docker service ist der Startpunkt für diverse Kommandos zur Verwaltung von Ser-
vices. In Docker helfen Services dabei, Docker-Dienste in einem Cluster bzw. Schwarm
zu administrieren.
docker service create erzeugt einen neuen Service. Ähnlich wie bei docker run
oder docker create müssen dabei eine Menge Parameter übergeben werden. Effi-
zienter ist es, die Services in einer compose.yaml-Datei zu beschreiben und mit
docker stack deploy einzurichten.
docker service inspect <sname/sid> liefert detaillierte Informationen zu einem
Service. Mit der Option --pretty wird die Ausgabe besser lesbar als Text formatiert.
docker service logs <sname/sid> zeigt Logging-Informationen zu einem Service
an.
docker service ls listet alle laufenden Services auf.
docker service ps <sname/sid> listet die Tasks (Prozesse) eines Service auf.
docker service remove <sname/sid> löscht einen Service.
docker service update <sname/sid> verändert die Parameter eines Service.
Zu docker service gibt es kein äquivalentes Podman-Kommando.
docker stack *
docker stack ist der Startpunkt für diverse Kommandos zur Verwaltung von Stacks.
Ein Stack ist eine Gruppe von Services, die in einem Docker-Cluster (Schwarm) ausge-
führt werden können. Das Kommando setzt daher voraus, dass der aktuelle Rechner
Teil eines Docker-Schwarms ist (siehe auch docker swarm init).
docker stack deploy -c <datei> <stackname> erzeugt eine Gruppe von mehreren
Services, wobei die mit <datei> angegebene compose.yaml-Datei ausgewertet wird.
<stackname> gibt dem neuen Stack einen Namen. Das Kommando muss auf einem
Managerknoten ausgeführt werden.
Die Syntax von compose.yaml sowie ein Beispiel zur Anwendung von docker stack
deploy finden Sie in Kapitel 5, »Container-Setups mit compose«.
docker stack ls listet alle Stacks auf und gibt an, aus wie vielen Services sie be-
stehen.
docker stack ps <stackname> listet alle Tasks eines Stacks auf. Das Kommando
muss auf einem Managerknoten ausgeführt werden.
docker stack rm <stackname> löscht den angegebenen Stack mit all seinen Services,
Netzwerken etc. Auch dieses Kommando muss auf einem Managerknoten ausge-
führt werden.
7 Kommandoreferenz
docker stack services <stackname> liefert eine Liste aller Services, aus denen der
angegebene Stack besteht. Auch dieses Kommando funktioniert nur auf einem
Managerknoten.
Zu docker stack gibt es kein äquivalentes Podman-Kommando. Dafür kennt Podman
sogenannte Pods. Dabei handelt es sich ebenfalls um Gruppen von Containern. Ihre
Verwaltung erfolgt durch podman pod. Ein kurzes Beispiel für die Anwendung dieses
Kommandos haben wir in Abschnitt 6.8, »Podman-Interna«, präsentiert.
docker start und docker stop
docker start [optionen] <containername> startet einen bereits eingerichteten, aber
aktuell nicht laufenden Container. Mit der Option -a (attach) werden Standardaus-
gaben und Fehlermeldungen weitergeleitet. Die Option -i (interactive) gilt analog für
die Standardeingabe wie bei docker run.
docker stop [-t <n>] <containername> beendet einen im Hintergrund laufenden
Container. Der Hauptprozess wird dazu mit dem Signal TERM aufgefordert, herunter-
zufahren. Läuft der Container nach 10 Sekunden noch immer, wird der Hauptprozess
mit dem Signal KILL unmittelbar beendet. Die Zeitspanne für die Reaktion auf TERM
kann mit der Option -t eingestellt werden.
docker stats
docker stats [optionen] [cname/cid] zeigt kontinuierlich an, welcher Container wie
viel CPU-Leistung, Speicherplatz, Netzwerk- und I/O-Ressourcen beansprucht. Die
Ausgabe wird regelmäßig aktualisiert, bis Sie die Ausführung des Kommandos mit
(Strg)+(C) beenden. Das Kommando hat damit eine ähnliche Funktion wie das top-
Kommando unter Linux bzw. macOS.
docker stats berücksichtigt standardmäßig alle laufenden Container. Mit der Option
-a listet das Kommando auch alle aktuell gestoppten Container auf. Umgekehrt zeigt
docker stats nur Informationen zu einem oder mehreren Containern an, wenn deren
Namen oder IDs als Parameter übergeben werden.
Das folgende Listing ist aus Platzgründen stark gekürzt:
docker stats
ID        NAME          CPU %      MEM            NET I /O  BLOCK I /O  PIDS
b1d9 ... dock ...      1.81%      49.05 MiB      1.07 kB    94.2 kB      21
4 cf3 ... u180 ...      0.00%      1.008 MiB      578 B      0B          1
e53b ... mari ...      0.00%      92.53 MiB      1.11 kB    14.2 MB      30
docker top und docker system df
Wenn Sie wissen möchten, welche Prozesse innerhalb eines Containers laufen, ver-
wenden Sie docker top. Sind Sie daran interessiert, wie viel Platz Images, Container
etc. auf Ihrem Docker-Rechner beanspruchen, verwenden Sie docker system df.
docker swarm *
Ein Docker Swarm (dt. Docker-Schwarm) ist ein Netzwerk aus mehreren Computern,
auf denen jeweils Docker läuft. Oft wird ein derartiges Netzwerk auch als Cluster
bezeichnet. Es bietet diverse Möglichkeiten, große Docker-Installationen ausfall-
sicher und skalierbar zu gestalten. (In Podman gibt es keine Schwarmfunktionen.)
docker swarm ist der Startpunkt für diverse Kommandos zur Verwaltung eines Docker-
Schwarms:
docker swarm init initialisiert die Schwarmfunktionen auf der aktuellen Docker-
Instanz. Die Ausführung dieses Kommandos reicht bereits aus, damit Sie in der
Folge docker stack ausführen können. Allerdings besteht der Schwarm dann vor-
erst nur aus einem einzigen Rechner.
Auch im Schwarmmodus kann die Docker-Instanz selbstverständlich weiterhin
»gewöhnliche« Container ausführen.
docker swarm join fügt den aktuellen Computer als Knoten bzw. als Manager zu
einem Schwarm hinzu. Zur Verwaltung der Knoten verwenden Sie das Kommando
docker node. Jeder Knoten kann je nach Konfiguration als Worker, als Manager oder
in beiden Funktionen arbeiten.
docker swarm leave entfernt den aktuellen Computer aus einem Docker-Schwarm.
Netzwerk und Firewall
Wenn die Schwarmfunktionen genutzt werden, richtet Docker neue Netzwerke ein.
Diese dienen zur Kommunikation der Knoten und stellen eine Verbindung zum
physischen Netzwerk her. In der Auflistung durch docker network ls haben diese
Netzwerke die Namen docker_gwbridge sowie ingress.
Für die Kommunikation zwischen den Knoten werden die Ports 7946 (TCP/UDP) und
4789 (nur UDP) verwendet. Zur Durchführung der Cluster-Administration ist außer-
dem Port 2377 (TCP) erforderlich. Diese Ports müssen in der Firewall freigeschaltet
werden. Weitere Informationen zu schwarmspezifischen Netzwerkdetails können Sie
hier nachlesen:
https://docs.docker.com/network/overlay
7 Kommandoreferenz
docker system *
docker system ist der Startpunkt für diverse Kommandos, die Informationen zum
aktuellen Zustand des Docker-Systems geben:
docker system df listet den Platzbedarf von Images, Containern und Volumes auf:
docker system df
TYPE                  TOTAL    ACTIVE      SIZE      RECLAIMAB L E
Images                6        5            3.206 GB  85.07 MB (2%)
Container s            7        0            3.537 MB  3.537 MB (100%)
Local Volumes          3        1            371.2 MB  239 MB (64%)
Build Cache                                  0B        0B
Wenn Sie zusätzlich die Option -v übergeben, listet das Kommando im Detail jedes
einzelne Image, jeden Container usw. samt individueller Größenangabe auf.
docker system info zeigt umfassende Informationen zur Docker-Installation an.
Das Kommando liefert das gleiche Ergebnis wie docker info.
docker system prune löscht alle aktuell ungenutzten Daten. Vorsicht! Als »un-
genutzt« gelten nicht laufende Container sowie Images, die nicht von anderen
Images benötigt werden (dangling images).
Sofern Sie die Option --volumes übergeben, werden auch alle Volumes gelöscht,
die von keinem Container genutzt werden. Vor der Ausführung dieses Großputzes
müssen Sie eine Rückfrage mit y bestätigen.
Beachten Sie, dass das Kommando keine Images löscht, die Sie zum Erzeugen von
Images heruntergeladen haben. Wollen Sie sie ebenfalls löschen, führen Sie docker
image prune -a aus.
docker tag
docker tag <iname/id> <[repository/]newname[:tag]> bezeichnet das angegebene
Image mit einem Namen bzw. Tag. Das folgende Kommando gibt dem Image mit der
ID 8d. . . den Namen ubuntu und das Tag 2304beta:
docker tag 8 dcaef637b 4 1 ubuntu :2304 beta
docker top
docker top <cname/cid> liefert eine Liste aller Prozesse, die innerhalb eines Contai-
ners laufen. Bei vielen einfachen Containern handelt es sich dabei nur um einen
Prozess. Anders als bei dem aus Linux bekannten top-Kommando erfolgt die Ausgabe
nur einmalig, d. h., die Prozessliste wird nicht regelmäßig aktualisiert.
docker top docker_re l o a d _1
PID    USER    TIME          COMMAND
8275    0      0:00          npm
8404    0      0:00          sh -c gulp
8405    0      0:04          gulp
docker update
docker update [optionen] <cname/id> verändert mit docker run oder docker create
festgelegte Optionen des Containers. Insbesondere können Sie damit die maximale
CPU-, Speicher- und I/O-Nutzung des Containers limitieren (Optionen --cpus, -m und
--blkio-weight). Außerdem können Sie das Restart-Verhalten ändern.
docker update --restart always <containername >
docker update kann auch ausgeführt werden, während ein Container läuft. Das Kom-
mando funktioniert allerdings nicht für Windows-Container.
docker volume *
docker volume ist der Ausgangspunkt zu mehreren Subkommandos:
docker volume ls listet alle bekannten Volumes aller Container auf.
docker volume inspect <volname> liefert Detailinformationen zu einem Volume,
unter anderem den Mount-Punkt innerhalb des Containers. Allerdings verrät das
Kommando nicht, zu welchem Container ein Volume gehört.
docker volume prune löscht alle Volumes, die mit keinem Container verbunden
sind.
docker volume rm <volname> löscht das angegebene Volume.
docker wait
docker wait <cname/cid> wartet, bis die Ausführung des angegebenen Containers
endet, und gibt dann den Exit-Code aus.
<noinclude>
<!--
----
{{Navigation|<zurück>|<nachste>}}
----
-->
== Anhang ==
=== Siehe auch ===
<div style="column-count:2">
<categorytree hideroot=on mode="pages">{{BASEPAGENAME}}</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}
=== Dokumentation ===
<!--
; Man-Page
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]
; Info-Pages
; Hinweise
<div class="card h-100 bg-warning">
<div class="card-header">'''<big>Header</big>'''</div>
<div class="card-body bg-white">
Hier steht der Kartentext
</div>
</div>
-->
=== Links ===
==== Projekt ====
==== Weblinks ====
<!--
{{DEFAULTSORT:new}}
{{DISPLAYTITLE:new}}
-->
[[Kategorie:Docker/Buch]]
[[Kategorie:Docker/Befehle]]
</noinclude>
</noinclude>

Aktuelle Version vom 18. November 2026, 13:55 Uhr

Docker/Befehle - Aufbau und Übersicht

Beschreibung

Docker als Virtualisierung von Anwendungscontainern

Container-Virtualisierung führte die Entwicklung der virtuellen Maschinen fort

  • Statt ein komplettes Betriebssystem zu simulieren, wird eine einzelne Anwendung in einem Container virtualisiert
Kommandozeilen-Schnittstelle

Docker wird auf dem lokalen System über eine Kommandozeilen-Schnittstelle gesteuert

  • Die dabei zum Einsatz kommenden Befehle sind essenziell für die Arbeit mit Docker
Aufbau von Docker

Kernstück: Docker-Engine

Hauptkomponenten der Docker-Engine
Komponente Beschreibung
Docker-Daemon welcher als dockerd auf dem Host läuft
Docker-API welche vom Docker-Daemon bereitgestellt wird
  • Der Docker-Daemon wird über die API angesprochen und gesteuert
Kommandozeilen-Schnittstelle „Command line interface“, (CLI), welche als docker-Befehl eingesetzt wird, um mit der Docker-API zu kommunizieren
Docker steuern

Um Docker zu steuern, gibt man als Nutzer Docker-Befehle auf der Kommandozeile ein

  • Die Befehle werden von der Docker-CLI entgegengenommen und verarbeitet
  • Aus den Befehlen werden entsprechende API-Calls an den Docker-Daemon erzeugt, welcher die eigentliche Arbeit leistet
Tipp
Zum Verstehen der Docker-Befehle ist es am besten, selbst mit der Software zu spielen

Aufbau

Arten von Docker-Befehlen

Standalone-Befehle
  • Meist Verben und führen beim Aufruf eine bestimmte Aktion aus
  • Bekannte Beispiele sind docker pull oder docker build
  • Mit dem Wachstum der Plattform und dem Erscheinen immer neuer Funktionalitäten, wurde es zunehmend schwierig, passende Verben zu finden
Docker Management-Befehle

Gruppierung von Befehlen

  • Meist Substantive
  • Bekannte Beispiele sind docker image und docker container
  • Die Unterbefehle sind meinst Verben

So lassen sich dieselben Verben in unterschiedlichen Kontexten nutzen

  • Beispielsweise gibt es den Befehl 'docker image rm' zum Entfernen eines Images, sowie 'docker container rm', zum Entfernen eines Containers

Docker Standalone-Befehle oder Docker Management-Befehle werden auf der Kommandozeile aufgerufen

  • Wie üblich wird der Name des Befehls gefolgt von optionalen Parametern eingegeben
  • Ggf. folgt dann noch der Name eines oder mehrerer Objekte
  • Dabei kann es sich um einen Container, ein Image, ein Volumen oder Ähnliches handeln
Allgemeine Struktur eines Docker-Befehls

Im einfachsten Fall wird nur das Docker-CLI mit einer angehängten Option aufgerufen

docker [--options]
Beispiele

Docker-Version ausgeben

docker --version

Docker-Hilfe anzeigen

docker --help
Tipp
Hängen Sie die '--help'-Option an einen Docker-Unterbefehl an, um die Hilfsinformation des Befehls auszugeben

In den meisten Fällen rufen wir nicht bloß das Docker-CLI auf, sondern übergeben zusätzlichen den Namen eines spezifischen Befehls

  • Dabei kann es sich um einen Standalone-Befehl oder einen Management-Befehl gefolgt von einem Unterbefehl handeln
  • Schauen wir uns zunächst das generelle Muster eines Docker Standalone-Befehls an
  • Auf den Namen 'docker' folgt der Name des Befehls, optionale Parameter, sowie ggf. der Name eines Docker-Objekts
docker <command> [--options] <object>

Zwei bekannte Docker Standalone-Befehle aus dem Produktiveinsatz dienen dem Anzeigen verschiedener Statusinformationen

Docker-Informationen anzeigen
docker info
Docker-Images auf dem Host anzeigen
docker images
Docker Management-Befehle

Ordnung in das organisch gewachsene Befehls-Chaos zu bringen

  • So gab es ursprünglich den Befehl docker ls zum Auflisten der Container auf einem Host und analog dazu den Befehl 'docker images' zum Auflisten der Images
  • Nicht gerade intuitiv
  • Auch wenn sich beide Befehle weiterhin nutzen lassen, gibt es heutzutage mit docker container ls und docker image ls konsistente Alternativen

Das generelle Schema für Docker-Management-Befehle beruht auf der bekannten Struktur der Docker Standalone-Befehle

  • Auf den Namen ‚docker‘ folgt der Name des Management-Befehls samt Unterbefehl
  • Wir schließen wiederum mit optionalen Parametern, sowie ggf. dem Namen eines Docker-Objekts ab
docker <management-command> <subcommand> [--options] <object>
Beispiel

Hier der Docker-Befehl zum Starten eines neuen Containers aus dem httpd-Image im interaktiven Modus

docker container run -it httpd

Vergleichen wir die generelle Struktur für Docker Management-Befehle mit den einzelnen Bestandteilen des vorangegangenen Beispiels

Docker-CLI Docker-Befehl Optionen Objekt
Struktur docker <command> <subcommand> [--options] <object>
Beispiel docker container run -it httpd
Details Ruft Docker auf und übergibt weitere Befehle und Optionen Befehlsnamen müssen exakt so geschrieben werden, wie in der Dokumentation vermerkt Optionen werden an den Befehl übergeben und steuern, wie dieser sich verhält
  • Für Optionen gibt es zwei Schreibweisen, siehe unten
Platzhalter für ein Objekt als Ziel der Operation
  • Handelt es sich um Docker-Objekte, wie Container und Images, kommt als ID der Name oder der Hash des Objekts zum Einsatz

Optionen

Wie die meisten Kommandozeilen-Befehle werden Docker-Befehle beim Aufruf über optionale Parameter (Optionen) gesteuert

  • Die Optionen folgen dem Namen des Befehls
  • Dabei wird zwischen Groß- und Kleinschreibung unterschieden
  • Für gewöhnlich gibt es für die meisten Optionen zwei Schreibweisen
Kurzform
-<Options-Kürzel>

Beispiel

docker -v

Die Kurzform ist wenig aussagekräftig

  • Dafür lassen sich mehrere Optionen zu einer kombinieren, beispielsweise docker run -it anstatt docker -i -t
  • Die Reihenfolge ist beim Zusammenfassen beliebig; man kann also ohne Probleme auch docker run -ti schreiben
  • Gut geeignet ist die Kurzform für das schnelle Arbeiten mit bekannten Befehlen auf der Kommandozeile
Langform
--<Options-Name>

Beispiel

docker --version

Die Langform ist leicht verständlich, benötigt jedoch mehr Zeit zum Tippen und nimmt mehr Platz ein

  • Gut geeignet ist die Langform für das Erstellen von Scripten; die aussagekräftigen Optionsnamen dienen der Dokumentation

Dockerfile, Docker-Image und Docker-Container

Ein Großteil der existierenden Docker-Befehle dient dem Verwalten von

  • Docker Containern
  • Docker Images
  • Docker Volumes
Container und Image

Ein Docker-Container wird aus einer unveränderlichen Vorlage, dem sog. Image, erzeugt

  • Ein Docker-Image enthält die zur Erzeugung eines Containers notwendigen Abhängigkeiten und Konfigurationseinstellungen
  • Wir können nicht nur einen Container aus einem Image erzeugen, sondern auch einen existierenden Container in einem neuen Image abspeichern

Container und Image stehen in etwa so zueinander, wie Henne und Ei

Docker-Befehl Bedeutung Henne-Ei-Analogie
docker build Docker-Image aus Dockerfile erzeugen Ei mit Erbinformation versehen
docker run <image> Docker-Container aus Image starten Küken schlüpft aus Ei
docker commit <container> Docker-Image aus Container erzeugen Henne legt neues Ei

Übersicht

Die wichtigsten Docker-Befehle in der Übersicht

Docker hat über die vergangenen zehn Jahre eine rasante Entwicklung durchgemacht

  • Neben der ursprünglichen Container-Virtualisierung umfasst Docker heutzutage weit darüber hinausgehende Funktionen
  • So lassen sich mit Docker-Compose und Docker-Swarm Container-Verbünden orchestrieren, was traditionell Docker-Alternativen vorbehalten war
  • Wir gehen im Folgenden auf eine Untermenge der originalen Befehle ein, da eine vollständige Auflistung den Rahmen dieses Artikel sprengen würde
Komponenten eines Docker-Containers

Zur Steuerung stehen entsprechende Befehle zur Verfügung

  1. Container-Betriebssystem und Union-Dateisystem
  2. Software-Komponenten und Konfiguration
  3. Umgebungsvariablen und Laufzeit-Konfiguration
  4. Ports und Volumen
  5. Prozesse und Logs

Standalone-Befehle

Die meisten Docker-Funktionalitäten lassen sich heutzutage mit Docker Management-Befehlen steuern

  • Auch wenn die ursprünglichen Befehle weiterhin funktionieren, gibt es aussagekräftigere Äquivalente
Docker Standalone-Befehl Äquivalenter Docker Management-Befehl Erklärung
docker ps docker container ls Die auf dem Host laufenden Container anzeigen
docker images docker image ls Die auf dem Host verfügbaren Images anzeigen
docker inspect <object> docker <object-type> inspect <object>, beispielsweise docker image inspect <image> Informationen zu Docker-Objekten wie Images, Containers, Volumes, etc. anzeigen

Es gibt jedoch immer noch eine Handvoll von Docker Standalone-Befehlen

  • Diese lassen sich nicht durch Docker Management-Befehle ersetzen, da sie sich auf die Docker-Installation als Ganzes beziehen
Docker Standalone-Befehl Erklärung
docker --help Hilfe für die Docker-CLI anzeigen
docker --version Die Version der Docker-Installation anzeigen
docker info Systemweite Informationen über die Docker-Installation anzeigen
docker login Bei einer Container-Registry oder einem Cloud-Backend anmelden
docker logout Von Container-Registry oder Cloud-Backend abmelden

Container-Befehle

Docker-Container enthalten kein eigenes Betriebssystem

Stattdessen greifen alle auf einem Docker-Host laufenden Container auf denselben Betriebssystem-Kernel zu

  • Jedem Container wird bei der Ausführung per Befehl eine gewisse Menge an System-Ressourcen zugewiesen
  • Dazu gehören Arbeitsspeicher, CPU-Kerne, Massenspeicher und (virtuelle) Netzwerk-Geräte
  • Hier zwei Beispiele
Docker-Container beim Start einen CPU-Kern und 10 Megabyte Speicher zuweisen
docker container run --cpus="1" --memory="10m" <image>
TCP-Port 80 des Docker-Hosts auf Port 80 des Docker-Containers mappen
docker container run -p 80:80/tcp <image>
Container starten, stoppen und entfernen

Ferner lassen sich die innerhalb eines Containers laufenden Prozesse steuern

  • Dementsprechend befassen sich viele der Docker Container-Befehle mit diesen Aufgaben
Docker Container-Befehl Erklärung
docker container ls Die auf dem Host laufenden Container anzeigen
docker container stats Statusinformationen der laufenden Container anzeigen
docker container run <image> Einen neuen Container aus dem angegebenen Image starten, oder einen Befehl in einem neuen Container ausführen
docker container commit <container> Ein neues Image aus den Änderungen eines laufenden Containers erzeugen
docker container attach <container> Einen laufenden Container mit lokalen Standard-Eingabe, -Ausgabe, und -Fehler Strömen versehen
docker container logs <container> Log-Informationen eines Containers anzeigen
docker container inspect <container> Detaillierte Informationen eines Containers anzeigen
docker container update <container> Die Konfiguration eines Containers erneuern
docker container rename <container> <new-name> Einem Container einen neuen Namen geben
docker container port <container> Port-Zuweisungen eines Containers anzeigen
docker container pause <container> Die in einem Container laufenden Prozesse pausieren
docker container unpause <container> Die Ausführung der pausierten Prozesse in einem Container wieder aufnehmen
docker container exec <container> <command> Einen Befehl innerhalb eines laufenden Containers ausführen
docker container stop <container> Die Ausführung eines Containers stoppen
docker container start <container> Die Ausführung eines gestoppten Containers wieder aufnehmen
docker container restart <container> Einen Container neu starten; verhält sich wie docker container stop <container>; docker container start <container>
docker container top <container> Die innerhalb eines Containers laufenden Prozesse auflisten
docker container kill <container> Einen laufenden Container abschießen
docker container rm <container> Einen Container aus dem System entfernen
docker container prune Alle gestoppten Container vom System entfernen
docker container cp <container>:<source-path> <dest-path> Dateien und Ordner zwischen einem Container und dem lokalen Dateisystem kopieren
docker container diff <container> Die Änderungen am Dateisystem eines Containers anzeigen
docker container export <container> Das Dateisystem eines Containers als Tarball-Archiv ausgeben; sämtliche Layer werden dabei auf einen reduziert

Image-Befehle

Anders als bei Images virtueller Maschinen der Fall, ist ein Docker-Image im Normalzustand keine einzelne Datei

  • Stattdessen handelt es sich um einen Verbund mehrerer Komponenten
Komponente Beschreibung
Image-Layers enthalten durch Operation auf dem Dateisystem hinzugefügte Daten
  • Layers werden überlagert und durch ein Union-Dateisystem auf eine konsistente Ebene reduziert
Parent-Image stellt Grundfunktionen des Images bereit und verankert das Image im Stammbaum des Docker-Ökosystems
Image-Manifest beschreibt den Verbund und identifiziert die darin enthaltenen Image-Layers

Ein Docker-Image enthält schreibgeschützte Schichten, auf Englisch „Layers“ genannt

  • Jeder Layer beschreibt sukzessive Änderungen am Dateisystem des Images
  • Für jede Operation, welche zu einer Änderung am Dateisystem des Images führen würde, wird ein neuer Layer angelegt
Befehle zum Interagieren mit Images
Docker Image-Befehl Erklärung
docker image build Ein Docker-Image aus einem Dockerfile erzeugen
docker image history <image> Die zur Erzeugung eines Docker-Image durchlaufenen Schritte anzeigen
docker image import <tarball> Ein Docker-Image aus einem „Tarball“-Archiv erzeugen
docker image inspect <image> Detaillierte Informationen für ein Docker-Image anzeigen
docker image load Mit 'docker image save' erzeugtes Image-Archiv laden
docker image ls Auf dem Docker-Host verfügbare Images auflisten
docker image prune Ungenutzte Docker-Images vom Docker-Host entfernen
docker image pull <image> Docker-Image von Registry beziehen
docker image push <image> Ein Image an eine Registry senden
docker image rm <image> Ein Image vom lokalen Host entfernen
docker image save <image> Image-Archiv mit allen Layers aus einem Image erzeugen
docker image tag <source-image> <target-image> Ein Image mit Tags versehen

Volume-Befehle

Ein Docker-Container enthält eine von der Außenwelt isolierte Anwendung

Dateien zwischen dem Container und dem Host-System zu teilen
  • In vielen Fällen sinnvoll
  • Dafür kennt Docker verschiedene Typen von Volumes
Typen von Volumes

Die Unterschiede zwischen den Volume-Typen sind subtil

  • Die Wahl des passenden Typs hängt stark vom jeweiligen Einsatzszenario ab
Typ Beschreibung
Benannte Volumes empfohlen
Anonyme Volumes gehen beim Entfernen des Containers verloren
Bind Mounts historisch bedingt und nicht empfohlen; performant
Tmpfs Mounts liegen im Arbeitsspeicher; nur unter Linux
Befehle zur Interaktion mit Volumes
Docker Volume-Befehl Erklärung
docker volume ls Die auf dem Host befindlichen Volumes anzeigen
docker volume prune Alle nicht genutzten Volumes vom Host entfernen
docker volume create Ein neues Volume auf dem Host erzeugen
docker inspect <volume> Detaillierte Informationen eines Volumes anzeigen
docker volume rm <volume> Das angegebene Volume vom Host entfernen



Anhang

Siehe auch


Dokumentation

Projekt

  1. https://www.ionos.de/digitalguide/server/knowhow/docker-befehle/