Docker/Befehle
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
|
| 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
- Nutzen Sie das Docker/Tutorial, um dich wichtigsten Konzepte zu erlernen
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
|
Platzhalter für ein Objekt als Ziel der Operation
|
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
- Container-Betriebssystem und Union-Dateisystem
- Software-Komponenten und Konfiguration
- Umgebungsvariablen und Laufzeit-Konfiguration
- Ports und Volumen
- 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, bzw. 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
|
| 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
Links
Projekt
Weblinks
TMP
Docker/Befehle
Kommandoreferenz
Sie wichtigsten Kommandos
| Kommando | Funktion |
|---|---|
| docker attach | die Ein- und Ausgabe eines Containers mit einem Terminal< |
tmp
Wichtige Docker-Kommandos
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 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
Die in diesem Kapitel präsentierte Kommandoreferenz konzentriert sich auf die wichtigsten Kommandos und die am häufigsten benötigten Optionen. Eine vollständige Beschreibung aller Kommandos finden Sie auf der folgenden Docker-Website:
- Subkommando
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 Containers 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ßerdem 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 stehen.
- 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, 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 "Vorlage:. State .Status" apache - test exited
docker inspect -s -f "Vorlage:. 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.