Diskussion:Docker/Image/Definition: Unterschied zwischen den Versionen
Die Seite wurde neu angelegt: „== 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, sogenann…“ |
|||
| (Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
== Beispiel: Pandocund LaTeX-Umgebung als Image einrichten == | == Beispiel: Pandocund LaTeX-Umgebung als Image einrichten == | ||
Als letztes Beispiel in diesem Kapitel zeigen wir Ihnen das Dockerfile für unsere Arbeitsumgebung | Als letztes Beispiel in diesem Kapitel zeigen wir Ihnen das Dockerfile für unsere Arbeitsumgebung | ||
Aktuelle Version vom 19. November 2026, 21:32 Uhr
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