Docker/Grundlagen/03 Containerinteraktion

Aus Foxwiki
Wechseln zu:Navigation, Suche


Docker/Grundlagen/03 Containerinteraktion


Docker Containerinteraktion


Beschreibung

Container interaktiv verwenden

Der hello-world-Container wurde einmal ausgeführt, nach der Ausgabe einiger Textzeilen wieder endet

  • Viele Container können interaktiv genutzt werden

Gut geeignet für erste Experimente sind die offiziellen Base-Images von gängigen Linux-Distributionen

  • Alpine
  • CentOS
  • Debian
  • Fedora
  • openSUSE
  • Oracle Linux
  • Ubuntu, …

Die Bezeichnung Base-Image rührt daher, dass diese Images als Startpunkt für eigene Entwicklungen gedacht sind

  • Wenn Sie also z. B. einen Container für einen Webserver zusammensetzen möchten, beginnen Sie mit dem Base-Image Ihrer Wunschdistribution und installieren darin Apache
  • Aus Docker-Sicht ist dann nicht ein vollkommen neues Image erforderlich, sondern das Base-Image kann um ein (vergleichsweise kleines) Image mit Ihren Erweiterungen ergänzt werden

Ubuntu-Image

Für die folgenden Beispiele verwenden wir das Ubuntu-Image als Ausgangspunkt

Versionen

Vom Ubuntu-Image gibt es mehrere Versionen

docker run -it ubuntu

Installiert die Version, die Docker mit dem Attribut latest ausgestattet hat

  • In der Regel ist das die gerade aktuelle LTS-Version
  • Wenn Sie davon abweichend eine andere Version wünschen, müssen Sie sie explizit angeben, also z. B. 
docker run -it ubuntu:23.04

Informationen zur Konfiguration dieses Docker-Images können Sie hier nachlesen:

Optionen

Die Optionen -i und -t beschreiben die Funktion des run-Kommandos weiter

  • -i bedeutet, dass der Container interaktiv ausgeführt und mit der Standardeingabe verbunden werden soll
  • Wegen -t verwendet Docker einen Pseudo-Terminal-Emulator (Pseudo-TTY) und verbindet ihn mit der Standardeingabe

Die Kombination dieser beiden Optionen ist erforderlich, wenn ein Container in einem Terminal-Fenster interaktiv bedient werden soll

  • In der Regel wird -i und -t zu -it abgekürzt

Mit dem folgenden Kommando wird also das gerade aktuelle Ubuntu-LTS-Image heruntergeladen, ein darauf aufbauender Container erzeugt und schließlich ausgeführt

  • Sie landen dabei automatisch in einer Instanz der unter Ubuntu üblichen Shell bash, in der Sie nun Kommandos mit root-Rechten ausführen können:
docker run -it ubuntu
root@f8fec4640176:/# cat/etc/os-release
NAME =" Ubuntu "
VERSION ="22.04.2 LTS (Jammy Jellyfish) "
...
root@f8fec4640176:/# df -h -x tmpfs
Filesystem             Size Used Avail Use % Mounted on
overlay                20 G  11 G 7.6 G 59% /
root@f8fec4640176:/# ps ax
PID TTY             STAT     TIME COMMAND
  1 ?               Ss       0:00 /bin/bash
 11 ?               R+       0:00 ps ax
root@f8fec4640176:/# exit
Erläuterungen
Befehl Beschreibung
f8fec4640176 ist ein zufällig generierter Host-Name, den Docker dem Container zugewiesen hat
cat /etc/os-release gibt Informationen über die Distribution aus, die als Basis für den Container dient
df -h listet auf, wie viel Platz in den Dateisystemen des Containers frei ist

Die Ergebnisse hängen vom Docker-Host ab

  • Unter Linux wird das gesamte Dateisystem, in dem sich das Verzeichnis /var/lib/docker befindet, mit den Docker-Containern geteilt
  • Unter macOS und Windows ist für alle Container zusammen ein limitierter Speicher vorgesehen
    • in der Regel ca. 60 GByte
  • -x tmpfs verbigt alle temporären Dateisysteme, die nicht hier von Interesse sind
