Docker/Grundlagen/02 Container ausführen: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Die Seite wurde neu angelegt: „== Container ausführen == Um sich mit Docker und Podman und seiner Nomenklatur vertraut zu machen, empfehlen wir Ihnen, einige Stunden zu experimentieren (also »herumzuspielen«, wenn Sie so wollen). * Die folgenden Abschnitte geben Ihnen dazu Anregungen. Wir weisen explizit darauf hin, dass das Ziel dieser Beispiele nicht der Start eines echten Entwicklungssystems oder gar der produktive Einsatz ist. * Konkrete Anleitungen zur Verwendung wichtiger Im…“
 
 
(36 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
== Container ausführen ==
<noinclude>
Um sich mit Docker und Podman und seiner Nomenklatur vertraut zu machen, empfehlen wir Ihnen, einige Stunden zu experimentieren (also »herumzuspielen«, wenn Sie so wollen).
----
* Die folgenden Abschnitte geben Ihnen dazu Anregungen.
{{Navigation|Docker/Grundlagen|Docker/Grundlagen/03 Containerinteraktion}}
Wir weisen explizit darauf hin, dass das Ziel dieser Beispiele nicht der Start eines echten Entwicklungssystems oder gar der produktive Einsatz ist.
----
* Konkrete Anleitungen zur Verwendung wichtiger Images folgen in Teil II, »Werkzeugkasten«.
'''Docker/Grundlagen/02 Container ausführen'''
* An dieser Stelle geht es vielmehr darum, die Konzepte von Docker und Podman anhand von Beispielen kennen zu lernen – Learning by Doing also.
<noinclude>
Für allererste Tests, die in ihrer Funktionalität noch simpler sind als unser Hello- World-Beispiel aus Kapitel 1, gibt es im Docker Hub (https://hub.docker.com) sowie in einigen anderen Registries ein spezielles Hello-World-Image.
* Um dieses Image auszuprobieren und den davon abgeleiteten Container zu starten, führen Sie in einem Terminal eines der drei folgenden Kommandos aus:


docker run hello - world                  ( f ü r Docker unter macOS und
<bootstrap_jumbotron>
Windows , Rootless Docker ,
<h2>Docker Container ausführen</h2>
Docker Desktop f ür Linux )
</bootstrap_jumbotron>


sudo docker run hello - world                ( Docker Engine unter Linux )
</noinclude>


podman run hello - world                      ( Podman )
== Beschreibung ==
Experimente, um sich mit Docker und seiner Nomenklatur vertraut zu machen


Das jeweilige Kommando sieht zuerst nach, ob das Image hello-world auf dem lokalen Rechner bereits zur Verfügung steht.
; Warung
* Ist das nicht der Fall, wird es vom Docker Hub heruntergeladen und lokal gespeichert.
: Ziel dieser Beispiele ist nicht der Start eines Entwicklungssystems oder der produktive Einsatz
* Docker bzw. Podman bildet daraus einen Container und führt diesen schließlich aus:
:* An dieser Stelle geht es darum, die Konzepte von Docker anhand von Beispielen kennenzulernen


docker run hello - world
Um dieses Image auszuprobieren und den davon abgeleiteten Container zu starten, führen Sie in einem Terminal eines der drei folgenden Kommandos aus
Unable to find image 'hello - world : latest ' locally
latest : Pulling from library /hello -world
b8dfde12 7 a 2 9 : Pull complete
Digest : sha256 : f226 ...
* d519
Status : Download ed newer image for hello -world :latest


Hello from Docker !
; macOS, Windows, [[Rootless Docker]], Docker Desktop für Linux
This message shows that your installa t i o n appears to be working
<syntaxhighlight lang="bash" highlight="1" copy>
correctl y .
docker run hello-world
...
</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.
; Linux
Das offizielle Hello-World-Image ist insofern ein untypisches Docker-Beispiel, als die darin verpackte App einmal ausgeführt wird und dann sofort endet.
<syntaxhighlight lang="bash" highlight="1" copy>
* Viele Docker- Container enthalten dagegen Programme, die Eingaben verarbeiten, dauerhaft laufen oder interaktiv genutzt werden können.
sudo docker run hello-world
</syntaxhighlight>


; Ständig »sudo«?
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
Die in diesem Kapitel präsentierten Beispiele können Sie grundsätzlich unter jedem
Betriebssystem ausprobieren.
* Aber während Sie das Kommando docker unter macOS
oder Windows in einem gewöhnlichen Benutzeraccount ausführen können, benötigt
es unter Linux root-Rechte (es sei denn, Sie verwenden Rootless Docker oder Docker
Desktop für Linux – siehe Abschnitt 2.5 und Abschnitt 2.6).
Da es lästig ist, ständig mit root-Rechten zu arbeiten oder jedem docker-Kommando
sudo voranzustellen, gibt es einen Ausweg: Sie fügen Ihren Linux-Account der Gruppe
docker hinzu:
usermod -aG docker <accountname>
Damit diese Änderung wirksam wird, müssen Sie sich ab- und wieder anmelden.
Danach können Sie das Kommando docker auch unter Linux ohne Weiteres ausfüh-
ren.
* Beachten Sie, dass die scheinbar harmlose Gruppenzuordnung dem betreffenden
Benutzer indirekt root-Rechte gibt (siehe Abschnitt 6.7, »Docker-Interna«).


; Statusinformationen
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


docker ps -a liefert eine Liste aller laufenden bzw. in der Vergangenheit ausgeführten Docker-Container.  
Hello from Docker !
* 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.
This message shows that your installation appears to be working correctly
...
</syntaxhighlight>


docker ps -a
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
CONTAINE R ID            IMAGE              COMMAND        ...  NAMES
f5269c75 9 b 7 d        hello - world       "/ hello "          nervous_l a m a r r
c6770e95 f d d 3        hello - world      "/ hello "          kind_wrig h t


docker images listet die lokal installierten Images auf:
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


docker images
== sudo ==
REPOSITO R Y            TAG          IMAGE ID            CREATED          SIZE
Die vorgestellten Beispiele können unter jedem Betriebssystem gestartet werden
hello -world            latest        48 b5124b27 6 8    7 weeks ago      1.84 kB
* 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]]


