Docker/Image: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Zeile 128: Zeile 128:


== Docker-Images herunterladen ==
== Docker-Images herunterladen ==
; Hochladen von Docker-Images auf Docker-Hub
[[Docker/Image/Image download]]
 
Das ''whalesay''-Image finden Sie, indem Sie die Startseite des Docker-Hubs aufrufen und den Begriff ''whalesay'' in die Suchleiste rechts neben dem Docker-Logo eingeben
 
Klicken Sie in den Suchergebnissen auf die Ressource mit der Bezeichnung ''docker/whalesay'', um das öffentliche Repository für dieses Image aufzurufen
 
Docker-Repositorys sind immer nach demselben Muster aufgebaut: Im Kopfbereich der Seite finden Nutzer die Bezeichnung des Images, die Kategorie des Repositorys sowie den Zeitpunkt des letzten Uploads (''last pushed'')
 
Darüber hinaus bietet jedes Docker-Repository folgende Info-Boxen:
 
{| class="table table-striped table-hover col1bold col1nowrap"
|-
! Feld !! Beschreibung
|-
|| Description || ausführliche Beschreibung, in der Regel inklusive Gebrauchsanweisung
|-
| Docker Pull Command || Kommandozeilenbefehl, um das Image aus dem Repository herunterzuladen (pull)
|-
| Owner || Information über den Ersteller des Repositorys
|-
| Comments || Kommentarbereich am Seitenende
|}
 
Den Informationsboxen des Repositorys lässt sich entnehmen, dass es sich bei ''whalesay'' um eine Modifikation des quelloffenen Perl-Skripts '''''cowsay''''' handelt
* Das von Tony Monroe im Jahr 1999 entwickelte Programm generiert in seiner Ursprungsform eine ASCII-Grafik in Form einer Kuh, die zusammen mit einer Nachricht im Terminal des Benutzers erscheint
 
Um ''docker/whalesay'' herunterzuladen, benutzen Sie den Befehl docker pull nach folgendem Grundschema:
 
<syntaxhighlight lang="bash" highlight="1" line copy>
docker pull [OPTIONS] NAME [:TAG|@DIGEST]
</syntaxhighlight>
 
Der Befehl docker pull weist den Daemon an, ein Image aus dem Repository zu laden
* Um welches Image es sich handelt, bestimmen Sie durch die Angabe der Image-Bezeichnung (''NAME'')
* Darüber hinaus können Sie Docker anweisen, wie der gewünschte Befehl ausgeführt werden soll (''OPTIONS'')
* Ebenfalls optional ist die Angabe von '''Tags''' ('':TAG'') und eindeutigen '''Identifikationsnummern''' (''@DIGEST''), die es ermöglichen, eine bestimmte Version eines Images herunterzuladen
 
Eine lokale Kopie des ''docker/whalesay''-Images erhalten Sie somit durch folgenden Befehl:
 
<syntaxhighlight lang="bash" highlight="1" line copy>
docker pull docker/whalesay
</syntaxhighlight>
 
In der Regel können Sie diesen Schritt jedoch überspringen
* Möchten Sie einen Container starten, lädt der Docker-Daemon Images, die er auf dem lokalen System nicht finden kann, automatisch aus dem Repository herunter


== Docker-Images als Container starten ==
== Docker-Images als Container starten ==

Version vom 20. November 2026, 11:26 Uhr

Docker/Image - Unveränderliches Paket, das eine Anwendung und ihre Laufzeitumgebung beschreibt

Beschreibung

Es besteht aus schreibgeschützten Dateisystemschichten und einer Konfiguration mit Metadaten wie Startbefehl (ENTRYPOINT/CMD), Umgebungsvariablen, Nutzer, Arbeitsverzeichnis, veröffentlichte Ports und deklarierte Volumes

  • Üblicherweise wird ein Image aus einem Dockerfile gebaut und in Registries gespeichert.
  • Zusätzlich gibt es ein Manifest mit Tags und einer Inhaltssumme (Digest).

Docker-Images erstellen

Docker-Hub bietet umfangreiche Möglichkeiten zum Erstellen eigener Images und zum Austausch dieser Images.

Erstellen einer Dockerfile
  • Jedes Docker-Image basiert auf einer Dockerfile
  • Eine Dockerfile ist eine Textdatei, die Anweisungen zum Erstellen eines Images enthält

1. Verwenden Sie folgenden Kommandozeilenbefehl, um ein Verzeichnis mit dem Namen mydockerbuild zu erstellen:

mkdir mydockerbuild

2. In das neue Verzeichnis navigieren

 cd mydockerbuild

3.  Neue Textdatei erstellen

nano dockerfile

Dockerfile schreiben