ps ax liefert eine Liste aller laufenden Prozesse

Beachten Sie, dass im Container

  • im Gegensatz zu einer gewöhnlichen virtuellen Maschine
  • keine anderen Prozesse laufen
    • SSH-Server, kein Cron-Dämon, kein systemd-Dämon, kein Logging-Dienst, nichts!
exit Beendet die Ausführung des Containers
  • Alle weiteren Kommandos gelten dann wieder im Host-Bestriebsystem

Image-Namen

Image-Namen von Containern setzen sich aus bis zu vier Teilen zusammen:

 registry/quelle/imagename:tag
Beschreibung
Teil Beschreibung
registry gibt an, in welcher Registry das Image gespeichert ist
  • Die Angabe entfällt häufig
  • docker greift dann automatisch auf den Docker Hub zurück
quelle Name der Organisation, die das Image zusammengestellt und in den Docker Hub bzw. in eine andere Image-Registry hochgeladen hat
  • Entfällt die Angabe der Quelle, nimmt das docker-Kommando an, dass Sie eines der offiziellen Images der Firma Docker meinen
imagename gibt erwartungsgemäß den Namen des Images an
tag Sofern es von dem Image mehrere Versionen gibt, wählt die optionale Angabe von tag explizit das mit diesem Tag gekennzeichnete Image aus
  • Entfällt die Versionsangabe, entscheidet sich docker für das mit latest gekennzeichnete Image

Update

Wenn Sie das Kommando docker run -it ubuntu nach ein paar Monaten wiederholen, kommt weiterhin das beim ersten Versuch heruntergeladene Ubuntu-Image zum Einsatz – selbst dann, wenn es längst eine neue Version gibt

Den Download einer aktuelleren Image-Version müssen Sie bei Bedarf mit dem Subkommando image pull selbst anstoßen

docker image pull ubuntu
Using default tag:latest
latest : Pulling from library/ubuntu
...

Distributionen

Ubuntu versus Alpine Linux versus andere Distributionen

Ubuntu zählt im Desktop- und Serverbereich zu den populärsten Linux-Distributionen

  • Das macht Ubuntu aber nicht zum idealen Startpunkt für Docker!
  • Der Hauptnachteil von Ubuntu besteht darin, dass es sich sogar in der Minimalform um eine relativ umfangreiche Distribution handelt
  • Unter Docker sind schlanke Distributionen vorzuziehen
  • Besonders beliebt ist in der Docker-Welt deswegen Alpine Linux, etwa als Basis für Images mit einem Webserver oder einer Programmiersprache
  • Eine Einführung in Alpine Linux siehe Alpine Linux

Netzwerkanbindung

Mit hostname -I können Sie die IP-Adresse des Containers ermitteln

  • Docker verwendet standardmäßig 172.17.0.2

ip addr und ping

Die vertrauten Kommandos ip addr und ping funktionieren innerhalb des Ubuntu-Containers nicht, weil sie aus Platzgründen nicht im Image enthalten sind

apt update && apt install -y iproute2 iputils-ping
ip addr
 1: lo : ...
 inet 127.0.0.1/8 scope host lo
 41: eth0@if42 : ...
 inet 172.17.0.2/16 scope global eth0

zeigt, dass die Netzwerkanbindung in ein privates Netzwerk führt, das Docker standardmäßig zur Verfügung stellt

IP-Adressen

Docker weist den Containern beim Start eindeutige IP-Adressen in diesem Netzwerk zu

  • Anders als bei virtuellen Maschinen kommt dabei allerdings nicht DHCP zum Einsatz

ping beweist, dass die Container auch auf das Internet zugreifen können (andernfalls hätte vorhin auch apt update nicht funktioniert)

 ping -c 1 google.de
 PING google .de (142.250.186.35) 56(84) bytes of data .
 64 bytes from fra24s04-in-f3.1e100.net (142.250.186.35):
 ...
 1 packets transmitted , 1 received , 0% packet loss , time 0 ms
 rtt min/avg/max/mdev = 19.221/19.221/19.221/0.000ms
ping-Problem

Wenn Sie Rootless Docker verwenden, funktioniert ping bei manchen Host-Distributionen nicht

