Docker/Registry: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
[[Kategorie:Docker/Registry]]
[[Kategorie:Docker/Registry]] 
Eine eigene Docker Image-Registry


Docker-Image registry als eigener Container betreiben
= Eigene Docker Image-Registry betreiben = 


So behältst du die volle Kontrolle über deine Images, umgehst Rate-Limits und sparst Gebühren für private Repositories.  
Mit einer eigenen Docker-Registry behältst du die volle Kontrolle über deine Images, umgehst Rate-Limits und sparst Gebühren für private Repositories. 


== Lokale Registry ==
== Lokale Registry für Tests starten == 
; Lokale Registry schnell starten
Für lokale Tests auf deinem eigenen Rechner reicht ein einziger Befehl im Terminal: [1, 2]
docker run -d -p 5000:5000 --restart always --name private-registry registry:2


    • Erreichbarkeit. Die Registry läuft nun im Hintergrund und ist lokal unter localhost:5000 erreichbar.
Für lokale Tests auf deinem eigenen Rechner reicht ein einziger Befehl im Terminal: 


    • Images hochladen. Damit Docker weiß, wohin ein Image geladen werden soll, musst du es mit der Adresse der Registry taggen:
* '''Erreichbarkeit:''' Die Registry läuft nun im Hintergrund und ist lokal unter localhost:5000 erreichbar.
* '''Images hochladen (Tag & Push):''' Damit Docker weiß, wohin ein Image geladen werden soll, musst du es zunächst mit der Adresse der Registry markieren (taggen) und anschließend hochladen:


      docker tag mein-image:latest localhost:5000/mein-image:latest
* '''Images herunterladen (Pull):''' Auf demselben Host kannst du das Image anschließend wieder abrufen:


      docker push localhost:5000/mein-image:latest
== Produktivbetrieb auf einem Server == 


      Verwende Code mit Vorsicht.
Sobald andere Rechner über das Netzwerk oder das Internet auf die Registry zugreifen sollen, erzwingt Docker aus Sicherheitsgründen eine '''verschlüsselte HTTPS-Verbindung''' sowie eine '''Authentifizierung'''. Für den produktiven Einsatz sind drei Anpassungen nötig: 


    • Images herunterladen. Auf demselben Host kannst du das Image anschließend wieder abrufen: [1, 2]