Die neu erstellte Textdatei dient als Bauplan für Ihr selbst entwickeltes Image

  • Anstatt das Image von Grund auf neu zu programmieren, wird in diesem Docker-Handbuch das Demo-Image docker/whalesay als Vorlage verwendet.
  • Um das Image in die Dockerfile aufzunehmen, muss darin der Befehl FROM angegeben werden.
  • Um die neueste Version des Images zu erhalten, wird das Tag :latest verwendet.
FROM docker/whalesay:latest

Bisher arbeitet docker/whalesay so, dass Sie dem Wal die Worte in den Mund legen müssen

  • Das Terminal zeigt genau den Text an, der zuvor in Kombination mit dem Befehl zum Starten des Containers eingegeben wurde.
  • Als Nächstes wird die automatische Generierung neuer Text-Ausgabedaten mit Hilfe des Programms fortunes gezeigt.
  • Die Grundfunktion von Fortunes besteht darin, Glückskeks-Sprüche und humorvolle Aphorismen zu generieren
  • Um den lokalen Paketindex zu aktualisieren und fortunes zu installieren, verwenden Sie den folgenden Befehl:
RUN apt-get -y update && apt-get install -y fortunes

Anschließend definieren Sie ein CMD-Statement

  • Das CMD-Statement wird beim Start des Containers ausgeführt, sofern es beim Aufruf (docker run image CMD) nicht überschrieben wurde
  • Verwenden Sie folgenden Befehl, um das Programm fortunes mit der Option -a („Wähle aus allen Datenbanken“) auszuführen und die Ausgabe über das Programm cowsay im Terminal anzeigen zu lassen:
CMD /usr/games/fortune -a | cowsay

Ihr Dockerfile sollte nun folgendermaßen aussehen:

FROM docker/whalesay:latest
RUN apt-get -y update && apt-get install -y fortunes
CMD /usr/games/fortune -a | cowsay
Hinweis
Befehle innerhalb eines Dockerfiles sind immer einzeilig und beginnen stets mit einem Schlüsselwort
  • Die zugrundeliegende Syntax ist case-insensitive – es ist also egal, ob Sie groß- oder kleinschreiben
  • Es hat sich jedoch eine konsequente Großschreibung von Schlüsselwörtern etabliert
  • Textdatei speichern: Speichern Sie Ihre Eingabe
  • Sollten Sie den Editor Nano verwenden, nutzen Sie dazu die Tastenkombination [STRG] + [O] und bestätigen Sie mit [ENTER]
  • Nano gibt Ihnen die Meldung aus, dass drei Zeilen in die ausgewählte Datei geschrieben wurden
  • Beenden Sie den Texteditor mit der Tastenkombination [STRG] + [X]
  • Image aus Dockerfile erstellen: Um ein Image aus einem Dockerfile zu erstellen, navigieren Sie zunächst in das Verzeichnis, in dem Sie die Textdatei abgelegt haben
  • Die Image-Erstellung starten Sie mit dem Kommandozeilenbefehl docker build
  • Möchten Sie das Image individuell benennen oder mit einem Tag versehen, verwenden Sie die Option -t sowie nachfolgend die gewünschte Kombination aus Bezeichnung und Tag
  • Es gilt das Standardformat name:tag

Im aktuellen Beispiel soll ein Image mit dem Namen docker-whale erzeugt werden:

docker build -t docker-whale .

Der abschließende Punkt gibt an, dass sich das zugrundeliegende Dockerfile im ausgewählten Verzeichnis befindet

  • Alternativ haben Sie die Möglichkeit, einen Dateipfad oder eine URL zu den Quelldateien anzugeben

Der build-Prozess startet, sobald Sie den Befehl mit [ENTER] bestätigt haben

  • Zunächst überprüft der Docker-Daemon, ob ihm alle Dateien vorliegen, die für die Erstellung des Images benötigt werden
  • In der Docker-Terminologie werden diese unter dem Begriff „Context“ zusammengefasst
  • Im Anschluss wird das Image docker/whalesay mit dem Tag :latest lokalisiert
  • Liegt der für die Image-Erstellung benötigte Context vollständig vor, startet der Docker-Daemon die via FROM eingebundene Image-Vorlage in einem temporären Container und geht zum nächsten Befehl im Dockerfile über
  • Im aktuellen Beispiel handelt es sich dabei um den RUN-Befehl, der die Installation des fortunes-Programms zur Folge hat

Am Ende jedes Schritts im Rahmen der Image-Erstellung gibt Docker Ihnen eine ID für den entsprechenden Layer (Schicht) aus, der in diesem Schritt erstellt wurde

  • Dabei gilt: Jede Zeile im zugrundeliegenden Dockerfile entspricht einem Layer des darauf aufbauenden Images

