Docker/Image/Definition/01 Image erstellen: Unterschied zwischen den Versionen
| (5 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 16: | Zeile 16: | ||
* https://docs.docker.com/registry | * https://docs.docker.com/registry | ||
== Beispiel == | |||
; Einführungsbeispiel | ; Einführungsbeispiel | ||
Minimale Konfiguration | |||
* Ubuntu-Base-Image | * Ubuntu-Base-Image | ||
* Paket „joe“ installieren | * Paket „joe“ installieren | ||
== Dockerfile == | |||
<syntaxhighlight lang=" | <syntaxhighlight lang="dockerfile" highlight="" line copy> | ||
# 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"] | |||
</syntaxhighlight> | </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 == | |||
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 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 | ||
| Zeile 47: | 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 | ||
<syntaxhighlight lang="bash" highlight="" line copy> | |||
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: | ||
<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 61: | 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 | * 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: | ||
<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: | ||
<syntaxhighlight lang="bash" highlight="" line copy> | |||
docker run -it --rm userinfo/ubuntu-joe | |||
</syntaxhighlight> | |||
<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 92: | 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 | ||
<syntaxhighlight lang="bash" highlight="" line copy> | |||
docker rm $ (docker ps -a -q -f ancestor=accountname/imagename) | |||
</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
- https://docs.docker.com/docker-hub/builds
- https://docs.docker.com/docker-hub/builds/link-source
- https://docs.docker.com/registry
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
- https://docs.docker.com/buildx/working-with-buildx
- https://docs.docker.com/engine/reference/commandline/buildx
- https://github.com/docker/buildx
- 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)