Docker/Image/Upload: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
Docker/Image/Definition/Upload
'''Docker/Image/Definition/04 Upload'''


== Images in den Docker Hub hochladen ==
== Images in den Docker Hub hochladen ==
Zeile 5: Zeile 5:
* Sofern Sie sich für einen Free-Account entscheiden, müssen Sie dazu lediglich einen Accountnamen, eine E-Mail-Adresse und ein Passwort angeben
* 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:
Login Nach dem Anklicken der Bestätigungsmail melden Sie sich auf Ihrem Docker-Host mit docker login an:
 
  docker login
  docker login
  Login with your Docker ID to push and pull images from
  Login with your Docker ID to push and pull images from
   Docker Hub  
   Docker Hub  
  Username : accountna m e
  Username : accountname
  Password : geheim
  Password : geheim
  Login Succeede d
  Login Succeeded
  WARNING ! Your password will be stored unencrypted in
  WARNING ! Your password will be stored unencrypted in /home/<name>/docker/config.json  
/home/<name >/
Configure a credential helper to remove this warning  
* 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  
Unter Linux speichert ''docker login'' den Accountnamen und das Passwort in einer mit dem Verfahren Base64 codierten Zeichenkette in der Datei  
Zeile 24: Zeile 19:


Das entsprechende Kommando sieht so aus:
Das entsprechende Kommando sieht so aus:
  echo -n '<accountname >: <password > ' | base64
  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:
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  
  podman login docker.io
* io
  Username: userinfo
  Username : userinf o
  Password: **********
  Password : ********* *
  Login Succeeded!
  Login Succeede d !


podman login verwendet als Speicherort ${XDG_RUNTIME_DIR}/containers/auth.json
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
Die Variable XDG_RUNTIME_DIR verweist normalerweise auf ein Verzeichnis, das im Arbeitsspeicher abgebildet wird (z.&nbsp;B.&nbsp; /run/user/1000), also mit jedem Reboot verloren geht
* 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)
* 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
; 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
* 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
* Docker empfiehlt, aus Sicherheitsgründen einen Credential Helper zu verwenden
Zeile 54: Zeile 48:
Unter macOS oder unter Windows führen Sie den Login am einfachsten in Docker Desktop aus
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
* 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
* config.json enthält in diesem Fall nur einen Eintrag, der auf den Speicherort hinweist, z.&nbsp;B.&nbsp;"credsStore":"osxkeychain"
* B."credsStore":"osxkeychain"


; push-Kommando Nachdem Sie das Image lokal getestet haben, können Sie es zur öffentlichen Verteilung hochladen:
; push-Kommando
Nachdem Sie das Image lokal getestet haben, können Sie es zur öffentlichen Verteilung hochladen:
docker push accountname/imagename


docker push accountna m e/imagename
; Image-Beschreibung
 
Nach dem erfolgreichen Upload finden Sie das Image im Docker Hub
; 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
* 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
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
* 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!)
* 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
; 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
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:
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 build -t account/image : tag
  docker tag account/image [: oldtag ] account/image : newtag
  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,
; Hochgeladene Images löschen
wechseln Sie in das Dialogblatt Tags, markieren die nicht mehr benötigten Images und führen Actions • Delete aus
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)
* Im Dialogblatt Settings besteht außerdem die Möglichkeit, das gesamte Projekt (die Weboberfläche spricht von einem Repository)
zu löschen
zu löschen

Version vom 21. November 2026, 12:01 Uhr

Docker/Image/Definition/04 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 : accountname
Password : geheim
Login Succeeded
WARNING ! Your password will be stored unencrypted in /home/<name>/docker/config.json 
Configure a credential 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: userinfo
Password: **********
Login Succeeded!

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 accountname/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