Markdown

Docker Hub: Zugangsdaten

Unter Anbindungen, Kategorie Docker-Registries, hinterlegst du Docker Hub per Access Token. GitHub-Hosting braucht diese Anbindung, damit Builds Images dorthin pushen und GitOps sie von dort zieht.

Auf dieser Seite

Docker Hub liegt unter Anbindungen in der Kategorie Docker-Registries. Docker bietet für Registry-Login kein OAuth für Drittanbieter; MainPath prüft deshalb Benutzername und Personal Access Token gegen die Docker-Hub-Login-API.

Wenn du ein Projekt auf GitHub hostest, ist eine Docker-Hub-Anbindung Pflicht. GitLab.com und Self-hosted GitLab nutzen die Container Registry derselben GitLab-Instanz, siehe GitLab: Zugangsdaten.

Access Token

  1. Lege in Docker Hub unter Account Settings → Personal access tokens einen Token mit Read, Write, Delete auf die Registry an (mindestens Read & Write).
  2. Öffne Anbindungen → Docker-Registries → Docker Hub.
  3. Trage Name, Slug, Benutzername (Docker-ID) und den Token ein. Namespace ist optional: leer bleibt es bei der Docker-ID, sonst eine Organisation, in die du pushen darfst.

MainPath prüft die Zugangsdaten mit einem Login gegen hub.docker.com. Der Token liegt in OpenBao, nicht im Klartext in Git.

Im Projekt nutzen

Beim Projekt unter Repositories erscheint die Auswahl Docker-Registry, sobald mindestens eine Komponente oder GitOps auf GitHub steht.

Images heißen docker.io/<namespace>/<projekt-slug>-<komponente>, zum Beispiel docker.io/acme/student-pro-backend. GitHub Actions schreibt .github/workflows/docker-publish.yml und setzt die Secrets DOCKERHUB_USERNAME und DOCKERHUB_TOKEN. GitOps zieht dieselben Namen.

Ohne Dockerfile im Repository wird der Publish-Job übersprungen.

Was nicht geht

  • OAuth gegen Docker Hub für den Registry-Login
  • Nested Pfade wie bei GitLab (gruppe/projekt/backend); Docker Hub kennt nur namespace/name

Danke für deine Anfrage

Wir haben deine Anfrage erhalten und melden uns schnellstmöglich bei dir.

Du möchtest direkt mit uns sprechen?

Buche hier einen passenden Termin für ein Erstgespräch mit Robin.

Kalender in einem neuen Tab öffnen