Mirrors und Hosts ohne Netz

Deine Rechner müssen unsere Registry nicht erreichen. Richte Artifactory, Nexus oder Harbor einmal darauf aus, und deine Rechner laden von diesem Mirror. Nur der Mirror spricht mit uns. Für einen Host ganz ohne Netz kopierst du das Image in eine Datei und bringst sie hinüber.

Der Tab Mirrors des Backends hat jeden Schritt unten, mit deinem Hostnamen, deinem Image-Namen und deiner Version schon eingetragen.

Bevor du anfängst

Leg unter Einstellungen in Image-Registry einen Zugang für den Mirror an. Benenne ihn nach dem Mirror, dann lassen sich seine Downloads auseinanderhalten. Ein Zugang gilt für jedes Backend deiner Organisation.

Siehe Dein Image herunterladen.

Die Beispiele unten laden das Image ci-payments in der Version v2026.09.23.3.

Artifactory

Leg zwei Remote-Repositories an: ein Docker-Repository für die Images und ein Generic-Repository für die Dateien, die dazugehören. Trag diese Felder ein und lass den Rest, wie er ist:

Repository Key   mockzilla
Package Type     Docker
URL              https://<deine-org>.registry.mockzilla.org
Docker API       V2
Username         <Benutzername des Zugangs>
Password         <Passwort des Zugangs>
Enable token authentication   yes

Repository Key   mockzilla-files
Package Type     Generic
URL              https://<deine-org>.registry.mockzilla.org/files
Username         <Benutzername des Zugangs>
Password         <Passwort des Zugangs>

Dann lädst du darüber:

docker login artifactory.example.com
docker pull artifactory.example.com/mockzilla/ci-payments:v2026.09.23.3

Die Dateien kommen über das zweite Repository, unter https://artifactory.example.com/artifactory/mockzilla-files/ci-payments/v2026.09.23.3.

Nexus

Leg zwei Proxy-Repositories an: ein docker-Repository für die Images und ein raw-Repository für die Dateien, die dazugehören.

Recipe           docker (proxy)
Remote storage   https://<deine-org>.registry.mockzilla.org
Docker Index     Use proxy registry
Authentication   Username, mit dem Zugang von oben

Recipe           raw (proxy)
Remote storage   https://<deine-org>.registry.mockzilla.org/files
Authentication   Username, mit dem Zugang von oben

Dann lädst du darüber:

docker login nexus.example.com:8443
docker pull nexus.example.com:8443/ci-payments:v2026.09.23.3

8443 steht hier für den HTTP-Connector-Port, den du dem docker-Repository gegeben hast. Die Dateien kommen über das raw-Repository, unter https://nexus.example.com/repository/mockzilla-files/ci-payments/v2026.09.23.3.

Harbor

Leg einen Registry-Endpoint an, dann ein Proxy-Cache-Projekt, das ihn nutzt:

Administration › Registries › New endpoint
Provider         Docker Registry
Name             mockzilla
Endpoint URL     https://<deine-org>.registry.mockzilla.org
Access ID        <Benutzername des Zugangs>
Access Secret    <Passwort des Zugangs>
Verify Remote Cert   yes

Projects › New project
Project Name     mockzilla
Proxy Cache      an, mit dem Endpoint mockzilla

Dann lädst du darüber:

docker login harbor.example.com
docker pull harbor.example.com/mockzilla/ci-payments:v2026.09.23.3

Harbor hält nur Images. Die Dateien, die zum Image gehören, holst du direkt aus deiner Registry.

Ein Host ohne Netz

Kopiere das Image auf einem Rechner, der deine Registry erreicht, mit crane in eine Datei. crane ist ein kleines Kommandozeilenwerkzeug für Registries:

docker login <deine-org>.registry.mockzilla.org
crane pull <deine-org>.registry.mockzilla.org/ci-payments:v2026.09.23.3 ci-payments.tar

Nimm auch die Dateien mit, die zum Image gehören. Bring beides auf die andere Seite und lade das Image dort:

docker load -i ci-payments.tar

Oder schieb es in die Registry, aus der deine Rechner laden:

crane push ci-payments.tar registry.internal/ci-payments:v2026.09.23.3

Ein Image auf einem Host ohne Netz kann seine Lizenz nicht abrufen. Es muss sie in sich tragen oder eine Lizenzdatei lesen, die du einbindest.

Siehe Lizenzen.

Wie es weitergeht

• Das Image ausführen
• Lizenzen