Baixar a sua imagem

Atualizado em 29 de set. de 2026·4 min de leitura

A sua organização tem um registro próprio, em <sua-org>.registry.mockzilla.org. Cada build chega lá, e você baixa com uma credencial que você mesmo cria. O nome de host nunca muda.

Criar uma credencial

Abra Configurações e a aba Registro de imagens. A aba aparece quando você tem um backend self-hosted. Owners e admins gerenciam as credenciais.

Escolha Criar credencial, dê um nome a ela, como a ferramenta ou o time que vai usar, e escolha Criar. O diálogo mostra o usuário e a senha, com o docker login que usa os dois. Copie a senha agora: ela aparece uma vez só.

Configurações, Registro de imagens: o nome de host do registro, a imagem ci-payments com a versão dela e a credencial Artifactory, production, ainda sem uso. — Registro de imagens: o nome de host do seu registro, o que você pode baixar e as suas credenciais.

Uma credencial baixa todos os backends da sua organização.
Várias podem estar ativas ao mesmo tempo. Para trocar uma, crie a nova, passe a usar ela e depois revogue a antiga.
Revogar para uma credencial em até cinco minutos.
Último download mostra quando uma credencial foi usada pela última vez.

Uma credencial prova quem está baixando. A sua licença decide o que ela pode baixar, no momento de cada download. Quando uma licença vence, a imagem dela não pode mais ser baixada.

Baixar com docker

Entre uma vez e depois baixe a versão que você quer:

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

Aqui ci-payments é o nome da imagem e v2026.09.23.3 a versão. A aba Registry do backend mostra esse comando com os seus próprios valores, e cada versão que você pode baixar.

Baixar no Kubernetes

Crie um secret de download com o usuário e a senha da credencial:

kubectl create secret docker-registry mockzilla \
  --docker-server=<sua-org>.registry.mockzilla.org \
  --docker-username=<usuario> \
  --docker-password=<senha>

Depois coloque o nome dele em imagePullSecrets na especificação do pod. O Início rápido do backend tem um Deployment completo.

Veja Rodar a imagem.

Os arquivos que vêm com ela

Cada versão tem uma pasta de arquivos junto da imagem:

https://<sua-org>.registry.mockzilla.org/files/<nome-da-imagem>/<versao>

README.md e README.html: como rodar a imagem, para um time com uma credencial do registro e sem conta na Mockzilla.
license.json: a licença com que a imagem foi criada.
data.mockz: os seus contextos, cenários e configuração do serviço, do jeito que foram empacotados na imagem.
storage: uma pasta para cada driver de armazenamento que a imagem tem, com as configurações dele e os arquivos que preparam o banco de dados.
SHA256SUMS: um checksum para cada arquivo.
linux-amd64 e linux-arm64: por plataforma, a imagem como arquivo, os SBOMs e o relatório de segurança dela.

Abra a pasta num navegador e entre com a mesma credencial, ou baixe um arquivo com curl:

curl -u <usuario>:<senha> -O \
  https://<sua-org>.registry.mockzilla.org/files/ci-payments/v2026.09.23.3/license.json

Quando um download é recusado

401 Unauthorized: o usuário ou a senha estão errados, ou a credencial foi revogada.
403 Forbidden: a credencial está certa, mas o download não é permitido, por exemplo porque a licença venceu. O erro diz o motivo.

Cada download conta para a cota de downloads da sua organização, e cada arquivo que você baixa também.