; Das richtige Kommando
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>


Auch den obigen Kommandos müssen Sie gegebenenfalls sudo voranstellen.
Damit diese Änderung wirksam wird, müssen Sie sich ab- und wieder anmelden
* Falls Sie mit Podman arbeiten, ersetzen Sie docker durch podman.
* Diese Gruppenzuordnung gibt dem Benutzer indirekt root-Rechte für Docker (siehe [[Docker/Interna]])
* In Zukunft geben wir immer nur das Kommando docker an, ohne auf diese Differenzierung hinzuweisen.


; Aufräumen
== 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>


Es besteht die Gefahr, dass sich rasch unzählige Container ansammeln, die einmal ausgeführt wurden, aber nicht mehr benötigt werden.  
; docker images
* Deswegen sollten Sie nicht mehr benötigte Container gleich wieder löschen:
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>


  docker rm nervous_ la m a r r kind_wri g h t
== 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


Wenn Sie erwarten, dass Sie das zugrundeliegende Image auch nicht mehr benötigen
; Restart-Optionen
(in diesem Fall, weil Sie nicht vorhaben, run hello-world noch öfter auszuführen), dann können Sie auch das Image löschen.
{| class="table table-striped table-hover col1bold col1nowrap"
* Sollten Sie hello-world später doch noch einmal brauchen, wird das Image eben neuerlich heruntergeladen.
|-
! 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)
|}


  docker image rm hello - world
==== 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


Container einmal starten und sofort wieder löschen
=== Docker Compose ===
; docker-compose.yml/compose.yaml
In einer Compose-Datei tragen Sie die Option restart direkt beim jeweiligen Service ein


Wenn Sie von vornherein wissen, dass Sie einen Container nur einmal ausführen und dann unmittelbar wieder löschen möchten, können Sie die zusätzliche Option --rm
<syntaxhighlight lang="yaml" highlight="" line copy>
(mit zwei vorangestellten Bindestrichen) übergeben:
services:
  mein-dienst:
    image: nginx:latest
    restart: unless-stopped
    ports:
      - "8080:80"
</syntaxhighlight>
 
<syntaxhighlight lang="yaml" highlight="1" copy>
docker compose up -d
</syntaxhighlight>
 
== 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
* 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>
[[Kategorie:Docker/Grundlagen]]
</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 run erstellt einen neuen Container aus einem Image erstellt
  • docker start fä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