|
|
| (4 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. In das neue Verzeichnis navigieren
| |
| <syntaxhighlight lang="bash" highlight="1" line copy>
| |
| cd mydockerbuild
| |
| </syntaxhighlight>
| |
| 3. 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]]
| |
| | |
| == 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 (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 ==
| |
| [[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> |
|
| |
|