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
- Lege in Docker Hub unter Account Settings → Personal access tokens einen Token mit Read, Write, Delete auf die Registry an (mindestens Read & Write).
- Öffne Anbindungen → Docker-Registries → Docker Hub.
- 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 nurnamespace/name