Docker/Befehle: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
K Textersetzung - „bzw. “ durch „oder “
 
(74 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
'''Docker/Befehle''' - Aufbau und Übersicht


Die quelloffene Software Docker hat sich als '''Standard für die Virtualisierung von Anwendungscontainern''' durchgesetzt. Die Container-Virtualisierung führte die Entwicklung der virtuellen Maschinen mit einem wichtigen Unterschied fort: anstatt ein komplettes Betriebssystem zu simulieren, wird eine einzelne Anwendung in einem Container virtualisiert.
== 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


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. Wir erklären, wie Docker-Befehle funktionieren und stellen die wichtigsten Befehle vor.
; 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


== Beschreibung ==
; Aufbau von Docker
Um besser nachzuvollziehen, was Docker-Befehle sind und wie sie funktionieren, erläutern wir kurz den Aufbau von Docker. Die '''Docker-Installation auf einem lokalen Host enthält als Kernstück die Docker-Engine'''. Die Docker-Engine besteht aus drei hauptsächlichen Komponenten:
Kernstück: Docker-Engine


# Der '''Docker-Daemon''', welcher als dockerd auf dem Host läuft.
; Hauptkomponenten der Docker-Engine
# Die '''Docker-API''', welche vom Docker-Daemon bereitgestellt wird. Der Docker-Daemon wird über die API angesprochen und gesteuert.
{| class="table table-striped table-hover col1bold col1nowrap"
# Die '''Kommandozeilen-Schnittstelle''' („Command line interface“, CLI), welche als docker-Befehl eingesetzt wird, um mit der Docker-API zu kommunizieren.
! Komponente !! Beschreibung
|-
| Docker-Daemon || welcher als dockerd auf dem Host läuft
|-
| Docker-API || welche vom Docker-Daemon bereitgestellt wird
* Der Docker-Daemon wird über die API angesprochen und gesteuert
|-
| Kommandozeilen-Schnittstelle || „Command line interface“, (CLI), welche als docker-Befehl eingesetzt wird, um mit der Docker-API zu kommunizieren
|}


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.
; 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
; Tipp
: Zum Verstehen der Docker-Befehle ist es am besten, selbst mit der Software zu spielen. Nutzen Sie unser Docker-Tutorial, um dich wichtigsten Konzepte zu erlernen.
: 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 ===
=== Aufbau ===
Bedingt durch die historische Entwicklung von Docker haben sich '''zwei Arten von Docker-Befehlen etabliert'''.
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
 
<syntaxhighlight lang="bash" highlight="1" copy line>
docker [--options]
</syntaxhighlight>


Zum einen gibt es eine Handvoll von '''Standalone-Befehlen'''. Diese sind für gewöhnlich 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.
; Beispiele
Docker-Version ausgeben
<syntaxhighlight lang="bash" highlight="1" copy line>
docker --version
</syntaxhighlight>


Zum anderen wurden die sogenannten „'''Docker Management-Befehle'''“ zur Gruppierung von Befehlen eingeführt, um wieder Ordnung in die ausufernde Befehls-Vielfalt zu bringen. Bei den Docker Management-Befehlen handelt es sich für gewöhnlich um Substantive. Bekannte Beispiele sind 'docker image' und 'docker container'. Die '''Docker Management-Befehle gruppieren Unterbefehle''', welche wiederum Verben sind.
Docker-Hilfe anzeigen
<syntaxhighlight lang="bash" highlight="1" copy line>
docker --help
</syntaxhighlight>


Auf diese Weise lassen sich dieselben Verben in unterschiedlichen Kontexten nutzen, ohne dass es zu Kollisionen der Namen käme. Beispielsweise gibt es den Befehl 'docker image rm' zum Entfernen eines Images, sowie 'docker container rm', zum Entfernen eines Containers.
; Tipp
: Hängen Sie die '--help'-Option an einen Docker-Unterbefehl an, um die Hilfsinformation des Befehls auszugeben


Unabhängig davon, ob Docker Standalone-Befehle oder Docker Management-Befehle zum Einsatz kommen, '''erfolgt der Aufruf der Docker-Befehle auf der Kommandozeile'''. 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.
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.&nbsp;der Name eines Docker-Objekts
docker <command> [--options] <object>
Zwei bekannte Docker Standalone-Befehle aus dem Produktiveinsatz dienen dem Anzeigen verschiedener Statusinformationen


Schauen wir uns die '''allgemeine Struktur eines Docker-Befehls auf der Kommandozeile''' an. Im einfachsten Fall wird nur das Docker-CLI mit einer angehängten Option aufgerufen:
; Docker-Informationen anzeigen
<code>docker [--options]</code>
<syntaxhighlight lang="bash" highlight="1" copy line>
Bekannte Beispiele sind die '''Ausgabe der Docker-Version''' bzw. der Docker-Hilfsinformation:
docker info
<code># Docker-Version ausgeben
</syntaxhighlight>
docker --version</code>


<code># Docker-Hilfe anzeigen
; Docker-Images auf dem Host anzeigen
docker --help</code>
<syntaxhighlight lang="bash" highlight="1" copy line>
Tipp
docker images
</syntaxhighlight>


Hängen Sie die '--help'-Option an einen Docker-Unterbefehl an, um die Hilfsinformation des Befehls auszugeben.
; 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


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:
Das generelle Schema für Docker-Management-Befehle beruht auf der bekannten Struktur der Docker Standalone-Befehle
<code>docker <command> [--options] <object></code>
* Auf den Namen ‚docker‘ folgt der Name des Management-Befehls samt Unterbefehl
Zwei bekannte Docker Standalone-Befehle aus dem Produktiveinsatz dienen dem Anzeigen verschiedener Statusinformationen:
* Wir schließen wiederum mit optionalen Parametern, sowie ggf.&nbsp;dem Namen eines Docker-Objekts ab
<code># Docker-Information anzeigen
docker info</code>


<code># Docker-Images auf dem Host anzeigen
<syntaxhighlight lang="bash" highlight="1" copy line>
docker images</code>
docker <management-command> <subcommand> [--options] <object>
Machen wir uns als nächstes mit den Docker Management-Befehlen vertraut. Wie bereits erwähnt, dienen diese dazu, 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.
</syntaxhighlight>


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:
; Beispiel
<code>docker <management-command> <subcommand> [--options] <object></code>
Hier der Docker-Befehl zum Starten eines neuen Containers aus dem ''httpd''-Image im interaktiven Modus
Veranschaulichen wir uns das Muster an einem konkreten Beispiel. Hier der Docker-Befehl zum Starten eines neuen Containers aus dem ‚httpd‘-Image im interaktiven Modus:
 
<code>docker container run -it httpd</code>
<syntaxhighlight lang="bash" highlight="1" copy line>
Vergleichen wir die generelle Struktur für Docker Management-Befehle mit den einzelnen Bestandteilen des vorangegangenen Beispiels:
docker container run -it httpd
{| class="wikitable"
</syntaxhighlight>
 
Vergleichen wir die generelle Struktur für Docker Management-Befehle mit den einzelnen Bestandteilen des vorangegangenen Beispiels
{| class="table table-striped table-hover col1bold col1nowrap"
|
|
|'''Docker-CLI'''
! Docker-CLI !! Docker-Befehl !! Optionen !! Objekt
|'''Docker-Befehl'''
|'''Optionen'''
|'''Objekt'''
|-
|-
|'''Struktur'''
|'''Struktur'''
Zeile 74: Zeile 132:
|-
|-
|'''Details'''
|'''Details'''
|Ruft Docker auf und übergibt weitere Befehle und Optionen.
|Ruft Docker auf und übergibt weitere Befehle und Optionen
|Befehlsnamen müssen exakt so geschrieben werden, wie in der Dokumentation vermerkt.
|Befehlsnamen müssen exakt so geschrieben werden, wie in der Dokumentation vermerkt
|Optionen werden an den Befehl übergeben und steuern, wie dieser sich verhält. Für Optionen gibt es zwei Schreibweisen, siehe unten.
|Optionen werden an den Befehl übergeben und steuern, wie dieser sich verhält
|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.
* Für Optionen gibt es zwei Schreibweisen, siehe unten
|Platzhalter für ein Objekt als Ziel der Operation
* Handelt es sich um Docker-Objekte, wie Container und Images, kommt als ID der Name oder der Hash des Objekts zum Einsatz
|}
|}


=== Optionen ===
=== Optionen ===
Wie die meisten Kommandozeilen-Befehle werden Docker-Befehle beim Aufruf über optionale Parameter, sog. „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:
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


# '''Kurzform''': -<Options-Kürzel>, z.B. 'docker -v'
; Langform
--<Options-Name>
Beispiel
docker --version


Die Kurzform ist wenig aussagekräftig. Dafür lassen sich mehrere Optionen zu einer kombinieren, z.B. '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.
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


# '''Langform''': --<Options-Name>, z.B. 'docker --version'
=== Dockerfile, Docker-Image und Docker-Container ===
Ein Großteil der existierenden Docker-Befehle dient dem Verwalten von
* Docker Containern
* Docker Images
* Docker Volumes


Die Langform ist leicht verständlich, benötigt jedoch mehr Zeit zu tippen und nimmt mehr Platz ein. Gut geeignet ist die Langform für das Erstellen von Scripten; die aussagekräftigen Options-Namen dienen der Dokumentation.
; Container und Image
Ein Docker-Container wird aus einer unveränderlichen Vorlage, dem sog.&nbsp;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


== Dockerfile, Docker-Image und Docker-Container ==
Container und Image stehen in etwa so zueinander, wie Henne und Ei
Ein Großteil der existierenden Docker-Befehle dient dem Verwalten von Docker Containern, Docker Images und Docker Volumes. Bevor wir uns im Detail mit den spezifischen Docker-Befehlen befassen, geben wir einen kurzen Überblick, wie die wichtigen Docker-Konzepte Container und Image zusammenhängen.


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:
{| class="table table-striped table-hover col1bold col1nowrap"
{| class="wikitable"
! Docker-Befehl !! Bedeutung !! Henne-Ei-Analogie
|'''Docker-Befehl'''
|'''Bedeutung'''
|'''Henne-Ei-Analogie'''
|-
|-
|docker build
|docker build
Zeile 115: Zeile 195:
== Übersicht ==
== Übersicht ==
; Die wichtigsten Docker-Befehle in der Ü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.
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
Ein '''Docker-Container umfasst die folgenden Komponenten'''. Zur Steuerung stehen entsprechende Befehle zur Verfügung:
* 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
# Container-Betriebssystem und Union-Dateisystem
# Software-Komponenten und Konfiguration
# Software-Komponenten und Konfiguration
Zeile 126: Zeile 209:


=== Standalone-Befehle ===
=== Standalone-Befehle ===
Vorweg: 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:
Die meisten Docker-Funktionalitäten lassen sich heutzutage mit Docker Management-Befehlen steuern
{| class="wikitable big options"
* Auch wenn die ursprünglichen Befehle weiterhin funktionieren, gibt es aussagekräftigere Äquivalente
|'''Docker Standalone-Befehl'''
{| class="table table-striped table-hover big col1bold col1nowrap"
|'''Äquivalenter Docker Management-Befehl'''
! Docker Standalone-Befehl !! Äquivalenter Docker Management-Befehl !! Erklärung
|'''Erklärung'''
|-
|-
|docker ps
|docker ps
Zeile 141: Zeile 223:
|-
|-
|docker inspect <object>
|docker inspect <object>
|docker <object-type> inspect <object>, z.B. docker image inspect <image>
|docker <object-type> inspect <object>, beispielsweise&nbsp;docker image inspect <image>
|Informationen zu Docker-Objekten wie Images, Containers, Volumes, etc. anzeigen
|Informationen zu Docker-Objekten wie Images, Containers, Volumes, etc.&nbsp;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:
Es gibt jedoch immer noch eine Handvoll von Docker Standalone-Befehlen
{| class="wikitable big options"
* Diese lassen sich nicht durch Docker Management-Befehle ersetzen, da sie sich auf die Docker-Installation als Ganzes beziehen
|'''Docker Standalone-Befehl'''
{| class="table table-striped table-hover big col1bold col1nowrap"
|'''Erklärung'''
! Docker Standalone-Befehl !! Erklärung
|-
|-
|docker --help
|docker --help
Zeile 167: Zeile 249:


=== Container-Befehle ===
=== Container-Befehle ===
Anders als bei der Virtualisierung mit virtuellen Maschinen, enthält ein Docker-Container 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 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 '''beim Start einen CPU-Kern und 10 Megabyte Speicher zuweisen'''
<code>docker container run --cpus="1" --memory="10m" <image></code>
<syntaxhighlight lang="bash" highlight="1" copy line>
TCP-Port 80 des Docker-Hosts auf Port 80 des Docker-Containers mappen:
docker container run --cpus="1" --memory="10m" <image>
<code>docker container run -p 80:80/tcp <image></code>
</syntaxhighlight>
Auf einem Host lassen sich '''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:
 
{| class="wikitable big options"
; [[TCP]]-Port 80 des Docker-Hosts auf Port 80 des Docker-Containers mappen
|'''Docker Container-Befehl'''
<syntaxhighlight lang="bash" highlight="1" copy line>
|'''Erklärung'''
docker container run -p 80:80/tcp <image>
</syntaxhighlight>
 
; 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
 
{| class="table table-striped table-hover big col1bold col1nowrap"
! Docker Container-Befehl !! Erklärung
|-
|-
|docker container ls
|docker container ls
Zeile 185: 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 239: Zeile 333:
|-
|-
|docker container cp <container>:<source-path> <dest-path>
|docker container cp <container>:<source-path> <dest-path>
|Dateien und Ordner zwischen einem Container und dem lokalen Dateisystem kopieren.
|Dateien und Ordner zwischen einem Container und dem lokalen Dateisystem kopieren
|-
|-
|docker container diff <container>
|docker container diff <container>
Zeile 249: Zeile 343:


=== Image-Befehle ===
=== 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:
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


* '''Image-Layers''': enthalten durch Operation auf dem Dateisystem hinzugefügte Daten. Layers werden überlagert und durch ein Union-Dateisystem auf eine konsistente Ebene reduziert.
{| class="table table-striped table-hover col1bold col1nowrap"
* '''Parent-Image''': stellt Grundfunktionen des Images bereit und verankert das Image im Stammbaum des Docker-Ökosystems.
! Komponente !! Beschreibung
* '''Image-Manifest''': beschreibt den Verbund und identifiziert die darin enthaltenen Image-Layers.
|-
| Image-Layers || enthalten durch Operation auf dem Dateisystem hinzugefügte Daten
* Layers werden überlagert und durch ein Union-Dateisystem auf eine konsistente Ebene reduziert
|-
| Parent-Image || stellt Grundfunktionen des Images bereit und verankert das Image im Stammbaum des Docker-Ökosystems
|-
| Image-Manifest || beschreibt den Verbund und identifiziert die darin enthaltenen Image-Layers
|}
 
Ein Docker-Image enthält schreibgeschützte Schichten, auf Englisch „Layers“ genannt
* Jeder Layer beschreibt sukzessive Änderungen am Dateisystem des Images
* Für jede Operation, welche zu einer Änderung am Dateisystem des Images führen würde, wird ein neuer Layer angelegt


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. Die folgenden Befehle dienen zum Interagieren mit Images auf dem Host:
; Befehle zum Interagieren mit Images
{| class="wikitable big options"
{| class="table table-striped table-hover big col1bold col1nowrap"
|'''Docker Image-Befehl'''
! Docker Image-Befehl !! Erklärung
|'''Erklärung'''
|-
|-
|docker image build
|docker image build
Zeile 298: Zeile 403:


=== Volume-Befehle ===
=== Volume-Befehle ===
Ein Docker-Container enthält eine von der Außenwelt isolierte Anwendung. In vielen Fällen ist es jedoch sinnvoll, '''Dateien zwischen dem Container und dem Host-System zu teilen'''. Zu diesem Zweck kennt Docker verschiedene Typen von Volumes. Die Unterschiede zwischen den Volume-Typen sind subtil; die Wahl des passenden Typs hängt stark vom jeweiligen Einsatzszenario ab:
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


* Benannte Volumes — empfohlen
; Typen von Volumes
* Anonyme Volumes — gehen beim Entfernen des Containers verloren
Die Unterschiede zwischen den Volume-Typen sind subtil
* Bind Mounts — historisch bedingt und nicht empfohlen; performant
* Die Wahl des passenden Typs hängt stark vom jeweiligen Einsatzszenario ab
* Tmpfs Mounts — liegen im Arbeitsspeicher; nur unter Linux


Zur '''Interaktion mit Volumes''' steht eine Handvoll an Docker-Befehlen zur Verfügung:
{| class="table table-striped table-hover big col1bold col1nowrap"
{| class="wikitable big options"
! Typ !! Beschreibung
|'''Docker Volume-Befehl'''
|-
|'''Erklärung'''
| 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
{| class="table table-striped table-hover big col1bold col1nowrap"
! Docker Volume-Befehl !! Erklärung
|-
|-
|docker volume ls
|docker volume ls
Zeile 326: Zeile 445:
|}
|}


; Quelle
 
https://www.ionos.de/digitalguide/server/knowhow/docker-befehle/
<noinclude>
 
== Anhang ==
=== Siehe auch ===
<div style="column-count:2">
<categorytree hideroot=on mode="pages">Docker/Befehle</categorytree>
</div>
----
{{Special:PrefixIndex/Docker/Befehl}}
 
=== Dokumentation ===
<!--
; Man-Page
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]
 
; Info-Pages
-->
 
=== Links ===
==== Projekt ====
==== Weblinks ====
# https://www.ionos.de/digitalguide/server/knowhow/docker-befehle/
 
[[Kategorie:Docker/Befehle]]
 
</noinclude>

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

Docker/Befehle - Aufbau und Übersicht

Beschreibung

Docker als Virtualisierung von Anwendungscontainern

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

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

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

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

Kernstück: Docker-Engine

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

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

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

Aufbau

Arten von Docker-Befehlen

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

Gruppierung von Befehlen

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

So lassen sich dieselben Verben in unterschiedlichen Kontexten nutzen

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

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

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

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

docker [--options]
Beispiele

Docker-Version ausgeben

docker --version

Docker-Hilfe anzeigen

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

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

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

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

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

Ordnung in das organisch gewachsene Befehls-Chaos zu bringen

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

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

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

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

docker container run -it httpd

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

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

Optionen

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

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

Beispiel

docker -v

Die Kurzform ist wenig aussagekräftig

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

Beispiel

docker --version

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

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

Dockerfile, Docker-Image und Docker-Container

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

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

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

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

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

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

Übersicht

Die wichtigsten Docker-Befehle in der Übersicht

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

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

Zur Steuerung stehen entsprechende Befehle zur Verfügung

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

Standalone-Befehle

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

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

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

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

Container-Befehle

Docker-Container enthalten kein eigenes Betriebssystem

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

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

Ferner lassen sich die innerhalb eines Containers laufenden Prozesse steuern

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

Image-Befehle

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

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

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

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

Volume-Befehle

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

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

Die Unterschiede zwischen den Volume-Typen sind subtil

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



Anhang

Siehe auch


Dokumentation

Projekt

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