Docker/pull

docker pull (oder docker image pull) – Befehl des Docker-Clients, der das angegebene Image aus dem Container-Register in den lokalen Speicher lädt.

Beschreibung

docker pull lädt das Container-Image aus dem Register in den lokalen Cache unter dem Namen, Tag oder Digest

• Standardmäßig ist die Quelle Docker Hub (docker.io).
• Ohne Tag wird :latest verwendet.
• Für private Register ist eine Authentifizierung erforderlich (docker login).
• Sie können digest: name@sha256:<digest> für eine exakte Übereinstimmung angeben.
• Es werden nur fehlende Layer heruntergeladen.
• Die Integrität wird anhand von Hashes überprüft.

Verwendung des Befehls

docker image pull [OPTIONS] NAME[:TAG|@DIGEST]

Image per Tag ziehen

Ohne Tag wird standardmäßig das Image :latest geladen.

docker pull ubuntu

• Sie können eine bestimmte Version angeben.

docker pull ubuntu:24.04

• Das Tag ist für den Menschen bequem zu verwenden, kann jedoch im CI/CD-Prozess schwanken.

• Für eine genaue Reproduzierbarkeit der Version ist es besser, das Image anhand des Digests herunterzuladen.

Image per Digest ziehen

• Um den Digest eines bestimmten Images zu erfahren, muss das Image heruntergeladen werden:

docker pull ubuntu:24.04

• Um den Digest eines bestimmten Images zu erfahren, muss das Image heruntergeladen werden:

$ docker pull ubuntu:24.04

24.04: Pulling from library/ubuntu
125a6e411906: Pull complete
Digest: sha256:2e863c44b718727c860746568e1d54afd13b2fa71b160f5cd9058fc436217b30
Status: Downloaded newer image for ubuntu:24.04
docker.io/library/ubuntu:24.04

• Docker gibt beim Pushen in eine Registry auch den Digest eines Images aus.
• Eine weitere Möglichkeit, einen Image-Digest zu erhalten, ist die Verwendung von inspect:

docker buildx imagetools inspect nginx:1.27 | grep "Digest"

Digest:    sha256:66460d557b25769b102175144d538d88219c077c678a49af4afca6fbfc1b5252

Installation

<syntaxhighlight lang="bash" highlight="1" line copy> < /syntaxhighlight>

Aufruf

<syntaxhighlight lang="bash" highlight="1" line copy> < /syntaxhighlight>

Optionen

Unix	GNU	Parameter	Beschreibung

---