Espelhos e hosts sem conexão

As suas máquinas não precisam alcançar o nosso registro. Aponte o Artifactory, o Nexus ou o Harbor para ele uma vez, e as suas máquinas baixam desse espelho. Só o espelho fala com a gente. Para um host sem rede nenhuma, copie a imagem para um arquivo e leve até lá.

A aba Espelhos do backend tem cada passo abaixo, com o seu nome de host, o nome da imagem e a versão já preenchidos.

Antes de começar

Crie uma credencial do registro para o espelho em Configurações, em Registro de imagens. Dê a ela o nome do espelho, assim os downloads dele ficam fáceis de separar. Uma credencial vale para todos os backends da sua organização.

Veja Baixar a sua imagem.

Os exemplos abaixo baixam a imagem ci-payments na versão v2026.09.23.3.

Artifactory

Adicione dois repositórios remotos: um Docker para as imagens e um Generic para os arquivos que vêm com elas. Preencha estes campos e deixe o resto como está:

Repository Key   mockzilla
Package Type     Docker
URL              https://<sua-org>.registry.mockzilla.org
Docker API       V2
Username         <usuário da credencial>
Password         <senha da credencial>
Enable token authentication   yes

Repository Key   mockzilla-files
Package Type     Generic
URL              https://<sua-org>.registry.mockzilla.org/files
Username         <usuário da credencial>
Password         <senha da credencial>

Depois baixe por ele:

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

Os arquivos chegam pelo segundo repositório, em https://artifactory.example.com/artifactory/mockzilla-files/ci-payments/v2026.09.23.3.

Nexus

Adicione dois repositórios proxy: um docker para as imagens e um raw para os arquivos que vêm com elas.

Recipe           docker (proxy)
Remote storage   https://<sua-org>.registry.mockzilla.org
Docker Index     Use proxy registry
Authentication   Username, com a credencial de cima

Recipe           raw (proxy)
Remote storage   https://<sua-org>.registry.mockzilla.org/files
Authentication   Username, com a credencial de cima

Depois baixe por ele:

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

Aqui 8443 é a porta do conector HTTP que você deu ao repositório docker. Os arquivos chegam pelo raw, em https://nexus.example.com/repository/mockzilla-files/ci-payments/v2026.09.23.3.

Harbor

Adicione um endpoint de registro e depois um projeto de proxy cache que use esse endpoint:

Administration › Registries › New endpoint
Provider         Docker Registry
Name             mockzilla
Endpoint URL     https://<sua-org>.registry.mockzilla.org
Access ID        <usuário da credencial>
Access Secret    <senha da credencial>
Verify Remote Cert   yes

Projects › New project
Project Name     mockzilla
Proxy Cache      ligado, com o endpoint mockzilla

Depois baixe por ele:

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

O Harbor guarda só imagens. Os arquivos que vêm com a imagem você baixa direto do seu registro.

Um host sem rede

Numa máquina que alcança o seu registro, copie a imagem para um arquivo com o crane, uma pequena ferramenta de linha de comando para registros:

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

Leve também os arquivos que vêm com a imagem. Passe os dois para o outro lado e carregue a imagem lá:

docker load -i ci-payments.tar

Ou envie a imagem para o registro de onde as suas máquinas baixam:

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

Uma imagem num host sem rede não consegue buscar a licença. Ela precisa levar a licença dentro, ou ler um arquivo de licença que você monta.

Veja Licenças.

Para onde ir agora

• Rodar a imagem
• Licenças