Um zu testen, ob eine Internetverbindung zu einem bekannten Webserver möglich ist, können Sie stattdessen

wget <hostname>

oder

curl <hostname>

verwenden

Damit laden Sie die Startseite der jeweiligen Website herunter (oft index.html)

Container versus Images

Jetzt ist es an der Zeit, ein wenig mit dem Kommando docker zu experimentieren, damit Sie den Unterschied zwischen einem Image und seinen Containern verstehen lernen

  • Wenn Sie den Ubuntu-Container mit (Strg)+(D) oder exit verlassen und dann mit docker run neuerlich starten, wird Ihnen vielleicht auffallen, dass der Container einen neuen Host-Namen erhalten hat

Versuchen Sie nun, mit touch eine neue Datei anzulegen

  • Beenden Sie den Container, führen Sie erneut docker run aus, und suchen Sie nach der Datei
  • Sie werden sie nicht finden
  • Kann Docker Veränderungen am Dateisystem nicht konsistent speichern?
docker run -it ubuntu
root@168a2ec648f0:/# touch abc
root@168a2ec648f0:/# exit
docker run -it ubuntu
root@26a4a5f5b281:/# ls -l abc
ls: cannot access 'abc': No such file or directory
docker run

Ein wenig klarer wird die Sache, wenn Sie ausprobieren, docker run in mehreren Terminalfenstern parallel auszuführen

  • Das ist kein Problem für Docker!
  • Der Grund für dieses auf den ersten Blick merkwürdige Verhalten besteht darin, dass Docker jedes Mal, wenn Sie docker run imagename ausführen, einen neuen Container für dieses Image erzeugt!
  • Jeder Container erhält automatisch eine zufällige UID, deren Kurzform sich im Host- Namen widerspiegelt, sowie ein eigenes Dateisystem
  • Genau genommen wird über das Read-only-Dateisystem des Images ein Read-Write-Dateisystem des Containers gelegt – Docker/Interna
docker ps -a | grep ubuntu
CONTAINER ID IMAGE     STATUS                                  NAMES
26a4a5f5b281 ubuntu    Exited (2) 6 seconds ago                wizardly_...
168a2ec648f0 ubuntu    Exited (0) 6 minutes ago                musing_kilby
f8fec4640176 ubuntu    Up 36 minutes                           naughty_ borg
docker start
Container mit docker start erneut ausführen

Um einen vorhandenen Container später weiterzuverwenden, müssen Sie ab dem zweiten Start explizit angeben, welchen Container Sie meinen

  • Dabei können Sie wahlweise die zufällige Container-ID oder den ebenso zufälligen, aber leichter zu merkenden Container-Namen verwenden (siehe das Ergebnis von docker ps -a)

Beachten Sie, dass Sie zum neuerlichen Start eines bereits vorhandenen Containers docker start verwenden müssen, nicht docker run!

  • Damit Sie den Container interaktiv verwenden können, müssen Sie wieder die Option -i angeben.
  • -t ist hingegen nicht zulässig

Die meisten Optionen, die Sie beim Erzeugen eines Containers mit docker run angeben, werden dauerhaft im Container gespeichert

  • -i zählt zu den Ausnahmen

Dafür benötigen Sie bei Podman zusätzlich die Option -a, was zusammen mit -i zu -ai abgekürzt werden kann

  • Die Option -a bewirkt, dass die Standardeingabe und -ausgabe des Containers mit der des Terminals verbunden wird
  • Bei Docker ist dies bei docker -i start automatisch der Fall; die zusätzliche Option -a stört aber nicht

Die folgenden zwei Beispiele zeigen, dass Docker die Datei abc gespeichert hat

  • Entscheidend ist nur, dass Sie beim nächsten Start die richtige Container-ID bzw. den Container-Namen angeben
docker start -ai musing_kilby
root@168a2ec648f0:/# ls -l abc
-rw -r - -r - -. 1 root root 0 Mar 10 15:27 abc
root@168a2ec648f0:/# exit
docker start -ai 168a2ec648f0
root@168a2ec648f0:/# ls -l abc
-rw -r - -r - -. 1 root root 0 Mar 10 15:27 abc
root@168a2ec648f0:/# exit
Autovervollständigung

