|
|
| (3 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. 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> |