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

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Zeile 17: Zeile 17:
=== Beispiel ===
=== Beispiel ===
; Einführungsbeispiel
; Einführungsbeispiel
Minimale Dockerfile
Minimales Dockerfile
* Ubuntu-Base-Image
* Ubuntu-Base-Image
* Paket „joe“ installieren
* Paket „joe“ installieren


; Dockerfile
; Dockerfile
<syntaxhighlight lang="bash" highlight="1" line copy>
  # Datei Dockerfile
  # Datei Dockerfile
  FROM ubuntu:22.04
  FROM ubuntu:22.04
Zeile 30: Zeile 31:
  rm -rf/var/lib/apt/lists/*
  rm -rf/var/lib/apt/lists/*
  CMD  ["/bin/bash"]
  CMD  ["/bin/bash"]
</syntaxhighlight>


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

Version vom 19. November 2026, 07:39 Uhr

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

Beispiel

Einführungsbeispiel

Minimales 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

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)