Bei der Eingabe von docker start können Sie die Container-ID bzw. den Namen des Containers unter Umständen mit (TAB) vervollständigen

  • Diese Funktion steht allerdings nur unter Linux und macOS zur Verfügung
Eigene Container-Namen

Die zufälligen Container-Namen sind zwar handlicher als die IDs, noch besser ist es aber, Containern eigene Namen zuzuordnen

Dazu geben Sie, wenn Sie den Container mit dem Kommando docker run erzeugen, mit --name den gewünschten Namen an

  • Optional können Sie dem Container bei dieser Gelegenheit auch gleich mit -h einen Host-Namen zuweisen
  • Dieser kann, muss aber nicht mit dem Container-Namen übereinstimmen
docker run -it --name myubuntu -h myubuntu ubuntu
root@myubuntu :/# ...
root@myubuntu :/# exit

Um den Container später wieder zu starten, können Sie jetzt myubuntu anstelle von hexadezimalen Codes oder verwirrenden Namenszusammensetzungen verwenden:

docker start -ai myubuntu
Optionen mit ein und zwei Bindestrichen

Beim vorigen Kommando docker run gibt es Optionen mit einem Bindestrich (-h) und solche mit zwei Bindestrichen (--name)

Traditionell ist es bei Linux-Kommandos üblich, die meisten Optionen in zwei Varianten anzugeben:

  • Als Kurzschreibweise mit einem Buchstaben und einem vorangestellten Bindestrich, und in einer Variante mit ausführlichen Optionsnamen und zwei Bindestrichen
  • Anstelle von -h wäre auch --hostname zulässig
  • Wir ziehen in diesem Buch aus Platzgründen zumeist die Kurzschreibweise vor
  • Für --name gibt es allerdings keine Kurzschreibweise
  • Diese Option muss in der Langform übergeben werden

Ein Sonderfall -it

  • Hierbei handelt es sich um zwei kurze Optionen, die kombiniert wurden
  • -it ist also eine Abkürzung für -i -t
  • Ebenso wäre -abc eine Kurzform für -a -b -c

Eine vollständige Referenz aller Optionen für ein bestimmtes Kommando erhalten Sie unter macOS und Linux mit man, wobei Sie das Haupt- und das Subkommando in zwei Parametern übergeben können

Den Hilfetext zu docker run können

man docker run lesen

Windows-Nutzer müssen stattdessen die Dokumentation im Online-Handbuch suchen

docker exec

Prozesse mit docker exec ausführen

Parallel weitere Prozesse mit docker exec ausführen

Häufig wird in einem Docker-Container nur ein Prozess ausgeführt – sei es eine interaktive Shell im Vordergrund wie in den vorigen Beispielen, sei es ein Serverdienst im Hintergrund

  • docker exec ermöglicht, parallel zu einem laufenden Container beliebige weitere Prozesse zu starten
  • docker exec ist primär zum Debugging gedacht, kann aber universell eingesetzt werden

Das folgende Kommando, das in einem zweiten Terminal- oder PowerShell-Fenster auszuführen ist, startet parallel zum bereits laufenden myubuntu -Container das Kommando top

Es wird ausgeführt, bis es durch (Q) beendet wird

docker exec -it myubuntu/usr/bin/top

Sie können auch mehrere Shell-Sessions parallel ausführen:

docker exec -it myubuntu/bin/bash
Aufräumen

Vermutlich sind vom Experimentieren jetzt diverse Ubuntu-Container übrig geblieben

Überblick über alle Container

docker ps -a 

Alle betreffenden Container löschen

docker rm <name1> <name2> 

Docker/Grundlagen/Administration zeigen, wie unter macOS und Linux mit einem einzigen Kommando sämtliche Container gelöscht werden können, die ein bestimmtes Image nutzen

docker image rm

Prinzipiell könnten Sie nun mit docker image rm ubuntu auch das Ubuntu-Image löschen

  • Es ist aber möglich, dass Sie dieses Image später noch benötigen werden
  • Wenn Sie jetzt auf das Löschen verzichten, ersparen Sie sich dann einen neuerlichen Download