Docker/Image/Definition/01 Image erstellen

Aus Foxwiki
Wechseln zu:Navigation, Suche

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

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)