Docker/Image/Definition/01 Image erstellen: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
 
(10 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
== Image erstellen ==
== Image erstellen ==
; Überblick
; Überblick
* Sie richten in einem eigenen Verzeichnis die Datei Dockerfile ein
* In einem ''eigenen [[Verzeichnis]]'' die Datei Dockerfile ein
* Dort schreiben Sie mit Schlüsselwörtern die Eigenschaften Ihres Images fest ''docker build'' erzeugt das lokale Image
* Dort schreiben Sie mit Schlüsselwörtern die Eigenschaften Ihres Images fest
* ''docker build'' erzeugt das lokale Image
* Mit ''docker push'' können Sie es schließlich in eine öffentliche Docker-Image-Sammlung hochladen, wenn Sie das möchten
* Mit ''docker push'' können Sie es schließlich in eine öffentliche Docker-Image-Sammlung hochladen, wenn Sie das möchten


Zeile 15: Zeile 16:
* https://docs.docker.com/registry
* https://docs.docker.com/registry


=== Beispiel ===
== Beispiel ==
; Einführungsbeispiel
; Einführungsbeispiel
Minimale Dockerfile
Minimale Konfiguration
* Ubuntu-Base-Image
* Ubuntu-Base-Image
* Paket „joe“ installieren
* Paket „joe“ installieren


; Dockerfile
== Dockerfile ==
# Datei Dockerfile
<syntaxhighlight lang="dockerfile" highlight="" line copy>
  FROM ubuntu:22.04
# Datei Dockerfile
LABEL maintainer" name@somehost.com"
FROM ubuntu:22.04
RUN  apt - get update && \
LABEL maintainer "name@somehost.com"
apt - get install -y joe && \
RUN  apt-get update && \
apt - get clean && \
      apt-get install -y joe && \
rm -rf/var/lib/apt/lists/*
      apt-get clean && \
CMD  ["/bin/bash"]
      rm -rf /var/lib/apt/lists/*
CMD  ["/bin/bash"]
</syntaxhighlight>


; RUN
Mit RUN geben Sie Kommandos an, die einmalig beim Erstellen des neuen Images ausgeführt werden
Mit RUN geben Sie Kommandos an, die einmalig beim Erstellen des neuen Images ausgeführt werden
* Diese Kommandos werden in dem zur Image-Erzeugung vorübergehend eingerichteten Container ausgeführt, also im Gastsystem, nicht im Host-System
* Diese Kommandos werden in dem zur Image-Erzeugung vorübergehend eingerichteten Container ausgeführt, also im Gastsystem, nicht im Host-System
Oft handelt es sich dabei um Kommandos zur Installation von Paketen oder zum Kompilieren/Konfigurieren von Programmen
Oft handelt es sich dabei um Kommandos zur Installation von Paketen oder zum Kompilieren/Konfigurieren von Programmen


; Image erzeugen und testen Auf die Syntaxregeln für Dockerfiles sowie auf die Bedeutung der wichtigsten Schlüsselwörter gehen wir gleich ein
== Image erzeugen ==
Image erzeugen und testen Auf die Syntaxregeln für Dockerfiles sowie auf die Bedeutung der wichtigsten Schlüsselwörter gehen wir gleich ein
* Vorher wollen wir Ihnen aber zeigen, wie Sie aus dem Dockerfile zuerst ein Image und daraus einen Container erzeugen
* Vorher wollen wir Ihnen aber zeigen, wie Sie aus dem Dockerfile zuerst ein Image und daraus einen Container erzeugen
* Dazu führen Sie docker build oder podman build in dem Verzeichnis aus, in dem sich das Dockerfile befindet
* Dazu führen Sie docker build oder podman build in dem Verzeichnis aus, in dem sich das Dockerfile befindet
Zeile 43: Zeile 48:
* Wenn Sie noch keinen Account eingerichtet haben, können Sie vorerst einen beliebigen Namen angeben oder den Accountnamen ganz weglassen
* Wenn Sie noch keinen Account eingerichtet haben, können Sie vorerst einen beliebigen Namen angeben oder den Accountnamen ganz weglassen


cd projektverzeichnis
<syntaxhighlight lang="bash" highlight="" line copy>
docker build -t accountn am e/imagenam e  
cd projektverzeichnis
</syntaxhighlight>
 
<syntaxhighlight lang="bash" highlight="" line copy>
docker build -t accountn am e/imagenam e  
</syntaxhighlight>


Wir verwenden im weiteren Beispiel den Accountnamen userinfo und den Image-Namen ubuntu-joe:
Wir verwenden im weiteren Beispiel den Accountnamen userinfo und den Image-Namen ubuntu-joe:
docker build -t userinfo/ubuntu-joe  
<syntaxhighlight lang="bash" highlight="" line copy>
docker build -t userinfo/ubuntu-joe  
</syntaxhighlight>


Sollten bei der Ausführung von ''docker build'' Fehler auftreten, korrigieren Sie das Dockerfile und wiederholen den Build-Prozess
Sollten bei der Ausführung von ''docker build'' Fehler auftreten, korrigieren Sie das Dockerfile und wiederholen den Build-Prozess
Zeile 57: Zeile 69:
* Das ist insbesondere dann der Fall, wenn in einem RUN-Kommando etwas installiert oder kompiliert wird und in einem zweiten RUN-Kommando Aufräumarbeiten durchgeführt werden
* Das ist insbesondere dann der Fall, wenn in einem RUN-Kommando etwas installiert oder kompiliert wird und in einem zweiten RUN-Kommando Aufräumarbeiten durchgeführt werden
* Docker ist nicht in der Lage, in einem Delta-Image hinzugefügte und in einem weiteren Delta-Image wieder gelöschte Dateien vernünftig aufzuräumen
* Docker ist nicht in der Lage, in einem Delta-Image hinzugefügte und in einem weiteren Delta-Image wieder gelöschte Dateien vernünftig aufzuräumen
* Wenn Ihr Dockerfile also funktioniert, sollten Sie sämtliche Kommandos wie im Dockerfile von Abschnitt 4.3, ''Ein eigenes Webserver-Image'', in einem langen RUN-Kommando zusammen ausführen
* Wenn Ihr Dockerfile also funktioniert, sollten Sie sämtliche Kommandos wie im Dockerfile von [[Docker/Image/Definition/Webserver]], in einem langen RUN-Kommando zusammen ausführen
docker history imagename liefert eine Auflistung der Interim-Images und der dabei ausgeführten Kommandos:
docker history imagename liefert eine Auflistung der Interim-Images und der dabei ausgeführten Kommandos:


docker history userinfo/ubuntu-joe
<syntaxhighlight lang="bash" highlight="" line copy>
docker history userinfo/ubuntu-joe
</syntaxhighlight>


Um das erfolgreich erzeugte Image auszuprobieren, erstellen Sie daraus einen Container und testen ihn – im vorliegenden Minibeispiel durch einen Aufruf des Editors jmacs aus dem Paket joe:
Um das erfolgreich erzeugte Image auszuprobieren, erstellen Sie daraus einen Container und testen ihn – im vorliegenden Minibeispiel durch einen Aufruf des Editors jmacs aus dem Paket joe:


docker run -it --rm userinfo/ubuntu-joe
<syntaxhighlight lang="bash" highlight="" line copy>
root@b1c2c0a04f47:/# jmacs/etc/os-release
docker run -it --rm userinfo/ubuntu-joe
..
</syntaxhighlight>
root@b1c2c0a04f47:/# <Strg >+ <D >
<syntaxhighlight lang="bash" highlight="" line copy>
root@b1c2c0a04f47:/# jmacs/etc/os-release
...
root@b1c2c0a04f47:/# <Strg >+ <D >
</syntaxhighlight>


; ''docker build'' versus ''docker buildx''
; ''docker build'' versus ''docker buildx''
Docker hat in den vergangenen Jahren das interne Build-System grundlegend umgestellt
Docker hat in den vergangenen Jahren das interne Build-System grundlegend umgestellt


Das neue Build-System hat den Namen buildx
Das neue Build-System hat den Namen ''buildx''
* In der Übergangsphase hatten Sie die Wahl zwischen docker build (altes Build-System) und docker buildx build (neues Build-System)
* In der Übergangsphase hatten Sie die Wahl zwischen docker build (altes Build-System) und docker buildx build (neues Build-System)
* Bei aktuellen Docker-Versionen sind beide Kommandos gleichwertig und verwenden in jedem Fall buildx
* Bei aktuellen Docker-Versionen sind beide Kommandos gleichwertig und verwenden in jedem Fall buildx
Zeile 88: Zeile 106:
* Wenn die Kommandos Fehlermeldungen liefern, dann gab es nichts zu löschen
* Wenn die Kommandos Fehlermeldungen liefern, dann gab es nichts zu löschen


docker rm $ (docker ps -a -q -f ancestor=accountname/imagename)
<syntaxhighlight lang="bash" highlight="" line copy>
 
docker rm $ (docker ps -a -q -f ancestor=accountname/imagename)
docker rmi $(docker images accountname/imagename -f dangling=true -q)
</syntaxhighlight>
<syntaxhighlight lang="bash" highlight="" line copy>
docker rmi $(docker images accountname/imagename -f dangling=true -q)
</syntaxhighlight>

Aktuelle Version vom 20. November 2026, 07:17 Uhr

Image erstellen

Überblick
  • In einem eigenen Verzeichnis die Datei Dockerfile ein
  • Dort schreiben Sie mit Schlüsselwörtern die Eigenschaften Ihres Images fest
  • docker build erzeugt das lokale Image
  • Mit docker push können Sie es schließlich in eine öffentliche Docker-Image-Sammlung hochladen, wenn Sie das möchten
GitHub-Builds, private Images, eigene Registries

An dieser Stelle gehen wir nur auf die einfachste Variante zum Einrichten und Hochladen von Docker-Images ein

  • Dabei befinden sich alle Dateien in einem lokalen Verzeichnis, und Sie laden das fertige Image manuell in den Docker Hub hoch

Alternativen dazu sind die Verwendung einer GitHub oder GitLab-Registry zur Speicherung des Dockerfiles und aller anderen erforderlichen Dateien zur Durchführung automatisierter Builds, die Verwendung privater Image-Registries im Docker Hub (erfordert einen kostenpflichtigen Account) sowie das Einrichten einer eigenen Image-Registry

Weitere Informationen

Beispiel

Einführungsbeispiel

Minimale Konfiguration

  • Ubuntu-Base-Image
  •  Paket „joe“ installieren

Dockerfile

# Datei Dockerfile
FROM  ubuntu:22.04
LABEL maintainer "name@somehost.com"
RUN   apt-get update && \
      apt-get install -y joe && \
      apt-get clean && \
      rm -rf /var/lib/apt/lists/*
CMD   ["/bin/bash"]
RUN

Mit RUN geben Sie Kommandos an, die einmalig beim Erstellen des neuen Images ausgeführt werden

  • Diese Kommandos werden in dem zur Image-Erzeugung vorübergehend eingerichteten Container ausgeführt, also im Gastsystem, nicht im Host-System

Oft handelt es sich dabei um Kommandos zur Installation von Paketen oder zum Kompilieren/Konfigurieren von Programmen

Image erzeugen

Image erzeugen und testen Auf die Syntaxregeln für Dockerfiles sowie auf die Bedeutung der wichtigsten Schlüsselwörter gehen wir gleich ein

  • Vorher wollen wir Ihnen aber zeigen, wie Sie aus dem Dockerfile zuerst ein Image und daraus einen Container erzeugen
  • Dazu führen Sie docker build oder podman build in dem Verzeichnis aus, in dem sich das Dockerfile befindet
  • Als Parameter übergeben Sie einen Punkt, mit dem Sie auf das Verzeichnis mit dem Dockerfile verweisen
  • Mit -t geben Sie den gewünschten Image-Namen an
  •  Als Accountname verwenden Sie den Namen Ihres Docker-Accounts
  • Wenn Sie noch keinen Account eingerichtet haben, können Sie vorerst einen beliebigen Namen angeben oder den Accountnamen ganz weglassen
cd projektverzeichnis
docker build -t accountn am e/imagenam e

Wir verwenden im weiteren Beispiel den Accountnamen userinfo und den Image-Namen ubuntu-joe:

docker build -t userinfo/ubuntu-joe

Sollten bei der Ausführung von docker build Fehler auftreten, korrigieren Sie das Dockerfile und wiederholen den Build-Prozess

  • Docker geht dabei recht intelligent vor: Es erzeugt in einem Cache-Verzeichnis für jede Anweisung im Dockerfile ein Interim-Image
  • Wenn nach einer Änderung am Dockerfile Anweisungen unverändert bleiben, kann docker build die entsprechenden Images aus dem Cache weiterverwenden
  • Das können Sie bei Bedarf mit der Option --no-cache verhindern

Insofern ist es zum Debugging empfehlenswert, ein kompliziertes und fehleranfälliges RUN-Kommando zu vermeiden und stattdessen mehrere RUN-Kommandos für jeden Teilschritt vorzusehen Diese Vorgehensweise kann leider zu Images führen, die größer sind als unbedingt notwendig

  • Das ist insbesondere dann der Fall, wenn in einem RUN-Kommando etwas installiert oder kompiliert wird und in einem zweiten RUN-Kommando Aufräumarbeiten durchgeführt werden
  • Docker ist nicht in der Lage, in einem Delta-Image hinzugefügte und in einem weiteren Delta-Image wieder gelöschte Dateien vernünftig aufzuräumen
  • Wenn Ihr Dockerfile also funktioniert, sollten Sie sämtliche Kommandos wie im Dockerfile von Docker/Image/Definition/Webserver, in einem langen RUN-Kommando zusammen ausführen

docker history imagename liefert eine Auflistung der Interim-Images und der dabei ausgeführten Kommandos:

docker history userinfo/ubuntu-joe

Um das erfolgreich erzeugte Image auszuprobieren, erstellen Sie daraus einen Container und testen ihn – im vorliegenden Minibeispiel durch einen Aufruf des Editors jmacs aus dem Paket joe:

docker run -it --rm userinfo/ubuntu-joe
root@b1c2c0a04f47:/# jmacs/etc/os-release
...
root@b1c2c0a04f47:/# <Strg >+ <D >
docker build versus docker buildx

Docker hat in den vergangenen Jahren das interne Build-System grundlegend umgestellt

Das neue Build-System hat den Namen buildx

  • In der Übergangsphase hatten Sie die Wahl zwischen docker build (altes Build-System) und docker buildx build (neues Build-System)
  • Bei aktuellen Docker-Versionen sind beide Kommandos gleichwertig und verwenden in jedem Fall buildx

Das neue Build-System ist in der Lage, Images parallel für mehrere CPU-Plattformen zu erzeugen Es bietet darüber hinaus diverse neue Optimierungsfunktionen

Weitere Informationen

Aufräumen

Oft bedarf es etlicher Versuche, bis das neue Image so funktioniert, wie es soll

  • Denken Sie daran, gelegentlich alle nicht mehr benötigten Container und Images zu löschen
  • In den folgenden Kommandos muss accountname/imagename durch Ihre Bezeichnungen ersetzt werden
  • Wenn die Kommandos Fehlermeldungen liefern, dann gab es nichts zu löschen
docker rm $ (docker ps -a -q -f ancestor=accountname/imagename)
docker rmi $(docker images accountname/imagename -f dangling=true -q)