Wurde der RUN-Befehl beendet, stoppt der Docker-Daemon den dafür erstellten Container, entfernt diesen und startet einen neuen temporären Container für das Layer des CMD-Statements

  • Am Ende des Erstellungsprozesses wird auch dieser temporäre Container beendet und entfernt
  • Docker gibt Ihnen die ID des neuen Images aus:
Successfully built a8f2048c9ab8

Ihr neu erstelltes Image finden Sie unter dem Namen docker-whale in der Übersicht ihrer lokal gespeicherten Images

sudo docker images

Um einen Container aus Ihrem neu erstellten Image zu starten, verwenden Sie den Kommandozeilenbefehl sudo docker run in Kombination mit dem Namen des Images:

sudo docker run docker-whale

Wurde das Image fehlerfrei aus dem Dockerfile erstellt, sollte Ihr Wal Sie nun mit mehr oder weniger weisen Sprüchen begeistern

  • Beachten Sie: Jedes Mal, wenn Sie den Container neu starten, wird ein anderer Spruch generiert

Image layering

Docker/Image/Image layering

Layer caching

Docker/Image/Layer caching

Multi-stage builds

Docker/Image/Multi-stage builds

Docker-Images herunterladen

Docker/Image/Image download

Docker-Images als Container starten

Um ein Docker-Image zu starten, nutzen Sie den Befehl docker run nach folgendem Grundschema:

docker run [OPTIONS] IMAGE [:TAG|@DIGEST] [CMD] [ARG…]

Einziger obligatorischer Bestandteil des Befehls docker run ist die Bezeichnung des gewünschten Docker-Images

  • Auch wenn Sie Container starten, haben Sie die Möglichkeit, fakultative Optionen, TAGs und DIGESTs zu definieren
  • Darüber hinaus lässt sich der Befehl docker run mit weiteren Befehlen kombinieren, die ausgeführt werden, sobald der Container startet
  • In diesem Fall wird der vom Image-Ersteller definierte CMD (COMMAND, ein Befehl, der beim Starten des Containers automatisch ausgeführt wird) überschrieben
  • Weitere optionale Konfigurationen lassen sich durch zusätzliche Argumente (ARG…) definieren
  • Diese ermöglichen es beispielweise, Benutzer hinzuzufügen oder Umgebungsvariablen (Environment-Variables) zu übergeben

Nutzen Sie den Kommandozeilenbefehl

docker run docker/whalesay cowsay boo

um das als Image vorliegende Perl-Skript herunterzuladen und in einem Container auszuführen

  • Sie werden sehen, dass sich whalesay in einem wesentlichen Punkt vom Ursprungsskript unterscheidet
  • Wird *docker/whalesay* mit dem Standardbefehl ausgeführt, beschränkt sich der Docker-Wal auf ein kurzes *boo*

Wird das Image docker/whalesay ausgeführt, gibt das Skript eine ASCII-Grafik in Form eines Wals sowie die mit dem cowsay-Befehl übergebene Textnachricht „boo“ im Terminal aus

Wie beim Testlauf sucht der Daemon das gewünschte Image zunächst im lokalen Dateiverzeichnis

  • Da sich hier kein gleichnamiges Paket findet, wird ein Pulling aus dem Docker-Repository eingeleitet
  • Anschließend startet der Daemon das modifizierte Cowsay-Programm
  • Ist dieses durchgelaufen, wird der Container automatisch beendet

Wie cowsay bietet Ihnen auch Dockers whalesay die Möglichkeit, in den Programmablauf einzugreifen, um die Textausgabe im Terminal zu beeinflussen

  • Testen Sie diese Funktion, indem Sie das „boo“ im Ausgangsbefehl durch eine beliebige Zeichenfolge ersetzen – beispielsweise durch einen lahmen Wal-Witz.
sudo docker run docker/whalesay cowsay What did the shark say to the whale? What are you blubbering about?

Alle Docker-Images auf dem lokalen System anzeigen

Sind Sie sich nicht sicher, ob Sie ein bestimmtes Image bereits heruntergeladen haben, können Sie eine Übersicht aller Images auf Ihrem lokalen System aufrufen

  • Nutzen sie dazu folgenden Kommandozeilenbefehl:
sudo docker images

Der Befehl docker images (alternativ docker image ls) gibt Ihnen alle lokalen Images inklusive Dateigröße, Tag und Image-ID aus

Starten Sie einen Container, wird das zugrundeliegende Image als Kopie aus dem Repository heruntergeladen und dauerhaft auf Ihrem Computer gespeichert

  • So sparen Sie Zeit, falls Sie zu einem späteren Zeitpunkt erneut auf das betreffende Image zugreifen möchten
  • Ein erneuter Download wird nur dann eingeleitet, wenn sich die Image-Quelle verändert – beispielsweise, wenn im Repository eine aktuellere Version zur Verfügung steht

