Correr la imagen
La imagen corre donde corra una imagen: una laptop, un job de CI, un servidor o Kubernetes. La pestaña Inicio rápido del backend tiene los comandos para cada opción, con tu registro, el nombre de la imagen y la versión ya completados.
En esta página, <image> es tu imagen con su versión, como <tu-org>.registry.mockzilla.org/ci-payments:v2026.09.23.3.
Elige cómo correrla
- Probarlo: en una laptop o en un job de CI. Todo queda en memoria, así que un reinicio empieza de cero.
- Un servidor: guarda su estado entre reinicios, en un archivo SQLite en un volumen.
- Con una base de datos: un archivo de compose con PostgreSQL, para que varias copias compartan una base de datos.
- Kubernetes: un Deployment que descarga la imagen con un secret y lee su configuración de almacenamiento de otro.
Cada una necesita una credencial del registro.
Consulta Descargar tu imagen.
Probarlo
docker login <tu-org>.registry.mockzilla.org
docker run --rm -p 2200:2200 <image>Después comprueba que responde:
curl http://localhost:2200/healthzEl explorador de API está en http://localhost:2200, salvo que lo hayas apagado.
Para tener en cuenta
- Corre en el puerto 2200. Define
APP_BASE_URLcon la dirección que usan tus clientes, o los enlaces de sus respuestas quedan relativos. - Corre como el usuario 65532. Un volumen en el que escribe tiene que pertenecer a ese usuario. Deja el volumen en un disco local: una carpeta compartida desde macOS o Windows, o NFS, pierde escrituras.
- No arranca si no llega a su almacenamiento. Nunca vuelve a la memoria.
docker run --rm <image> aboutlista lo que trae la imagen: los datos de su build, sus servicios, sus SBOM y su informe de seguridad.
Cambiar un valor al correrla
La imagen arranca con los valores de Valores predeterminados del backend. Cada uno es una variable de entorno, y un valor que pasas al correr la imagen gana sobre el de adentro:
APP_DISABLE_UI:trueoculta el explorador de API.ROUTER_HISTORY_ENABLED:falsedeja de grabar solicitudes y respuestas.ROUTER_REPLAY_ENABLED:trueactiva el replay.
Por ejemplo:
docker run -e ROUTER_HISTORY_ENABLED=false <image>El almacenamiento tiene variables propias.
Consulta Drivers de almacenamiento.
Tus propios archivos, sin un build nuevo
La imagen trae los contextos, escenarios y configuración del servicio que definiste en el espacio de trabajo. Para cambiarlos sin volver a construir, monta una carpeta en /etc/mockzilla/config, o apunta MZ_CONFIG_DIR a una. Tiene una carpeta por servicio:
services/<route key>/setup/context.yml
services/<route key>/setup/scenarios.yml
services/<route key>/setup/config.ymlUn archivo que montas reemplaza al archivo de la imagen con el mismo nombre. Un archivo que no montas queda como el de la imagen.
Para partir de lo que trae la imagen, toma data.mockz de los archivos que la acompañan. Es un .tar.gz con las mismas carpetas, y tar -xzf data.mockz lo descomprime.
La licencia al correrla
La imagen lee su licencia al arrancar y la revisa cada hora. Lo que necesita depende de cómo recibe su licencia:
- La lleva dentro: nada que configurar. Para darle una licencia más nueva, monta el archivo en
/etc/mockzilla/license.json. - La descarga de nuestro servidor: una ruta al nombre de host de tu registro. Mantén un volumen en
/var/lib/mockzilla, para que un contenedor nuevo arranque con la licencia que ya descargó.
Cuando su licencia vence, una imagen que corre responde cada solicitud con un error, y una nueva no arranca.
Consulta Licencias.