Pruebas E2E con Docker

El modo E2E con Docker arranca un entorno desechable de GitLab, provisiona fixtures, registra un runner de CI y ejecuta la suite end-to-end de MCP contra esa instancia local. La ruta por defecto usa GitLab CE; el modo Enterprise usa la imagen EE más una licencia Ultimate local. Úsalo cuando necesites validación de alta confianza sin depender de una instancia real configurada en .env.

Qué incluye

| Componente | Propósito | | -------------------- | -------------------------------------------------------------------------------------------------------------------------- | | GitLab CE o EE | Instancia efímera de GitLab para llamadas reales a REST y GraphQL | | GitLab Runner | Habilita flujos de pipelines y jobs que los tests unitarios no pueden ejercitar | | Servicio de fixtures | Proporciona endpoints deterministas para webhooks, emoji personalizados y mirrors | | Suite E2E | Ejecuta flujos de herramientas individuales, meta-herramientas y herramientas dinámicas mediante transporte MCP en memoria |

El modo Docker cubre los mismos flujos de ciclo de vida que los E2E autoalojados, además de escenarios de pipelines y jobs que solo están disponibles en Docker. Crea datos temporales en GitLab y los elimina al desmontar el stack.

Ejecución rápida

make test-e2e-docker

Ese objetivo orquesta el stack Docker, espera a GitLab, configura el usuario y el runner de pruebas, ejecuta la suite E2E de Go con el build tag e2e, y escribe reportes JUnit y JSON.

Para ejecutar la cobertura Enterprise/Premium contra GitLab EE, define ENTERPRISE_LICENSE en .env o en la shell y usa:

make test-e2e-docker-enterprise

Ese objetivo se ejecuta con los build tags e2e enterprise, asi compila los archivos comunes de harness y los tests Enterprise/Premium de test/e2e/suite/*_ee_test.go. Los tests solo CE viven en test/e2e/suite/*_ce_test.go y quedan en make test-e2e-docker, mientras las fixtures Enterprise pueden ajustarse de forma independiente.

Cuando ENTERPRISE_LICENSE contiene un activation code de 24 caracteres, la primera ejecucion correcta exporta la licencia reutilizable generada a test/e2e/.enterprise-license. Las siguientes ejecuciones Enterprise prefieren ese cache local ignorado por Git y lo instalan mediante la License API, asi no consumen otra vez el activation code.

Flujo manual

Usa la secuencia manual cuando necesites inspeccionar la UI de GitLab o relanzar un test concreto sin recrear el stack cada vez.

docker compose -f test/e2e/docker-compose.yml up -d
./test/e2e/scripts/wait-for-gitlab.sh
./test/e2e/scripts/setup-gitlab.sh
./test/e2e/scripts/register-runner.sh

set -a && source test/e2e/.env.docker && set +a
go test -v -tags e2e -timeout 600s ./test/e2e/suite/

docker compose -f test/e2e/docker-compose.yml down -v

Para preparar Enterprise manualmente, usa la imagen EE en los comandos de compose y activa el flag durante el provisionamiento:

env GITLAB_IMAGE=gitlab/gitlab-ee:latest docker compose -f test/e2e/docker-compose.yml up -d
GITLAB_ENTERPRISE=true ./test/e2e/scripts/setup-gitlab.sh
env GITLAB_IMAGE=gitlab/gitlab-ee:latest docker compose -f test/e2e/docker-compose.yml down -v

Para ejecutar solo el flujo de herramientas dinámicas después de preparar el entorno:

E2E_MODE=docker \
  go test -v -tags e2e -timeout 600s \
  -run '^TestDynamicToolSurface' \
  ./test/e2e/suite/

Cuándo usarlo

| Situación | ¿Usar E2E Docker? | | ---------------------------------------------------------------------- | ----------------- | | Cambios en registro de herramientas, proyección del catálogo o schemas | Sí | | Cambios en pipelines, jobs, webhooks, emoji personalizados o mirrors | Sí | | Verificar release candidates antes de publicar binarios | Sí | | Editar una página Markdown estrecha | Normalmente no | | Depurar un unit test fallando con respuestas mock de GitLab | Normalmente no |

Reportes y limpieza

La suite escribe reportes legibles por máquinas para CI y diagnóstico local. Si una ejecución falla, mantén el stack Docker levantado mientras inspeccionas los datos de GitLab, los logs del runner y los reportes E2E generados. Cuando termines, elimina todos los datos de prueba con:

docker compose -f test/e2e/docker-compose.yml down -v

Solución de problemas

| Síntoma | Qué comprobar | | ------------------------------------------- | ---------------------------------------------------------------------------------- | | GitLab nunca queda listo | Límites de memoria y CPU de Docker; GitLab necesita varios GB de RAM | | Los escenarios Enterprise no se habilitan | GITLAB_ENTERPRISE=true, la imagen EE y ENTERPRISE_LICENSE en .env | | Tests de pipelines o jobs saltados/fallando | Salida de registro del runner y valores de test/e2e/.env.docker | | Fallos en webhooks o mirrors | Salud del contenedor de fixtures y URLs internas de la red Docker | | Una repetición ve datos antiguos | Ejecuta docker compose -f test/e2e/docker-compose.yml down -v y empieza de nuevo |

Docker E2E es más lento que los tests unitarios, pero es la ruta de validación preferida para migraciones de arquitectura porque ejercita la API real de GitLab, el transporte MCP y todas las superficies públicas de herramientas a la vez.