Rodar a imagem

A imagem roda onde qualquer imagem roda: um notebook, um job de CI, um servidor ou Kubernetes. A aba Início rápido do backend tem os comandos para cada opção, com o seu registro, o nome da imagem e a versão já preenchidos.

Nesta página, <image> é a sua imagem com a versão, como <sua-org>.registry.mockzilla.org/ci-payments:v2026.09.23.3.

Escolha como rodar

• Experimentar: num notebook ou num job de CI. Tudo fica na memória, então um reinício começa do zero.
• Um servidor: guarda o estado entre reinícios, num arquivo SQLite num volume.
• Com um banco de dados: um arquivo de compose com PostgreSQL, para várias cópias dividirem um banco de dados.
• Kubernetes: um Deployment que baixa a imagem com um secret e lê as configurações de armazenamento de outro.

Cada um precisa de uma credencial do registro.

Veja Baixar a sua imagem.

Experimentar

docker login <sua-org>.registry.mockzilla.org
docker run --rm -p 2200:2200 <image>

Depois confira se ela responde:

curl http://localhost:2200/healthz

O explorador de API fica em http://localhost:2200, a não ser que você tenha desligado.

Bom saber

• Ela roda na porta 2200. Defina APP_BASE_URL com o endereço que os seus clientes usam, senão os links nas respostas ficam relativos.
• Ela roda como o usuário 65532. Um volume em que ela escreve precisa pertencer a esse usuário. Deixe o volume num disco local: uma pasta compartilhada do macOS ou do Windows, ou NFS, perde escritas.
• Ela não inicia se não alcança o armazenamento. Ela nunca volta para a memória.
• docker run --rm <image> about lista o que a imagem traz: os dados do build, os serviços, os SBOMs e o relatório de segurança.

Mudar um valor ao rodar

A imagem inicia com os valores de Valores padrão do backend. Cada um é uma variável de ambiente, e um valor que você passa ao rodar a imagem vale mais que o de dentro:

• APP_DISABLE_UI: true esconde o explorador de API.
• ROUTER_HISTORY_ENABLED: false para de gravar requisições e respostas.
• ROUTER_REPLAY_ENABLED: true liga o replay.

Por exemplo:

docker run -e ROUTER_HISTORY_ENABLED=false <image>

O armazenamento tem variáveis próprias.

Veja Drivers de armazenamento.

Os seus próprios arquivos, sem um build novo

A imagem traz os contextos, cenários e configuração do serviço que você definiu no espaço de trabalho. Para mudar esses arquivos sem outro build, monte uma pasta em /etc/mockzilla/config, ou aponte MZ_CONFIG_DIR para uma. Ela tem uma pasta por serviço:

services/<route key>/setup/context.yml
services/<route key>/setup/scenarios.yml
services/<route key>/setup/config.yml

Um arquivo que você monta substitui o arquivo da imagem com o mesmo nome. Um arquivo que você não monta continua o da imagem.

Para começar do que a imagem traz, pegue o data.mockz nos arquivos que vêm com ela. É um .tar.gz com as mesmas pastas, e tar -xzf data.mockz descompacta.

A licença ao rodar

A imagem lê a licença ao iniciar e confere a cada hora. O que ela precisa depende de como recebe a licença:

• Leva a licença dentro: nada para configurar. Para dar a ela uma licença mais nova, monte o arquivo em /etc/mockzilla/license.json.
• Busca a licença no nosso servidor: uma rota até o nome de host do seu registro. Mantenha um volume em /var/lib/mockzilla, para um contêiner novo iniciar com a licença que já buscou.

Quando a licença vence, uma imagem rodando responde cada requisição com um erro, e uma nova não inicia.

Veja Licenças.

Para onde ir agora

• Drivers de armazenamento
• Licenças
• Espelhos e hosts sem conexão