* '''Persistenter Speicher:''' Binde ein lokales Verzeichnis oder ein Docker-Volume ein, damit deine Images bei einem Neustart oder Update des Registry-Containers nicht verloren gehen.
* '''Reverse Proxy & SSL:''' Schalte einen Reverse Proxy (z. B. Nginx, Traefik oder Caddy) vor den Port 5000. Dieser übernimmt das SSL-Zertifikat (beispielsweise über Let's Encrypt) und leitet Anfragen von einer Domain wie registry.deinedomain.de intern weiter.
* '''Zugangsschutz:''' Richte eine Basic-Authentifizierung (Benutzername und Passwort via htpasswd) direkt in der Registry-Konfiguration oder über den vorgeschalteten Reverse Proxy ein. Danach melden sich Clients vor dem Push oder Pull wie folgt an:


      docker pull localhost:5000/mein-image:latest
== Alternativen im Überblick == 


      Verwende Code mit Vorsicht.
Die offizielle Docker Registry bietet keine eigene Weboberfläche und keine feingranulare Rechteverwaltung. Wenn du mehr Komfort benötigst, bieten sich folgende Lösungen an: 


== Produktivbetrieb ==
{| class="wikitable"
; Produktivbetrieb auf einem Server (mit HTTPS & Login)
! Lösung !! Besonderheiten !! Ideal für
Sobald andere Rechner über das Netzwerk oder Internet auf die Registry zugreifen sollen, erzwingt Docker aus Sicherheitsgründen eine verschlüsselte HTTPS-Verbindung sowie eine Authentifizierung.
|- 


    • Persistenter Speicher. Binde ein lokales Verzeichnis oder ein Docker-Volume ein, damit deine Images bei einem Neustart oder Update des Registry-Containers nicht verloren gehen. [1]
| '''Offizielle Docker Registry''' || Sehr ressourcenschonend, schnell eingerichtet, rein API-basiert (ohne UI). || Einzelentwickler, kleine Teams, interne CI/CD-Pipelines.
|- 


    • Reverse Proxy & SSL. Schalte einen Reverse Proxy wie Nginx, Traefik oder Caddy vor den Port 5000. Dieser übernimmt das SSL-Zertifikat (z. B. über Let's Encrypt) und leitet Anfragen von einer Domain wie registry.deinedomain.de intern weiter. [1]
| '''Harbor''' || Open-Source-Registry mit Web-UI, Rollenverwaltung, Vulnerability-Scanning und Image-Replikation. || Unternehmen und größere Teams mit hohen Sicherheitsanforderungen.
|- 


    • Zugangsschutz. Richte eine Basic-Authentifizierung (Benutzername und Passwort via htpasswd) entweder direkt in der Registry-Konfiguration oder über den vorgeschalteten Reverse Proxy ein. Danach melden sich Clients vor dem Push/Pull per docker login registry.deinedomain.de an. [1, 2]
| '''GitLab / Gitea / Forgejo''' || Integrierte Container-Registry direkt in der jeweiligen Git-Plattform. || Teams, die ohnehin eine dieser Plattformen selbst hosten.
|- 


== Alternativen ==
| '''JFrog Artifactory / Nexus''' || Universelle Repository-Manager für Docker-Images sowie weitere Paketformate (npm, Maven, PyPI). || Komplexe Entwicklungsumgebungen mit verschiedenen Artefakt-Typen.
; Alternativen zum puren registry-Container
|} 
Die offizielle Docker Registry bietet keine eigene Weboberfläche und keine feingranulare Rechteverwaltung. Wenn du mehr Komfort benötigst, bieten sich folgende Lösungen an:


Lösung    Besonderheiten    Ideal für
== Weiterführende Ressourcen == 


Offizielle Docker Registry    Sehr ressourcenschonend, schnell eingerichtet, rein API-basiert (ohne UI).    Einzelentwickler, kleine Teams, interne CI/CD-Pipelines.
Ausführliche Schritt-für-Schritt-Anleitungen für den Einstieg findest du im '''offiziellen Docker Blog''' sowie bei '''Sliplane'''.
 
Harbor    Open-Source-Registry mit Web-UI, Rollenverwaltung, Vulnerability-Scanning und Image-Replikation.    Unternehmen und größere Teams mit hohen Sicherheitsanforderungen.
 
GitLab / Gitea / Forgejo    Integrierte Container-Registry direkt in der jeweiligen Git-Plattform.    Teams, die ohnehin eine dieser Plattformen selbst hosten.
 
JFrog Artifactory / Nexus    Universelle Repository-Manager für Docker-Images sowie weitere Paketformate (npm, Maven, PyPI).    Komplexe Entwicklungsumgebungen mit verschiedenen Artefakt-Typen.
 
Eine ausführliche Schritt-für-Schritt-Anleitung für den Einstieg findest du im offiziellen Docker Blog sowie bei Sliplane. [1, 2]

Version vom 19. November 2026, 21:52 Uhr

 

= Eigene Docker Image-Registry betreiben = 

Mit einer eigenen Docker-Registry behältst du die volle Kontrolle über deine Images, umgehst Rate-Limits und sparst Gebühren für private Repositories. 

== Lokale Registry für Tests starten == 

Für lokale Tests auf deinem eigenen Rechner reicht ein einziger Befehl im Terminal: 

  • Erreichbarkeit: Die Registry läuft nun im Hintergrund und ist lokal unter localhost:5000 erreichbar.
  • Images hochladen (Tag & Push): Damit Docker weiß, wohin ein Image geladen werden soll, musst du es zunächst mit der Adresse der Registry markieren (taggen) und anschließend hochladen:
  • Images herunterladen (Pull): Auf demselben Host kannst du das Image anschließend wieder abrufen:

== Produktivbetrieb auf einem Server == 

Sobald andere Rechner über das Netzwerk oder das Internet auf die Registry zugreifen sollen, erzwingt Docker aus Sicherheitsgründen eine verschlüsselte HTTPS-Verbindung sowie eine Authentifizierung. Für den produktiven Einsatz sind drei Anpassungen nötig: 

  • Persistenter Speicher: Binde ein lokales Verzeichnis oder ein Docker-Volume ein, damit deine Images bei einem Neustart oder Update des Registry-Containers nicht verloren gehen.
  • Reverse Proxy & SSL: Schalte einen Reverse Proxy (z. B. Nginx, Traefik oder Caddy) vor den Port 5000. Dieser übernimmt das SSL-Zertifikat (beispielsweise über Let's Encrypt) und leitet Anfragen von einer Domain wie registry.deinedomain.de intern weiter.
  • Zugangsschutz: Richte eine Basic-Authentifizierung (Benutzername und Passwort via htpasswd) direkt in der Registry-Konfiguration oder über den vorgeschalteten Reverse Proxy ein. Danach melden sich Clients vor dem Push oder Pull wie folgt an:

== Alternativen im Überblick == 

Die offizielle Docker Registry bietet keine eigene Weboberfläche und keine feingranulare Rechteverwaltung. Wenn du mehr Komfort benötigst, bieten sich folgende Lösungen an: 

Lösung Besonderheiten Ideal für
Offizielle Docker Registry Sehr ressourcenschonend, schnell eingerichtet, rein API-basiert (ohne UI). Einzelentwickler, kleine Teams, interne CI/CD-Pipelines.
Harbor Open-Source-Registry mit Web-UI, Rollenverwaltung, Vulnerability-Scanning und Image-Replikation. Unternehmen und größere Teams mit hohen Sicherheitsanforderungen.
GitLab / Gitea / Forgejo Integrierte Container-Registry direkt in der jeweiligen Git-Plattform. Teams, die ohnehin eine dieser Plattformen selbst hosten.
JFrog Artifactory / Nexus Universelle Repository-Manager für Docker-Images sowie weitere Paketformate (npm, Maven, PyPI). Komplexe Entwicklungsumgebungen mit verschiedenen Artefakt-Typen.

 

== Weiterführende Ressourcen == 

Ausführliche Schritt-für-Schritt-Anleitungen für den Einstieg findest du im offiziellen Docker Blog sowie bei Sliplane.