Docker/Image/Definition/01 Image erstellen
Image erstellen
- Überblick
- Sie richten 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 Dockerfile
- 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"]
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 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 Abschnitt 4.3, Ein eigenes Webserver-Image, 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)