Docker/Image/Upload: Unterschied zwischen den Versionen
K 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“ |
K Dirkwagner verschob die Seite Docker/Image/Definition/04 Upload nach Docker/Image/Upload |
||
| (8 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
Docker/Image/Definition/Upload | '''Docker/Image/Definition/04 Upload''' - Images hochladen | ||
== 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" | ||
docker push | ; 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 | ||
In diesem Fall überschreibt docker push das zuletzt so bezeichnete Image | 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: | 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 | |||
<noinclude> | <noinclude> | ||
| Zeile 86: | Zeile 80: | ||
{{Navigation|<zurück>|<nachste>}} | {{Navigation|<zurück>|<nachste>}} | ||
---- | ---- | ||
--> | -->[[Kategorie:Docker/Image]] | ||
= TMP = | |||
Hochladen von Docker-Images auf Docker-Hub | |||
Das ''whalesay''-Image finden Sie, indem Sie die Startseite des Docker-Hubs aufrufen und den Begriff ''whalesay'' in die Suchleiste rechts neben dem Docker-Logo eingeben | |||
Klicken Sie in den Suchergebnissen auf die Ressource mit der Bezeichnung ''docker/whalesay'', um das öffentliche Repository für dieses Image aufzurufen | |||
Docker-Repositorys sind immer nach demselben Muster aufgebaut: Im Kopfbereich der Seite finden Nutzer die Bezeichnung des Images, die Kategorie des Repositorys sowie den Zeitpunkt des letzten Uploads (''last pushed'') | |||
Ferner bietet jedes Docker-Repository folgende Info-Boxen: | |||
{| class="table table-striped table-hover col1bold col1nowrap" | |||
|- | |||
! Feld !! Beschreibung | |||
|- | |||
|| Description || ausführliche Beschreibung, in der Regel inklusive Gebrauchsanweisung | |||
|- | |||
| Docker Pull Command || Kommandozeilenbefehl, um das Image aus dem Repository herunterzuladen (pull) | |||
|- | |||
| Owner || Information über den Ersteller des Repositorys | |||
|- | |||
| Comments || Kommentarbereich am Seitenende | |||
|} | |||
Den Informationsboxen des Repositorys lässt sich entnehmen, dass es sich bei ''whalesay'' um eine Modifikation des quelloffenen Perl-Skripts '''''cowsay''''' handelt | |||
* Das von Tony Monroe im Jahr 1999 entwickelte Programm generiert in seiner Ursprungsform eine ASCII-Grafik in Form einer Kuh, die zusammen mit einer Nachricht im Terminal des Benutzers erscheint | |||
Um ''docker/whalesay'' herunterzuladen, benutzen Sie den Befehl docker pull nach folgendem Grundschema: | |||
<syntaxhighlight lang="bash" highlight="1" line copy> | |||
docker pull [OPTIONS] NAME [:TAG|@DIGEST] | |||
</syntaxhighlight> | |||
Der Befehl docker pull weist den Daemon an, ein Image aus dem Repository zu laden | |||
* Um welches Image es sich handelt, bestimmen Sie durch die Angabe der Image-Bezeichnung (''NAME'') | |||
* Darüber hinaus können Sie Docker anweisen, wie der gewünschte Befehl ausgeführt werden soll (''OPTIONS'') | |||
* Ebenfalls optional ist die Angabe von '''Tags''' ('':TAG'') und eindeutigen '''Identifikationsnummern''' (''@DIGEST''), die es ermöglichen, eine bestimmte Version eines Images herunterzuladen | |||
Eine lokale Kopie des ''docker/whalesay''-Images erhalten Sie somit durch folgenden Befehl: | |||
<syntaxhighlight lang="bash" highlight="1" line copy> | |||
docker pull docker/whalesay | |||
</syntaxhighlight> | |||
In der Regel können Sie diesen Schritt jedoch überspringen | |||
* Möchten Sie einen Container starten, lädt der Docker-Daemon Images, die er auf dem lokalen System nicht finden kann, automatisch aus dem Repository herunter | |||
__INHALTSVERZEICHNIS_ERZWINGEN__ | |||
Aktuelle Version vom 21. November 2026, 12:49 Uhr
Docker/Image/Definition/04 Upload - Images hochladen
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
TMP
Hochladen von Docker-Images auf Docker-Hub
Das whalesay-Image finden Sie, indem Sie die Startseite des Docker-Hubs aufrufen und den Begriff whalesay in die Suchleiste rechts neben dem Docker-Logo eingeben
Klicken Sie in den Suchergebnissen auf die Ressource mit der Bezeichnung docker/whalesay, um das öffentliche Repository für dieses Image aufzurufen
Docker-Repositorys sind immer nach demselben Muster aufgebaut: Im Kopfbereich der Seite finden Nutzer die Bezeichnung des Images, die Kategorie des Repositorys sowie den Zeitpunkt des letzten Uploads (last pushed)
Ferner bietet jedes Docker-Repository folgende Info-Boxen:
| Feld | Beschreibung |
|---|---|
| Description | ausführliche Beschreibung, in der Regel inklusive Gebrauchsanweisung |
| Docker Pull Command | Kommandozeilenbefehl, um das Image aus dem Repository herunterzuladen (pull) |
| Owner | Information über den Ersteller des Repositorys |
| Comments | Kommentarbereich am Seitenende |
Den Informationsboxen des Repositorys lässt sich entnehmen, dass es sich bei whalesay um eine Modifikation des quelloffenen Perl-Skripts cowsay handelt
- Das von Tony Monroe im Jahr 1999 entwickelte Programm generiert in seiner Ursprungsform eine ASCII-Grafik in Form einer Kuh, die zusammen mit einer Nachricht im Terminal des Benutzers erscheint
Um docker/whalesay herunterzuladen, benutzen Sie den Befehl docker pull nach folgendem Grundschema:
docker pull [OPTIONS] NAME [:TAG|@DIGEST]
Der Befehl docker pull weist den Daemon an, ein Image aus dem Repository zu laden
- Um welches Image es sich handelt, bestimmen Sie durch die Angabe der Image-Bezeichnung (NAME)
- Darüber hinaus können Sie Docker anweisen, wie der gewünschte Befehl ausgeführt werden soll (OPTIONS)
- Ebenfalls optional ist die Angabe von Tags (:TAG) und eindeutigen Identifikationsnummern (@DIGEST), die es ermöglichen, eine bestimmte Version eines Images herunterzuladen
Eine lokale Kopie des docker/whalesay-Images erhalten Sie somit durch folgenden Befehl:
docker pull docker/whalesay
In der Regel können Sie diesen Schritt jedoch überspringen
- Möchten Sie einen Container starten, lädt der Docker-Daemon Images, die er auf dem lokalen System nicht finden kann, automatisch aus dem Repository herunter