Behebung von 'docker: invalid reference format.'

Problem:

Du möchtest einen Docker-Container starten, siehst aber eine Fehlermeldung wie diese:

docker: invalid reference format.

Lösung

Docker teilt dir mit, dass die Syntax des Docker-Image-Namens (& Version) falsch ist. Beachte, dass dies nicht dasselbe ist wie Docker, das das Image nicht in der Registry finden kann. Docker wird nicht einmal in der Lage sein, das Image in der Registry nachzuschlagen, wenn du einen invalid reference format-Fehler siehst!

Häufige Ursachen sind:

• Du hast einen Doppelpunkt am Ende des Image-Namens verwendet, z.B. ubuntu: — entferne den Doppelpunkt; nur ubuntu zu verwenden verweist auf ubuntu:latest
• Du hast einen Bindestrich am Ende des Image-Namens verwendet, z.B. ubuntu- — entferne den Bindestrich; nur ubuntu zu verwenden verweist auf ubuntu:latest
• Du hast Variablen wie ubuntu:$VERSION verwendet, aber $VERSION ist nicht gesetzt. Stelle sicher, dass du $VERSION auf einen entsprechenden (nicht-leeren) Wert wie latest oder 18.04 gesetzt hast!
• Du hast mehrere Doppelpunkte wie ubuntu:18.04:2 oder ubuntu:ubuntu:18.04 verwendet. Verwende nur einen einzigen Doppelpunkt im Image-Namen!
• Du hast die Reihenfolge der Befehlszeilenargumente vertauscht, sodass ein anderes Argument als Image-Name interpretiert wird. Prüfe die Syntax deines docker-Befehls, z.B. docker run, und vergleiche einige Beispiele mit deinem Befehl.