🛠️ RUNBOOK — WSL Container Center#

Guía operativa del día a día para construir, levantar, monitorear y bajar contenedores con wslc desde Windows. Para el setup inicial, consulta ENVIRONMENT_SETUP.md.

🩺 1 · Validar el motor antes de operar#

wsl --version
& "C:\Program Files\WSL\wslc.exe" version
node --version

Debes ver:

• ✅ WSL en versión 2.9+ (si no, wsl --update --pre-release)
• ✅ wslc version responde (motor de contenedores disponible)
• ✅ node --version ≥ 18 en Windows

🖥️ 2 · Levantar el panel#

cd C:\dev\wsl-labs
node dashboard-server/server.js
# o:
make serve

Abre → http://localhost:9092

▶️ 3 · Construir, levantar y bajar casos#

El flujo recomendado es 100 % desde el panel, sin contraseñas y sin terminal. El panel ejecuta wslc.exe en Windows (Windows ya autenticó al usuario), así que nunca pide contraseña.

1. Abre  →  http://localhost:9092
2. Pulsa 🔨 Construir  → construye la imagen del caso (solo si tiene Dockerfile)
3. Pulsa ▶ Levantar    → crea la red (si aplica) y arranca los contenedores
4. Pulsa 📄 Logs / 🛑 Bajar según lo necesites

Por API (modo dev, sin token)#

Cada caso se identifica por su id del catálogo:

$h = @{ 'Content-Type' = 'application/json' }

# Construir la imagen del caso 01
Invoke-RestMethod -Method Post -Headers $h -Body '{ "id": "01" }' http://localhost:9092/api/wslc/build

# Levantar el caso 01
Invoke-RestMethod -Method Post -Headers $h -Body '{ "id": "01" }' http://localhost:9092/api/wslc/up

# Ver logs del caso 01
Invoke-RestMethod -Method Post -Headers $h -Body '{ "id": "01" }' http://localhost:9092/api/wslc/logs

# Bajar el caso 01
Invoke-RestMethod -Method Post -Headers $h -Body '{ "id": "01" }' http://localhost:9092/api/wslc/down

Por terminal (make build-* / wslc directo)#

make build-node    # construye wsl-labs/node-api:latest
& "C:\Program Files\WSL\wslc.exe" run -d --name wslc-node-api -p 8101:3000 wsl-labs/node-api:latest

✅ 4 · Verificar salud#

# Estado global de todos los casos
Invoke-RestMethod http://localhost:9092/api/wslc/overview

# Respuesta real de un caso (p. ej. node-api en :8101)
Invoke-WebRequest http://localhost:8101 -UseBasicParsing

📡 5 · Casos y puertos#

⚡ 6 · Comandos wslc rápidos#

$wslc = "C:\Program Files\WSL\wslc.exe"

# Contenedores e imágenes
& $wslc list                 # contenedores (≈ docker ps)
& $wslc images               # imágenes locales

# Logs y ciclo de vida
& $wslc logs wslc-node-api
& $wslc stop wslc-node-api
& $wslc rm wslc-node-api

# Redes y volúmenes
& $wslc network ls
& $wslc volume ls

Atajos con make:

make ps        # wslc list
make images    # wslc images
make prune     # elimina contenedores parados + imágenes colgadas

🧹 7 · Limpieza#

$wslc = "C:\Program Files\WSL\wslc.exe"

# Bajar un caso concreto (desde el panel: botón 🛑 Bajar)
& $wslc stop wslc-node-api; & $wslc rm wslc-node-api

# Limpieza general
make prune                   # contenedores parados + imágenes colgadas
& $wslc network prune        # redes wslc sin usar

🚀 8 · Uso del launcher#

1. Ejecuta wsl-labs-launcher.exe (doble clic o desde PowerShell).
2. El launcher verifica WSL y localiza wslc.
3. Localiza la raíz del repo (directorio del .exe o WSL_LABS_HOME).
4. Arranca el panel (node dashboard-server/server.js) en segundo plano.
5. Hace polling a /api/wslc/overview.
6. Abre el navegador en http://localhost:9092.

🧪 9 · Verificación automatizada#

# desde la raíz del repo
node dashboard-server/verify-localhost.js
# o
make test-dashboard

🏗️ Criterio operativo#

📖 Ver también: ENVIRONMENT_SETUP.md · CONTRIBUTING.md · docs/wslc-contenedores.md