Docker/Grundlagen/02 Container ausführen: Unterschied zwischen den Versionen
K Dirkwagner verschob die Seite Docker/Grundlagen/02 Container ausführen nach Docker/Grundlagen/Container ausführen |
|||
| (31 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''' | |||
<noinclude> | |||
<bootstrap_jumbotron> | |||
<h2>Docker Container ausführen</h2> | |||
</bootstrap_jumbotron> | |||
</noinclude> | |||
== 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 | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker run hello-world | |||
</syntaxhighlight> | |||
; Linux | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
sudo docker run hello-world | |||
</syntaxhighlight> | |||
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 | |||
<syntaxhighlight lang="bash" highlight="" line> | |||
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 | |||
... | |||
</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 | |||
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 | |||
<syntaxhighlight lang="bash" highlight="1" line copy> | |||
usermod -aG docker <accountname> | |||
</syntaxhighlight> | |||
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 | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker ps -a | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="" line> | |||
CONTAINER ID IMAGE COMMAND ... NAMES | |||
f5269c759b7d hello-world "/hello" nervous_lamarr | |||
c6770e95fdd3 hello-world "/hello" kind_wright | |||
</syntaxhighlight> | |||
; | ; docker images | ||
Alle lokal installierten Images auflisten | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker images | |||
</syntaxhighlight> | |||
<syntaxhighlight lang="bash" highlight="" line> | |||
REPOSITORY TAG IMAGE ID CREATED SIZE | |||
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> | |||
Container | == Aufräumen == | ||
Damit sich nicht unzählige Container ansammeln, sollten nicht mehr benötigte Container gelöscht werden | |||
<syntaxhighlight lang="bash" highlight="1" copy> | |||
docker rm nervous_lamarr kind_wright | |||
</syntaxhighlight> | |||
Wird das Image nicht mehr benötigt, sollte auch dieses gelöscht werden | |||
(mit zwei vorangestellten Bindestrichen) | * Sollten Sie hello-world später doch noch einmal benötigen, wird das Image eben neuerlich heruntergeladen | ||
<syntaxhighlight lang="bash" highlight="1" line copy> | |||
docker image rm hello-world | |||
</syntaxhighlight> | |||
; 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> | |||
docker run --rm hello-world | docker run --rm hello-world | ||
</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/ | [[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