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

Aus Foxwiki
Wechseln zu:Navigation, Suche
 
(22 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 hier vorgestellten Beispiele können grundsätzlich unter jedem Betriebssystem ausprobiert werden
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 Befehlt [[sudo]] vorran stellen zu müssen, kann der Linux-Account der Gruppe docker hinzugefügt werden
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 bzw. in der Vergangenheit ausgeführten Docker-Container.
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>
docker ps -a
docker ps -a
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 79: Zeile 90:
</syntaxhighlight>
</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>


== Aufräumen ==
== Aufräumen ==
Es besteht die Gefahr, dass sich rasch unzählige Container ansammeln, die einmal ausgeführt wurden, aber nicht mehr benötigt werden.
Damit sich nicht unzählige Container ansammeln, sollten nicht mehr benötigte Container gelöscht werden
 
Deswegen sollten Sie nicht mehr benötigte Container löschen:
<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>


Wenn Sie erwarten, dass Sie das zugrundeliegende Image auch nicht mehr benötigen (in diesem Fall, weil Sie nicht vorhaben, run hello-world noch öfter auszuführen), dann können Sie auch das Image löschen.
Wird das Image nicht mehr benötigt, sollte auch dieses gelöscht werden
* Sollten Sie hello-world später doch noch einmal brauchen, wird das Image eben neuerlich heruntergeladen.
* 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 95: 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
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 (mit zwei vorangestellten Bindestrichen) übergeben:


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