Docker/Image/Definition/04 Upload

Aus Foxwiki
Version vom 19. November 2026, 07:55 Uhr von Dirkwagner (Diskussion | Beiträge) (Dirkwagner verschob die Seite Docker/Image/Eigene Images/04 Upload nach Docker/Image/Definition/04 Upload: Textersetzung - „Docker/Image/Eigene Images“ durch „Docker/Image/Definition“)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu:Navigation, Suche

Docker/Image/Definition/Upload

Images in den Docker Hub hochladen

Bevor Sie auf der Grundlage eines Dockerfiles ein Image erzeugen, sollten Sie auf der Website https://hub.docker.com einen Account einrichten

  • Sofern Sie sich für einen Free-Account entscheiden, müssen Sie dazu lediglich einen Accountnamen, eine E-Mail-Adresse und ein Passwort angeben
Login Nach dem Anklicken der Bestätigungsmail melden Sie sich auf Ihrem Docker-Host mit docker login an
docker login
Login with your Docker ID to push and pull images from
 Docker Hub 
Username : accountna m e
Password : geheim
Login Succeede d
WARNING ! Your password will be stored unencrypted in
/home/<name >/
  • docker/config
  • json
  • Configure a credentia l
helper to remove this warning 

Unter Linux speichert docker login den Accountnamen und das Passwort in einer mit dem Verfahren Base64 codierten Zeichenkette in der Datei

.docker/config.json

Das entsprechende Kommando sieht so aus:

echo -n '<accountname >: <password > ' | base64

Während sich docker login automatisch auf den Docker Hub bezieht, müssen Sie bei podman login die gewünschte Registry angeben:

podman login docker 
  • io
Username : userinf o
Password : ********* *
Login Succeede d !

podman login verwendet als Speicherort ${XDG_RUNTIME_DIR}/containers/auth.json Die Variable XDG_RUNTIME_DIR verweist normalerweise auf ein Verzeichnis, das im Arbeitsspeicher abgebildet wird (z

  • B./run/user/1000), also mit jedem Reboot verloren geht
  • Sie können mit der Option --authfile aber einen anderen Ort festlegen (siehe man podman login)

docker login warnt davor, das Passwort würde im Klartext gespeichert

  • Das trifft zwar nicht ganz zu, das Passwort kann aber auf jeden Fall trivial einfach mit base64 -d aus der Zeichenkette ermittelt werden
  • Docker empfiehlt, aus Sicherheitsgründen einen Credential Helper zu verwenden
  • Das ist einfacher gesagt als getan, weil sich hierfür unter Linux kein Verfahren oder Programm richtig etabliert hat. (Am ehesten können wir pass empfehlen, siehe https://www.passwordstore.org.)

Viel einfacher ist es, auf der Weboberfläche von https://docker.com in Ihren Accounteinstellungen im Dialogblatt Security ein Access Token zu generieren

In der Folge verwenden Sie dieses Token anstelle des Passworts für den Login:

docker login --username <accountname >
Password : <your - secret -token >

Damit wird in config.json anstelle des Passworts das Token gespeichert

  • Sollte eine fremde Person darauf Zugriff erhalten, ist dies weit weniger schlimm
  • Zur Not können Sie das Token auf der Docker-Weboberfläche löschen und so die seine weitere Verwendung blockieren

Unter macOS oder unter Windows führen Sie den Login am einfachsten in Docker Desktop aus

  • Die Authentifizierungsdaten werden in der Keychain oder im Credential Manager gespeichert
  • config.json enthält in diesem Fall nur einen Eintrag, der auf den Speicherort hinweist, z
  • B."credsStore":"osxkeychain"
push-Kommando Nachdem Sie das Image lokal getestet haben, können Sie es zur öffentlichen Verteilung hochladen
docker push accountna m e/imagename
Image-Beschreibung Nach dem erfolgreichen Upload finden Sie das Image im Docker Hub
  • Auf der Weboberfläche können Sie über den Button Manage Repository eine Kurzbeschreibung und eine README-Datei bearbeiten

Leider besteht keine Möglichkeit, diese Texte im Dockerfile anzugeben

  • Bei automatisierten Builds, bei denen Docker das Dockerfile und alle anderen Projektdaten von GitHub übernimmt, können Sie aber im Projektverzeichnis die Datei README.md vorsehen
  • Der Inhalt dieser Datei erscheint dann im Docker Hub als Full Description Ihres Images. (Bei lokalen Builds, wie wir sie hier beschrieben haben, funktioniert dieser Mechanismus aber nicht!)
Image-Tags Standardmäßig erhält das neueste mit docker build erzeugte Image das Tag latest

In diesem Fall überschreibt docker push das zuletzt so bezeichnete Image

Davon abweichende Tags können Sie wahlweise direkt bei der Ausführung von docker build oder mit docker tag setzen:

docker build -t account/image : tag
docker tag account/image [: oldtag ] account/image : newtag
Hochgeladene Images löschen Wenn Sie einmal in den Docker Hub hochgeladene Images wieder löschen möchten,

wechseln Sie in das Dialogblatt Tags, markieren die nicht mehr benötigten Images und führen Actions • Delete aus

  • Im Dialogblatt Settings besteht außerdem die Möglichkeit, das gesamte Projekt (die Weboberfläche spricht von einem Repository)

zu löschen