Docker/Image/Upload: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
|||
| Zeile 83: | Zeile 83: | ||
= TMP = | = TMP = | ||
Hochladen von Docker-Images auf Docker-Hub | Hochladen von Docker-Images auf Docker-Hub | ||
Version vom 21. November 2026, 12:40 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