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

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
 
(28 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
== Container ausführen ==
<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
Experimente, um sich mit Docker und seiner Nomenklatur vertraut zu machen


Zeile 6: 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
docker run hello - world                  ( f ü r Docker unter macOS und
 
Windows , Rootless Docker ,
; macOS, Windows, [[Rootless Docker]], Docker Desktop für Linux
Docker Desktop f ür Linux )
<syntaxhighlight lang="bash" highlight="1" copy>
docker run hello-world
</syntaxhighlight>


sudo docker run hello - world                 ( Docker Engine unter Linux )
; Linux
<syntaxhighlight lang="bash" highlight="1" copy>
sudo docker run hello-world
</syntaxhighlight>


podman run hello - world                     ( Podman )
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


Das jeweilige Kommando sieht zuerst nach, ob das Image hello-world auf dem lokalen Rechner bereits zur Verfügung steht.
Docker bildet daraus einen Container und führt diesen schließlich aus
* Ist das nicht der Fall, wird es vom Docker Hub heruntergeladen und lokal gespeichert.
<syntaxhighlight lang="bash" highlight="" line>
* Docker bzw. Podman 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


docker run hello - world
Hello from Docker !
Unable to find image 'hello - world : latest ' locally
This message shows that your installation appears to be working correctly
latest : Pulling from library /hello -world
...
b8dfde12 7 a 2 9 : Pull complete
</syntaxhighlight>
Digest : sha256 : f226 ...
d519
Status : Download ed newer image for hello -world :latest
Hello from Docker !
This message shows that your installa t i o n appears to be working
correctl y .
...


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.
 
* Viele Docker- Container enthalten dagegen Programme, die Eingaben verarbeiten, dauerhaft laufen oder interaktiv genutzt werden können.
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 ==
== sudo ==
Die in diesem Kapitel präsentierten Beispiele können Sie grundsätzlich unter jedem Betriebssystem ausprobieren.
Die vorgestellten Beispiele können unter jedem Betriebssystem gestartet werden
* Aber während Sie das Kommando docker unter macOS
* Unter macOS oder Windows werden die Docker-Befehle mit Benutzeraccount ausgefüht
oder Windows in einem gewöhnlichen Benutzeraccount ausführen können, benötigt
* Unter Linux mit root-Rechte
es unter Linux root-Rechte (es sei denn, Sie verwenden Rootless Docker oder Docker
** es sei denn, Sie verwenden Rootless Docker oder Docker Desktop für Linux – siehe [[Docker/Installation]]
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
Um nicht jedem Befehl [[sudo]] vorranstellen zu müssen, kann der Linux-Account der Gruppe ''docker'' hinzugefügt werden
sudo voranzustellen, gibt es einen Ausweg: Sie fügen Ihren Linux-Account der Gruppe
<syntaxhighlight lang="bash" highlight="1" line copy>
docker hinzu:
usermod -aG docker <accountname>
usermod -aG docker <accountname>
</syntaxhighlight>
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-
Damit diese Änderung wirksam wird, müssen Sie sich ab- und wieder anmelden
ren.
* Diese Gruppenzuordnung gibt dem Benutzer indirekt root-Rechte für Docker (siehe [[Docker/Interna]])
* Beachten Sie, dass die scheinbar harmlose Gruppenzuordnung dem betreffenden
Benutzer indirekt root-Rechte gibt (siehe Abschnitt 6.7, »Docker-Interna«).


== Statusinformationen ==
== Statusinformationen ==
docker ps -a liefert eine Liste aller laufenden bzw. in der Vergangenheit ausgeführten Docker-Container.
; docker ps -a
* 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.
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 ps -a
; docker images
CONTAINE R ID            IMAGE              COMMAND        ...  NAMES
Alle lokal installierten Images auflisten
f5269c75 9 b 7 d        hello - world      "/ hello "          nervous_l a m a r r
<syntaxhighlight lang="bash" highlight="1" copy>
c6770e95 f d d 3        hello - world       "/ hello "          kind_wrig h t
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 images listet die lokal installierten Images auf:
== 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


docker images
; Restart-Optionen
REPOSITO R Y            TAG          IMAGE ID            CREATED          SIZE
{| class="table table-striped table-hover col1bold col1nowrap"
hello -world            latest        48 b5124b27 6 8    7 weeks ago      1.84 kB
|-
! 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)
|}


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


Auch den obigen Kommandos müssen Sie gegebenenfalls sudo voranstellen.
=== Docker Compose ===
* Falls Sie mit Podman arbeiten, ersetzen Sie docker durch podman.  
; docker-compose.yml/compose.yaml
* In Zukunft geben wir immer nur das Kommando docker an, ohne auf diese Differenzierung hinzuweisen.
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>


== 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>
docker rm nervous_lamarr 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.
Wird das Image nicht mehr benötigt, sollte auch dieses gelöscht werden
* Deswegen sollten Sie nicht mehr benötigte Container gleich wieder löschen:
* 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>


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


Wenn Sie erwarten, dass Sie das zugrundeliegende Image auch nicht mehr benötigen
<syntaxhighlight lang="bash" highlight="1" copy>
(in diesem Fall, weil Sie nicht vorhaben, run hello-world noch öfter auszuführen), dann können Sie auch das Image löschen.
docker run --rm hello-world
* Sollten Sie hello-world später doch noch einmal brauchen, wird das Image eben neuerlich heruntergeladen.
</syntaxhighlight>


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


Container einmal starten und sofort wieder löschen
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>.


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
=== Vergleich ===
(mit zwei vorangestellten Bindestrichen) übergeben:
{| class="wikitable"
docker run --rm hello-world
! 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/Buch/03 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 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