Docker/Registry: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
 
(13 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
[[Kategorie:Docker/Registry]]
<noinclude>
Eine eigene Docker Image-Registry
<!--
----
{{Navigation|<zurück>|<nachste>}}
{{Navigation|BSI/200-3|BSI/200-3/Einleitung/Beispiele}}
----
-->
'''{{BASEPAGENAME}}'''
</noinclude>


Docker-Image registry als eigener Container betreiben
== Beschreibung ==
== 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:
{| class="table table-striped table-hover col1bold col1nowrap"
| 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:
|}


    • Images hochladen. Damit Docker weiß, wohin ein Image geladen werden soll, musst du es mit der Adresse der Registry taggen:
== Produktivbetrieb ==
; 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''


      docker tag mein-image:latest localhost:5000/mein-image:latest
Für den produktiven Einsatz sind drei Anpassungen nötig:
{| class="table table-striped table-hover col1bold col1nowrap"
| 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 push localhost:5000/mein-image:latest
== Alternativen ==
Die offizielle Docker Registry bietet keine eigene Weboberfläche und keine feingranulare Rechteverwaltung.


      Verwende Code mit Vorsicht.
; Mehr Komfort bieten folgende Lösungen an
{| class="table table-striped table-hover col1bold col1nowrap"
! 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
|}


    • Images herunterladen. Auf demselben Host kannst du das Image anschließend wieder abrufen: [1, 2]
<noinclude>
<!--
----
{{Navigation|<zurück>|<nachste>}}
----
-->


      docker pull localhost:5000/mein-image:latest
== Anhang ==
=== Siehe auch ===
<div style="column-count:2">
<categorytree hideroot=on mode="pages">{{BASEPAGENAME}}</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}


      Verwende Code mit Vorsicht.
=== Dokumentation ===
<!--
; Man-Page
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]


== Produktivbetrieb ==
; Info-Pages
; Produktivbetrieb auf einem Server (mit HTTPS & Login)
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]
; Hinweise
<div class="card h-100 bg-warning">
<div class="card-header">'''<big>Header</big>'''</div>
<div class="card-body bg-white">
Hier steht der Kartentext
</div>
</div>
-->


    • 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]
=== Links ===
==== Projekt ====
==== Weblinks ====
* [https://www.docker.com/blog/how-to-use-your-own-registry-2/ Offizieller Docker Blog]
* [https://sliplane.io/de-de/blog/self-hosting-docker-registry-the-easy-way Sliplane]


    • 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]
<!--
{{DEFAULTSORT:new}}
{{DISPLAYTITLE:new}}
-->


== Alternativen ==
[[Kategorie:Docker/Registry]]
; Alternativen zum puren registry-Container
</noinclude>
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.
 
Eine ausführliche Schritt-für-Schritt-Anleitung für den Einstieg findest du im offiziellen Docker Blog sowie bei Sliplane. [1, 2]

Aktuelle Version vom 20. November 2026, 08:02 Uhr

Docker/Registry


Beschreibung

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

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

Die offizielle Docker Registry bietet keine eigene Weboberfläche und keine feingranulare Rechteverwaltung.

Mehr Komfort bieten 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


Anhang

Siehe auch



Dokumentation

Projekt