📦 Guía de Instalación — Docker Labs#

Versión: 1.5.0 Estado: 🟢 Activo Audiencia: 👥 Todos Objetivo: Instalar y operar docker-labs tanto desde fuente como desde el instalador Windows

✅ Requisitos#

Software#

Docker Desktop o Docker Engine con docker compose
Git para trabajar desde fuente
Navegador moderno

Hardware recomendado#

Escenario	CPU	RAM total	Disco libre
Control Center + 1 lab liviano	4 hilos	8 GB	15 GB
Plataforma principal `9090 + 05 + 09 + 06`	6 a 8 hilos	16 GB	30 GB
Plataforma + labs pesados `08`, `11`, `12`	8 hilos o más	24 GB+	40 GB

Nota: los escenarios de la tabla son simultáneos — reflejan la carga total cuando todos los servicios del escenario se ejecutan al mismo tiempo.

Opción A — Instalar desde fuente#

git clone https://github.com/vladimiracunadev-create/docker-labs.git
cd docker-labs

Windows#

scripts\start-control-center.cmd

Linux / macOS#

./scripts/start-control-center.sh

Levantar la plataforma principal#

docker compose -f 05-postgres-api\docker-compose.yml up -d --build
docker compose -f 09-multi-service-app\docker-compose.yml up -d --build
docker compose -f 06-nginx-proxy\docker-compose.yml up -d --build

Opción B — Instalar desde GitHub Releases (Windows)#

Descarga el instalador oficial desde la página de releases:

https://github.com/vladimiracunadev-create/docker-labs/releases/latest

El archivo se llama docker-labs-setup-{version}.exe

Ejecuta el instalador.

Si Windows SmartScreen muestra advertencia → "Más información" → "Ejecutar de todas formas".

Usa el acceso directo Docker Labs del menú de inicio o el escritorio.

El launcher verifica Docker Desktop, levanta los 4 servicios de la plataforma en paralelo y abre el browser automáticamente en http://localhost:9090.

Ver docs/windows-installer.md para instrucciones completas, troubleshooting y justificación de la falta de firma digital.

🔍 Verificación inicial#

Servicio	URL
Control Center	http://localhost:9090
Inventory Core	http://localhost:8000
Operations Portal	http://localhost:8083
Gateway	http://localhost:8085

⚡ Equipos con recursos limitados#

Si tu equipo tiene poca RAM o CPU disponible para Docker:

Deja solo el Control Center (9090) activo
Levanta un lab a la vez
Evita mezclar 08, 11 y 12 con la plataforma principal

Consulta docs/LABS_RUNTIME_REFERENCE.md para ver el costo de recursos por lab.

📝 Notas de distribución#

Punto	Detalle
Docker Desktop	El instalador no lo empaqueta — debe estar instalado previamente
Binario en el repo	El instalador final no se versiona dentro del repositorio
Canal oficial	GitHub Releases es la única fuente de descarga del binario
Firma digital	No se usa en v1.x — decisión explícita documentada en windows-installer.md