Multi-Arch-Images
Mit Docker oder Podman erzeugte Images werden grundsätzlich nur für die CPU- Plattform gebaut, unter der Sie arbeiten
- Wenn Sie also ein Notebook mit Inteloder AMD-CPU verwenden, funktioniert ein von Ihnen erzeugtes Image nur für andere Rechner mit der gleichen CPU-Architektur
- Freunde des Raspberry Pi oder Anwender von MacBooks mit Apple Silicon (M1, M2 usw.) gehen leer aus
Erfreulicherweise besteht die Möglichkeit, sogenannte Multi-Arch-Images zu erzeugen, die kompatibel mit mehreren CPU-Architekturen sind
- Dazu brauchen Sie nicht einmal Rechner in allen betreffenden Architekturen
- Sie können also ein Image für ARM-CPUs erzeugen, auch wenn Ihr eigener Rechner mit einer x86-64-CPU läuft
- Sehr wohl vorausgesetzt wird dagegen, dass die von Ihnen eingesetzten Basis-Images (in den bisherigen Beispielen dieses Kapitels also ubuntu:22.04) für die richtigen Plattformen im Docker Hub oder in der Registry Ihrer Wahl zur Verfügung stehen
Multi-Arch-Builds werden sowohl von Docker als auch von Podman unterstützt Allerdings gibt es im Detail kleine Unterschiede, weswegen wir die erforderlichen Kommandos in zwei getrennten Abschnitten erläutern
- Multi-Arch-Builds mit Docker Um ein Multi-Arch-Image zu erzeugen, gehen Sie zuerst einmal so vor, wie wir das in den vorigen Abschnitten erläutert haben
- Sie stellen also das Dockerfile zusammen,
testen Ihr Image auf Ihrer Standard-Plattform und laden es in den Docker Hub hoch Erst wenn alles zufriedenstellend funktioniert, führen Sie den relativ zeitaufwendigen Multi-Arch-Build durch
- Dieser gelingt mit zwei erfreulich kurzen Kommandos:
docker buildx create --name multiarc h --driver docker - container \ --use
docker buildx build --push \ --platform linux/arm/v7, linux/arm64/v8, linux/amd64 \ -t userin fo/testwebs er v e r
Die obigen Kommandos erfordern ein paar Erläuterungen:
Multi-Arch-Builds sind ein Feature des neuen buildx -Systems
- Während docker build und docker buildx bei aktuellen Docker-Versionen aus Kompatibilitätsgründen für Grundfunktionen gleichwertig sind, müssen Sie jetzt explizit angeben,
dass Sie sich auf buildx beziehen docker buildx create erzeugt eine neue Builder-Instanz, die anstelle des gewöhnlichen, in den Docker-Dämon integrierten Standardtreibers den Treiber docker-container aus dem buildx-System verwendet. (Andere unterstützte Treiber sind kubernetes und remote.) Aufgrund der Option --use wird die neue Instanz von nun an standardmäßig für alle buildx -Kommandos verwendet
- Das erste Kommando muss daher nur einmalig ausgeführt werden
docker buildx build erzeugt die Images
- Wichtig ist dabei die Option --push, die die neuen Images gleich in den Docker Hub hochlädt
- Andernfalls bleiben die Images in einem lokalen Build Cache
- Ein nachträgliches Hochladen ist nicht vorgesehen
Mit --platform übergeben Sie die Liste der gewünschten Plattformen
- Ganz egal,
ob Sie unter Windows, Linux oder macOS arbeiten – der Plattformname beginnt immer mit linux
- Die Images verwenden also ein Linux-System als Basis, wie dies bei allen Beispielen in diesem Buch der Fall ist
– linux/amd64 bezieht sich auf 64-Bit-CPUs von Intel und AMD – linux/arm/v7 ist die üblicherweise auf dem Raspberry Pi eingesetzte 32-Bit- Architektur
- Aktuelle Modelle des Raspberry Pi haben zwar einen 64-Bit-CPU,
standardmäßig verwendet Raspberry Pi OS aber immer noch einen 32-Bit- Kernel, um eine größtmögliche Kompatibilität über alle Modelle zu erzielen – linux/arm64/v8 ist kompatibel mit Apple Silicon, also mit den CPUs M1, M2 usw Der Build-Prozess dauert spürbar länger als üblich, weil der Code für alle Plattformen außer der des Host-Rechners emuliert werden muss Sie können sich in der Folge auf der Website des Docker Hubs im Dialogblatt Tags Ihres Projekts davon überzeugen, dass Build und Upload auf allen Plattformen funktioniert haben (siehe Abbildung 4.3)
- Idealerweise sollten Sie die Images nun auf Testrechnern für alle Plattformen ausprobieren
Abbildung 4.3 Das Test-Image kann für drei CPU-Plattformen vom Docker Hub heruntergeladen werden
Multi-Arch-Builds mit Podman Multi-Arch-Builds sind im gewöhnlichen Build-System von Podman integriert
- Es gibt keine buildx-Variante
- Sie führen also einfach podman build aus und können darauf verzichten, eine spezielle Build-Instanz einzurichten
- docker buildx create entfällt
Allerdings fehlt bei podman build die Option --push
- Einfach podman build und dann podman push auszuführen, ist leider auch nicht zielführend: Dann lädt podman das Image nur für eine Platform hoch (das zuletzt erzeugte Image)
Der Ausweg besteht darin, podman build mit der Option --manifest aufzufordern, die Build-Informationen in einem sogenannten Manifest zu speichern
- Ein Manifest ist keine Datei, sondern ein Podman-Objekt, das im JSON-Format die Layer eines Images beschreibt, gegebenenfalls für mehrere Architekturen
- Es kann mit podman manifest inspect angesehen werden
- Manifest-Objekte gibt es auch in Docker, aber Sie müssen sich damit nur in Ausnahmefällen auseinandersetzen
- In der Folge können Sie mit podman manifest push sämtliche im Manifest enthaltenen Images hochladen
Damit werden aus docker buildx build --push unter Podman die beiden folgenden Kommandos:
podman build \ --platform linux/arm/v7, linux/arm64/v8, linux/amd64 \ --manifest testwebse r v er
- manifest \
-t userin fo/testwebs er v e r
podman manifest push testwebs e rv e r
- manifest \
userin f o/testwebse r v er
Beispiel: Pandocund LaTeX-Umgebung als Image einrichten
Als letztes Beispiel in diesem Kapitel zeigen wir Ihnen das Dockerfile für unsere Arbeitsumgebung
- Wir haben dieses Buch in der Markdown-Syntax verfasst
- Das Kommando pandoc sowie eine ganze Sammlung selbst gebastelter Scripts erzeugen daraus eine HTML-Version (für die E-Book-Ausgaben) sowie LaTeX-Dateien, aus denen in weiterer Folge PDFs für den Druck des Buchs generiert werden
Dieses Setup hat für uns Autoren den Vorteil, dass wir jeweils unseren Lieblingseditor verwenden können und uns nicht mit Word ärgern müssen
- Es hat aber den Nachteil,
dass es ausgesprochen mühsam ist, manuell die Fülle an Werkzeugen einzurichten, die zur Generierung einer fertigen PDF-Datei notwendig sind Glücklicherweise lässt sich dieses Problem mit Docker ganz elegant umschiffen
- Ein vergleichsweise winziges Dockerfile reicht aus, um ein Image zu bauen, das alle erforderlichen Programme enthält
- Die Erläuterungen folgen im Anschluss an das Listing
- Sorry, unvollständige Beispieldateien Zu diesem Beispiel gibt es nur unvollständige Beispieldateien zum Download
- Die mit dem Beispiel verbundenen Fonts können nicht weitergegeben werden, und auch sonst erfüllt dieses Beispiel eher didaktische Funktionen
- Obwohl der praktische Nutzen für uns Autoren groß ist, wird dies für die meisten Leser nicht zutreffen
# Datei Dockerfi l e FROM ubuntu :22.04
# Pakete installieren, Zeitzone einstell e n ( vermeide t # interakt i v e R ü ckfrage ) ENV TZ =" Europe/Berlin" RUN ln -snf/usr/share/zoneinfo/$TZ/etc/localtime && \ echo $TZ >/etc/timezone && \ apt -get update -y && \ apt -get install -y -o Acquire :: Retries =10 \ --no - install - recommen ds \
texlive -latex - recommen d e d \ texlive -latex - extra \ texlive -fonts - recommen d e d \ texlive -lang -german \ texlive -pstricks \ texlive -fonts - extra \ imagemagi c k \ unzip \ python3 \ ghostscri p t \ locales \ vim \ curl \ wget \ ca - certific a te s \ less && \ apt -get clean && \ rm -rf/var/lib/apt/lists/*
# Pandoc installi e re n ARG TARGETAR C H RUN if [" $TARGETA RC H" =" amd64" ]; then \ curl -L https ://github
- com/jgm/pandoc/releases/download/\
3.1.3/pandoc -3.1.3 -1 - amd64
- deb \
-o/tmp/pandoc
- deb && \
dpkg -i/tmp/pandoc
- deb && \
rm/tmp/pandoc
- deb ; \
elif [" $TARGETAR C H" =" arm64" ]; then \ curl -L https ://github
- com/jgm/pandoc/releases/download/\
3.1.3/pandoc -3.1.3 -1 - arm64
- deb \
-o/tmp/pandoc
- deb && \
dpkg -i/tmp/pandoc
- deb && \
rm/tmp/pandoc
- deb ; \
fi
# Fonts installi e r en ADD myfonts
- tgz/usr/local/share/texmf
RUN texhash
# Volume/data, bei docker run mit dem Arbeitsv e rz e i c h ni s # verbinden, also : docker run -v $ ( pwd ) :/data # Fedora, RHEL : docker run -v $ ( pwd ) :/data : z VOLUME ["/data"]
# Startkom m a n do ENTRYPOIN T ["/bin/bash"]
- Installationsarbeiten Als Ausgangspunkt haben wir wieder Ubuntu verwendet
- Der erste Schritt im obigen Dockerfile besteht nun darin, diverse Pakete zu installieren und die Zeitzone einzustellen
- Damit das Dockerfile gut lesbar bleibt, ist es empfehlenswert, die erforderlichen Pakete zeilenweise anzugeben
Im nächsten Schritt wird Pandoc als fertiges Paket heruntergeladen und mit dpkg installiert. (Pandoc wird auch in den Ubuntu-Paketquellen angeboten, allerdings ist die dort befindliche Version selten aktuell.) Damit der Download unter beiden für uns relevanten Architekturen funktioniert, richten wir mit ARG TARGETARCH eine Variable ein, die die aktive CPU-Plattform des Host-Rechners enthält
- Diese Variable wird im folgenden, leider ein wenig unübersichtlichen Code ausgewertet
- Beachten Sie, dass die Download-URLs im Listing aus Platzgründen auf jeweils zwei Zeilen verteilt sind
Im Dockerfile handelt es sich jeweils um eine lange Zeile Zuletzt werden diverse Schriften so installiert, dass verschiedene LaTeX-Kommandos sowie dvips darauf zugreifen können
- ADD packt das Archiv automatisch aus
- Anschlie- ßend muss mit RUN das Kommando texhash ausgeführt werden
- Auf diese Weise wird ein Datei-Index aktualisiert, damit LaTeX und Co
- die Fonts finden können
- Arbeitsverzeichnis und Volume Die vom Image abgeleiteten Container sollen Zugriff auf ein lokales Arbeitsverzeichnis haben
- Innerhalb des Images dient dabei/data als Arbeitsverzeichnis
- Es ist nach dem Start eines Containers automatisch das aktive Verzeichnis
- Nach außen hin erfolgt die Verbindung über ein Volume (siehe auch das folgende Kommando docker run)
Da das Image nicht ein Kommando, sondern eine Menge enthält (latex, pandoc, dvips, ps2pdf usw.), ist es nicht zweckmäßig, eines dieser Kommandos per Default zu bevorzugen
- Vielmehr macht ENTRYPOINT die bash zum Defaultkommando
- Image erzeugen Um das Image in der auf Ihrem Rechner aktiven CPU-Plattform zu erzeugen, wechseln Sie in das Verzeichnis, in dem sich das Dockerfile und das Font-Archiv befinden,
und führen dort docker build aus
- Mit -t geben Sie dem Image einen Namen, den Sie frei wählen können:
docker build . -t pandoc_al l
Beachten Sie, dass der Build-Prozess wegen der umfangreichen Downloads und Installationsarbeiten ca. 10 Minuten dauert
- Das resultierende Image ist mit ca. 2, 1 GByte riesig und insofern kein Beispiel für einen schlanken Container-Service
- Tipps zur Entwicklung eigener Dockerfiles Bei kleinen Images funktioniert der Entwicklungsversuch nach der Methode Versuch und Irrtum gut
- Wenn das Erzeugen eines Images aber wie in diesem Beispiel länger dauert, ist es ärgerlich, wenn am Ende dieses Prozesses ein Fehler auftritt
Wir sind so vorgegangen, dass wir die Grundfunktionen sowie die auszuführenden Kommandos zuerst manuell in einem Ubuntu-Container getestet haben
- Die Installationskommandos, die sich dort bewährt haben, haben wir dann in das Dockerfile übernommen
- Container ausführen Um das Image auszuprobieren, wechseln Sie in das Verzeichnis, in dem sich die Markdown-Dateien befinden, und erzeugen einen davon abgeleiteten Container
Dabei wird das aktuelle Verzeichnis mit dem Volume/data verbunden
- Der Container erhält den Namen mypandoc
cd <verzeichnis - mit - markdown - dateien > docker run -it -v $( pwd ) :/data --name mypandoc \ -h mypandoc pandoc_al l
# pandoc --version pandoc 3.1.3
Falls Sie einen Container in mehreren Terminals oder Terminal-Tabs parallel verwenden möchten, verwenden Sie dazu ab dem zweiten Terminal docker exec:
docker exec -it mypandoc bash
Wenn Sie den Haupt-Container mit exit oder (Strg)+(D) verlassen und ihn dadurch beenden, können Sie ihn mit dem folgenden Befehl später jederzeit wieder starten Die Optionen -a und -i ermöglichen die interaktive Nutzung (entspricht -it bei docker run und docker exec)
docker start -ai mypandoc