Docker/Image/Upload
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