Docker/Grundlagen/02 Container ausführen: Unterschied zwischen den Versionen
| (21 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
<noinclude> | |||
---- | |||
{{Navigation|Docker/Grundlagen|Docker/Grundlagen/03 Containerinteraktion}} | |||
---- | |||
'''Docker/Grundlagen/02 Container ausführen''' | '''Docker/Grundlagen/02 Container ausführen''' | ||
<noinclude> | |||
<bootstrap_jumbotron> | |||
<h2>Docker Container ausführen</h2> | |||
</bootstrap_jumbotron> | |||
</noinclude> | |||
== Beschreibung == | == Beschreibung == | ||
| Zeile 8: | Zeile 19: | ||
:* An dieser Stelle geht es darum, die Konzepte von Docker anhand von Beispielen kennenzulernen | :* An dieser Stelle geht es darum, die Konzepte von Docker anhand von Beispielen kennenzulernen | ||
Um dieses Image auszuprobieren und den davon abgeleiteten Container zu starten, führen Sie in einem Terminal eines der drei folgenden Kommandos aus | Um dieses Image auszuprobieren und den davon abgeleiteten Container zu starten, führen Sie in einem Terminal eines der drei folgenden Kommandos aus | ||
; macOS, Windows, Rootless Docker, Docker Desktop für Linux | ; macOS, Windows, [[Rootless Docker]], Docker Desktop für Linux | ||
<syntaxhighlight lang="bash" highlight="1" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker run hello-world | docker run hello-world | ||
| Zeile 20: | Zeile 31: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Das jeweilige Kommando sieht zuerst nach, ob das Image hello-world auf dem lokalen Rechner bereits zur Verfügung steht | Das jeweilige Kommando sieht zuerst nach, ob das Image hello-world auf dem lokalen Rechner bereits zur Verfügung steht | ||
* Ist das nicht der Fall, wird es vom Docker Hub heruntergeladen und lokal gespeichert | * Ist das nicht der Fall, wird es vom Docker Hub heruntergeladen und lokal gespeichert | ||
Docker bildet daraus einen Container und führt diesen schließlich aus | Docker bildet daraus einen Container und führt diesen schließlich aus | ||
<syntaxhighlight lang="bash" highlight="" line> | <syntaxhighlight lang="bash" highlight="" line> | ||
docker run hello-world | docker run hello-world | ||
| Zeile 33: | Zeile 44: | ||
Hello from Docker ! | Hello from Docker ! | ||
This message shows that your installation appears to be working correctly | This message shows that your installation appears to be working correctly | ||
... | ... | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Ab dem zweiten Mal wird docker run hello-world blitzschnell ausgeführt, weil jetzt ein lokaler Container der Hello-World-App zur Verfügung steht | Ab dem zweiten Mal wird docker run hello-world blitzschnell ausgeführt, weil jetzt ein lokaler Container der Hello-World-App zur Verfügung steht | ||
Das offizielle Hello-World-Image ist insofern ein untypisches Docker-Beispiel, als die darin verpackte App einmal ausgeführt wird und dann sofort endet | Das offizielle Hello-World-Image ist insofern ein untypisches Docker-Beispiel, als die darin verpackte App einmal ausgeführt wird und dann sofort endet | ||
* Viele Docker- Container enthalten dagegen Programme, die Eingaben verarbeiten, dauerhaft laufen oder interaktiv genutzt werden können | * Viele Docker- Container enthalten dagegen Programme, die Eingaben verarbeiten, dauerhaft laufen oder interaktiv genutzt werden können | ||
== sudo == | == sudo == | ||
Die | Die vorgestellten Beispiele können unter jedem Betriebssystem gestartet werden | ||
* Unter macOS oder Windows werden die Docker-Befehle mit Benutzeraccount ausgefüht | * Unter macOS oder Windows werden die Docker-Befehle mit Benutzeraccount ausgefüht | ||
* Unter Linux mit root-Rechte | * Unter Linux mit root-Rechte | ||
** es sei denn, Sie verwenden Rootless Docker oder Docker Desktop für Linux – siehe [[Docker/Installation]] | ** es sei denn, Sie verwenden Rootless Docker oder Docker Desktop für Linux – siehe [[Docker/Installation]] | ||
Um nicht jedem | Um nicht jedem Befehl [[sudo]] vorranstellen zu müssen, kann der Linux-Account der Gruppe ''docker'' hinzugefügt werden | ||
<syntaxhighlight lang="bash" highlight="1" line copy> | <syntaxhighlight lang="bash" highlight="1" line copy> | ||
usermod -aG docker <accountname> | usermod -aG docker <accountname> | ||
| Zeile 57: | Zeile 68: | ||
== Statusinformationen == | == Statusinformationen == | ||
; docker ps -a | ; docker ps -a | ||
liefert eine Liste aller laufenden | liefert eine Liste aller laufenden oder in der Vergangenheit ausgeführten Docker-Container | ||
* Die merkwürdigen Namen in der Spalte NAMES resultieren daraus, dass Docker jedem Container nicht nur eine zufällige ID zuweist, sondern auch einen leichter zu merkenden (aber ebenso zufälligen) Namen | * Die merkwürdigen Namen in der Spalte NAMES resultieren daraus, dass Docker jedem Container nicht nur eine zufällige ID zuweist, sondern auch einen leichter zu merkenden (aber ebenso zufälligen) Namen | ||
<syntaxhighlight lang="bash" highlight="1" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
| Zeile 69: | Zeile 80: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
; docker images | ; docker images | ||
Alle lokal installierten Images auflisten | Alle lokal installierten Images auflisten | ||
<syntaxhighlight lang="bash" highlight="1" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
| Zeile 77: | Zeile 88: | ||
REPOSITORY TAG IMAGE ID CREATED SIZE | REPOSITORY TAG IMAGE ID CREATED SIZE | ||
hello-world latest 48b5124b2768 7 weeks ago 1.84 kB | hello-world latest 48b5124b2768 7 weeks ago 1.84 kB | ||
</syntaxhighlight> | |||
== Automatisch starten == | |||
=== Systemstart === | |||
==== Direkt beim Systemstart (docker run) ==== | |||
Fügen Sie die Option --restart hinzu | |||
docker run -d --name mein-container --restart unless-stopped mein-image | |||
; Restart-Optionen | |||
{| class="table table-striped table-hover col1bold col1nowrap" | |||
|- | |||
! Option !! Beschreibung | |||
|- | |||
| unless-stopped || (Empfohlen): Startet den Container immer automatisch neu – es sei denn, Sie haben ihn vorher manuell gestoppt | |||
|- | |||
| always || Startet den Container immer neu, auch wenn Sie ihn manuell gestoppt haben (er läuft nach einem Neustart des Docker-Daemons oder Servers wieder an) | |||
|- | |||
| on-failure || Startet den Container nur neu, wenn er mit einem Fehler (Exit-Code ungleich 0) abgestürzt ist | |||
|- | |||
| no || Standardeinstellung (kein automatischer Neustart) | |||
|} | |||
==== Nachträglich für einen bestehenden Container ==== | |||
Haben Sie den Container bereits erstellt, können Sie die Richtlinie aktualisieren mit ''docker update'' | |||
docker update --restart=unless-stopped mein-container | |||
=== Docker Compose === | |||
; docker-compose.yml/compose.yaml | |||
In einer Compose-Datei tragen Sie die Option restart direkt beim jeweiligen Service ein | |||
<syntaxhighlight lang="yaml" highlight="" line copy> | |||
services: | |||
mein-dienst: | |||
image: nginx:latest | |||
restart: unless-stopped | |||
ports: | |||
- "8080:80" | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="yaml" highlight="1" copy> | |||
docker compose up -d | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== Aufräumen == | == Aufräumen == | ||
Damit sich nicht unzählige Container ansammeln, sollten nicht mehr benötigte Container gelöscht werden | |||
<syntaxhighlight lang="bash" highlight="1" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker rm nervous_lamarr kind_wright | docker rm nervous_lamarr kind_wright | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Wird das Image nicht mehr benötigt, sollte auch dieses gelöscht werden | |||
* Sollten Sie hello-world später doch noch einmal | * Sollten Sie hello-world später doch noch einmal benötigen, wird das Image eben neuerlich heruntergeladen | ||
<syntaxhighlight lang="bash" highlight="1" line copy> | <syntaxhighlight lang="bash" highlight="1" line copy> | ||
docker image rm hello-world | docker image rm hello-world | ||
| Zeile 94: | Zeile 144: | ||
; Container einmal starten und sofort wieder löschen | ; Container einmal starten und sofort wieder löschen | ||
Soll ein Container nur einmalig ausgeführt werden, kann er auch mit der Option --rm (mit zwei vorangestellten Bindestrichen) gestartet werden | |||
<syntaxhighlight lang="bash" highlight="1" copy> | <syntaxhighlight lang="bash" highlight="1" copy> | ||
docker run --rm hello-world | docker run --rm hello-world | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== docker run vs. docker start == | |||
; Hauptunterschied | |||
* '''<code>docker run</code>''' erstellt einen '''neuen''' Container aus einem Image erstellt | |||
* '''<code>docker start</code>''' fährt einen einen '''bestehenden, gestoppten''' Container wieder hoch | |||
Im Hintergrund ist <code>docker run</code> ein praktischer Kombi-Befehl. Er führt automatisch zwei Schritte nacheinander aus: <code>docker create</code> und danach <code>docker start</code>. | |||
=== Vergleich === | |||
{| class="wikitable" | |||
! Funktion | |||
! <code>docker run</code> | |||
! <code>docker start</code> | |||
|- | |||
| Ziel-Objekt | |||
| Docker-Image | |||
| Bestehender Container (ID oder Name) | |||
|- | |||
| Lebenszyklus | |||
| Erstellt und startet eine brandneue Instanz. | |||
| Weckt eine gestoppte Instanz auf. | |||
|- | |||
| Daten & Zustand | |||
| Startet mit einer frischen, sauberen Vorlage. | |||
| Behält alle Dateien und Änderungen der letzten Sitzung. | |||
|- | |||
| Konfigurations-Flags | |||
| Akzeptiert Flags wie <code>-p</code>, <code>-v</code> und <code>-e</code> beim Start. | |||
| Nutzt die genauen Einstellungen aus der Erstellung. | |||
|- | |||
| Ausführungsmodus | |||
| Läuft standardmäßig im Vordergrund (außer mit <code>-d</code>). | |||
| Läuft standardmäßig im Hintergrund (außer mit <code>-a</code>). | |||
|} | |||
---- | |||
=== Befehle im Detail === | |||
==== docker run ==== | |||
Diesen Befehl nutzen Sie, wenn Sie einen Container zum allerersten Mal starten möchten | |||
* Da Docker den Container komplett neu aufbaut, müssen Sie das Quell-Image und die gewünschten Einstellungen angeben | |||
; Beispiel | |||
docker run -d -p 8080:80 --name mein-webserver nginx | |||
; Verhalten | |||
Docker lädt das Nginx-Image herunter, erstellt einen neuen Container namens <code>mein-webserver</code>, auf dem die Ports weitergeleitet werden, und startet ihn | |||
* Wenn Sie diesen Befehl mit demselben Namen ein zweites Mal ausführen, bricht Docker mit einer Fehlermeldung ab. Der Name ist dann nämlich schon vergeben | |||
==== docker start ==== | |||
Diesen Befehl nutzen Sie, wenn ein Container gestoppt wurde oder abgestürzt ist und Sie ihn einfach wieder einschalten möchten | |||
; Beispiel | |||
docker start mein-webserver | |||
; Verhalten | |||
Docker startet den bereits vorhandenen Container einfach neu | |||
* Alle Dateiänderungen aus der vorherigen Sitzung bleiben dabei erhalten | |||
* Da die Konfiguration bereits im Container gespeichert ist, können Sie bei diesem Befehl keine neuen Flags für Ports oder Umgebungsvariablen mehr anhängen | |||
<noinclude> | <noinclude> | ||
[[Kategorie:Docker/Grundlagen]] | [[Kategorie:Docker/Grundlagen]] | ||
</noinclude> | </noinclude> | ||
Aktuelle Version vom 18. November 2026, 14:36 Uhr
Docker/Grundlagen/02 Container ausführen
Docker Container ausführen
Beschreibung
Experimente, um sich mit Docker und seiner Nomenklatur vertraut zu machen
- Warung
- Ziel dieser Beispiele ist nicht der Start eines Entwicklungssystems oder der produktive Einsatz
- An dieser Stelle geht es darum, die Konzepte von Docker anhand von Beispielen kennenzulernen
Um dieses Image auszuprobieren und den davon abgeleiteten Container zu starten, führen Sie in einem Terminal eines der drei folgenden Kommandos aus
- macOS, Windows, Rootless Docker, Docker Desktop für Linux
docker run hello-world
- Linux
sudo docker run hello-world
Das jeweilige Kommando sieht zuerst nach, ob das Image hello-world auf dem lokalen Rechner bereits zur Verfügung steht
- Ist das nicht der Fall, wird es vom Docker Hub heruntergeladen und lokal gespeichert
Docker bildet daraus einen Container und führt diesen schließlich aus
docker run hello-world
Unable to find image 'hello-world: latest' locally
latest: Pulling from library/hello-world
b8dfde127a29: Pull complete
Digest: sha256:f226...d519
Status: Downloaded newer image for hello-world :latest
Hello from Docker !
This message shows that your installation appears to be working correctly
...
Ab dem zweiten Mal wird docker run hello-world blitzschnell ausgeführt, weil jetzt ein lokaler Container der Hello-World-App zur Verfügung steht
Das offizielle Hello-World-Image ist insofern ein untypisches Docker-Beispiel, als die darin verpackte App einmal ausgeführt wird und dann sofort endet
- Viele Docker- Container enthalten dagegen Programme, die Eingaben verarbeiten, dauerhaft laufen oder interaktiv genutzt werden können
sudo
Die vorgestellten Beispiele können unter jedem Betriebssystem gestartet werden
- Unter macOS oder Windows werden die Docker-Befehle mit Benutzeraccount ausgefüht
- Unter Linux mit root-Rechte
- es sei denn, Sie verwenden Rootless Docker oder Docker Desktop für Linux – siehe Docker/Installation
Um nicht jedem Befehl sudo vorranstellen zu müssen, kann der Linux-Account der Gruppe docker hinzugefügt werden
usermod -aG docker <accountname>
Damit diese Änderung wirksam wird, müssen Sie sich ab- und wieder anmelden
- Diese Gruppenzuordnung gibt dem Benutzer indirekt root-Rechte für Docker (siehe Docker/Interna)
Statusinformationen
- docker ps -a
liefert eine Liste aller laufenden oder in der Vergangenheit ausgeführten Docker-Container
- Die merkwürdigen Namen in der Spalte NAMES resultieren daraus, dass Docker jedem Container nicht nur eine zufällige ID zuweist, sondern auch einen leichter zu merkenden (aber ebenso zufälligen) Namen
docker ps -a
CONTAINER ID IMAGE COMMAND ... NAMES
f5269c759b7d hello-world "/hello" nervous_lamarr
c6770e95fdd3 hello-world "/hello" kind_wright
- docker images
Alle lokal installierten Images auflisten
docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-world latest 48b5124b2768 7 weeks ago 1.84 kB
Automatisch starten
Systemstart
Direkt beim Systemstart (docker run)
Fügen Sie die Option --restart hinzu
docker run -d --name mein-container --restart unless-stopped mein-image
- Restart-Optionen
| Option | Beschreibung |
|---|---|
| unless-stopped | (Empfohlen): Startet den Container immer automatisch neu – es sei denn, Sie haben ihn vorher manuell gestoppt |
| always | Startet den Container immer neu, auch wenn Sie ihn manuell gestoppt haben (er läuft nach einem Neustart des Docker-Daemons oder Servers wieder an) |
| on-failure | Startet den Container nur neu, wenn er mit einem Fehler (Exit-Code ungleich 0) abgestürzt ist |
| no | Standardeinstellung (kein automatischer Neustart) |
Nachträglich für einen bestehenden Container
Haben Sie den Container bereits erstellt, können Sie die Richtlinie aktualisieren mit docker update
docker update --restart=unless-stopped mein-container
Docker Compose
- docker-compose.yml/compose.yaml
In einer Compose-Datei tragen Sie die Option restart direkt beim jeweiligen Service ein
services:
mein-dienst:
image: nginx:latest
restart: unless-stopped
ports:
- "8080:80"
docker compose up -d
Aufräumen
Damit sich nicht unzählige Container ansammeln, sollten nicht mehr benötigte Container gelöscht werden
docker rm nervous_lamarr kind_wright
Wird das Image nicht mehr benötigt, sollte auch dieses gelöscht werden
- Sollten Sie hello-world später doch noch einmal benötigen, wird das Image eben neuerlich heruntergeladen
docker image rm hello-world
- Container einmal starten und sofort wieder löschen
Soll ein Container nur einmalig ausgeführt werden, kann er auch mit der Option --rm (mit zwei vorangestellten Bindestrichen) gestartet werden
docker run --rm hello-world
docker run vs. docker start
- Hauptunterschied
docker runerstellt einen neuen Container aus einem Image erstelltdocker startfährt einen einen bestehenden, gestoppten Container wieder hoch
Im Hintergrund ist docker run ein praktischer Kombi-Befehl. Er führt automatisch zwei Schritte nacheinander aus: docker create und danach docker start.
Vergleich
| Funktion | docker run
|
docker start
|
|---|---|---|
| Ziel-Objekt | Docker-Image | Bestehender Container (ID oder Name) |
| Lebenszyklus | Erstellt und startet eine brandneue Instanz. | Weckt eine gestoppte Instanz auf. |
| Daten & Zustand | Startet mit einer frischen, sauberen Vorlage. | Behält alle Dateien und Änderungen der letzten Sitzung. |
| Konfigurations-Flags | Akzeptiert Flags wie -p, -v und -e beim Start.
|
Nutzt die genauen Einstellungen aus der Erstellung. |
| Ausführungsmodus | Läuft standardmäßig im Vordergrund (außer mit -d).
|
Läuft standardmäßig im Hintergrund (außer mit -a).
|
Befehle im Detail
docker run
Diesen Befehl nutzen Sie, wenn Sie einen Container zum allerersten Mal starten möchten
- Da Docker den Container komplett neu aufbaut, müssen Sie das Quell-Image und die gewünschten Einstellungen angeben
- Beispiel
docker run -d -p 8080:80 --name mein-webserver nginx
- Verhalten
Docker lädt das Nginx-Image herunter, erstellt einen neuen Container namens mein-webserver, auf dem die Ports weitergeleitet werden, und startet ihn
- Wenn Sie diesen Befehl mit demselben Namen ein zweites Mal ausführen, bricht Docker mit einer Fehlermeldung ab. Der Name ist dann nämlich schon vergeben
docker start
Diesen Befehl nutzen Sie, wenn ein Container gestoppt wurde oder abgestürzt ist und Sie ihn einfach wieder einschalten möchten
- Beispiel
docker start mein-webserver
- Verhalten
Docker startet den bereits vorhandenen Container einfach neu
- Alle Dateiänderungen aus der vorherigen Sitzung bleiben dabei erhalten
- Da die Konfiguration bereits im Container gespeichert ist, können Sie bei diesem Befehl keine neuen Flags für Ports oder Umgebungsvariablen mehr anhängen