Docker/Image: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
 
(3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 2: Zeile 2:


== Beschreibung ==
== Beschreibung ==
; Unveränderliches Paket, das eine Anwendung und ihre Laufzeitumgebung beschreibt
Es besteht aus schreibgeschützten Dateisystemschichten und einer Konfiguration mit Metadaten wie Startbefehl (ENTRYPOINT/CMD), Umgebungsvariablen, Nutzer, Arbeitsverzeichnis, veröffentlichte Ports und deklarierte Volumes
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.
* Üblicherweise wird ein Image aus einem Dockerfile gebaut und in Registries gespeichert.
* Zusätzlich gibt es ein Manifest mit Tags und einer Inhaltssumme (Digest).  
* 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#Docker_Images|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
 
<syntaxhighlight lang="bash" highlight="1" line copy>
mkdir mydockerbuild
</syntaxhighlight>
2.&nbsp;In das neue Verzeichnis navigieren
<syntaxhighlight lang="bash" highlight="1" line copy>
cd mydockerbuild
</syntaxhighlight>
3.&nbsp; Neue Textdatei erstellen
<syntaxhighlight lang="bash" highlight="1" line copy>
nano dockerfile
</syntaxhighlight>
 
=== 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.
 
<syntaxhighlight lang="Dockerfile" highlight="1" line copy>
FROM docker/whalesay:latest
</syntaxhighlight>
 
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:
 
<syntaxhighlight lang="Dockerfile" highlight="1" line copy>
RUN apt-get -y update && apt-get install -y fortunes
</syntaxhighlight>
 
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:
 
<syntaxhighlight lang="Dockerfile" highlight="1" line copy>
CMD /usr/games/fortune -a | cowsay
</syntaxhighlight>
 
Ihr Dockerfile sollte nun folgendermaßen aussehen:
<syntaxhighlight lang="Dockerfile" highlight="1" line copy>
FROM docker/whalesay:latest
RUN apt-get -y update && apt-get install -y fortunes
CMD /usr/games/fortune -a | cowsay
</syntaxhighlight>
 
;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:
<syntaxhighlight lang="docker" highlight="1" copy line>
docker build -t docker-whale .
</syntaxhighlight>
 
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:
 
<syntaxhighlight lang="docker">
Successfully built a8f2048c9ab8
</syntaxhighlight>
 
Ihr neu erstelltes Image finden Sie unter dem Namen ''docker-whale'' in der Übersicht ihrer lokal gespeicherten Images
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo docker images
</syntaxhighlight>
 
Um einen Container aus Ihrem neu erstellten Image zu starten, verwenden Sie den Kommandozeilenbefehl sudo docker run in Kombination mit dem Namen des Images:
 
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo docker run docker-whale
</syntaxhighlight>
 
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 ==
[[Docker/Image/Images als Container starten]]
 
== Images anzeigen ==
; Alle 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
<syntaxhighlight lang="bash" highlight="1" line copy>
sudo docker images
</syntaxhighlight>
 
Der Befehl [[docker images]] ([[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 ==
[[Docker/Image/Images hochladen]]


{| class="table table-striped table-hover col1bold col1nowrap"
! !!
|-
| Docker-Images erstellen || [[Docker/Image/Image erstellen]]
|-
| 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 || [[Docker/Image/Images als Container starten]]
|-
| Images anzeigen || [[Docker/Image/Images anzeigen]]
|-
| Docker-Images taggen und ins Docker-Hub hochladen || [[Docker/Image/Images hochladen]]
|}
<noinclude>
<noinclude>



Aktuelle Version vom 20. November 2026, 11:46 Uhr

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

Beschreibung

Unveränderliches Paket, das eine Anwendung und ihre Laufzeitumgebung beschreibt

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/Image/Image erstellen
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 Docker/Image/Images als Container starten
Images anzeigen Docker/Image/Images anzeigen
Docker-Images taggen und ins Docker-Hub hochladen Docker/Image/Images hochladen


Anhang

Siehe auch


Dokumentation

Projekt