Docker/Image/Upload: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
K Textersetzung - „Docker/Image/Eigene Images“ durch „Docker/Image/Definition“
K Dirkwagner verschob die Seite Docker/Image/Definition/04 Upload nach Docker/Image/Upload
 
(9 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:
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:


  docker push accountna m e/imagename
; 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
* Auf der Weboberfläche können Sie über den Button Manage Repository eine Kurzbeschreibung und eine README-Datei bearbeiten
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. (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
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