Docker/Image/Upload: Unterschied zwischen den Versionen
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: | |||
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 : | Username : accountname | ||
Password : geheim | Password : geheim | ||
Login | Login Succeeded | ||
WARNING ! Your password will be stored unencrypted in | 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 | 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 | ||
Username: userinfo | |||
Username : | Password: ********** | ||
Password : ********* * | Login Succeeded! | ||
Login | |||
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. 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 | ; 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. 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 | |||
; 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 | ||
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 | * 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