Docker-Images taggen und ins Docker-Hub hochladen

Möchten Sie Ihr selbsterstelltes Image docker-whale ins Hub laden, um es dort der Community oder einer Arbeitsgruppe zur Verfügung zu stellen, müssen Sie es zunächst mit einem gleichnamigen Repository in Ihrem persönlichen Namespace verknüpfen

  • In der Docker-Terminologie wird dieser Schritt Tagging genannt

Um ein Image über das Docker-Hub zu veröffentlichen, gehen Sie folgendermaßen vor:

1. Repository erstellen: Loggen Sie sich mit Ihrer Docker-ID und dem persönlichen Passwort im Docker-Hub ein und erstellen Sie ein öffentliches Repository mit dem Namen docker-whale

2. Image-ID ermitteln: Ermitteln Sie die ID Ihres selbsterstellten Images docker-whale mithilfe des Kommandozeilenbefehls docker images

  • Diese benötigen wir für das Tagging im nächsten Schritt.

3. Image taggen: Taggen Sie das Image docker-whale mithilfe des Kommandozeilenbefehls docker tag nach folgendem Schema:

sudo docker tag [Image-ID][Docker-ID]/[Image-Name]:[TAG]

Auf das aktuelle Beispiel bezogen lautet der Kommandozeilenbefehl für das Tagging somit:

sudo docker tag a8f2048c9ab8 [Namespace]/docker-whale:latest

Ob Ihr Image korrekt getaggt wurde, überprüfen Sie in der Übersicht via docker images

  • Der Name des Repositorys sollte nun Ihre Docker-ID beinhalten
  1. Image hochladen: Um das Image hochzuladen, müssen Sie sich zunächst im Docker-Hub anmelden
  • Dies erfolgt über den Kommandozeilenbefehl docker login


sudo docker login

Das Terminal fordert Sie auf, Ihren Benutzernahmen (die Docker-ID) sowie ihr Passwort einzugeben


War die Anmeldung erfolgreich, verwenden Sie den Kommandozeilenbefehl docker push, um Ihr Image in das neu erstellte Repository hochzuladen

sudo docker push [Namespace]/docker-whale

Der Upload-Prozess sollte lediglich einige Sekunden in Anspruch nehmen

  • Der aktuelle Status wird Ihnen über das Terminal ausgegeben

Melden Sie sich über den Browser im Docker-Hub an, um sich das hochgeladene Image anzeigen zu lassen

Möchten Sie mehr als ein Image pro Repository hochladen, verwenden Sie verschiedene Tags, um Ihre Images in unterschiedlichen Versionen anzubieten

  • Beispielsweise:
[Namespace]/docker-whale:latest
[Namespace]/docker-whale:version1
[Namespace]/docker-whale:version2

Eine Übersicht verschiedener Image-Versionen lässt sich in Docker-Hub-Repositorys über den Reiter „Tags“ abrufen

Images verschiedener Projekte hingegen sollten in separaten Repositorys angeboten werden

War der Upload erfolgreich, steht Ihr selbsterstelltes Image nun jedem Docker-Nutzer weltweit über das öffentliche Repository zur Verfügung.

  • Testlauf: Testen Sie den Erfolg des Uploads, indem Sie das soeben hochgeladene Image herunterladen

Beachten Sie, dass Sie die lokale Version des Images zunächst löschen müssen, um eine neue Kopie mit demselben Tag herunterzuladen

  • Andernfalls meldet Docker, dass das gewünschte Image bereits in der aktuellen Version vorliegt

Um lokale Docker-Images zu löschen, nutzen Sie den Kommandozeilenbefehl docker rmi in Kombination mit der entsprechenden Image-ID

  • Diese ermitteln Sie wie gehabt via docker images. Meldet Docker Konflikte – beispielsweise weil eine Image-ID in mehreren Repositorys oder von einem Container verwendet wird –, bekräftigen Sie Ihren Befehl mit der Option --force (Kurz: -f), um den Löschvorgang zu erzwingen
sudo docker rmi -f a8f2048c9ab8

Lassen Sie sich erneut eine Übersicht aller lokalen Images anzeigen:

sudo docker images

Die gelöschten Elemente sollten in der Terminal-Ausgabe nicht mehr auftauchen

  • Nutzen Sie nun den im Repository angegebenen Pull-Befehl, um eine neue Kopie des Images aus dem Docker-Hub herunterzuladen:
sudo docker pull [Namespace]/docker-whale

Docker/Eigene Images


Anhang

Siehe auch


Dokumentation

Projekt