📘 Manual de Usuario — WSL Container Center#

Versión: v1 · Estado: 🟢 Operativo Audiencia: 👥 Operadores del panel, usuarios del día a día Objetivo: Operar el panel para construir, levantar, inspeccionar y bajar contenedores con wslc (el motor de contenedores nativo de WSL) desde Windows.

<!-- -->

🗺️ Esquema#

flowchart TD
    U["👤 Usuario"] --> BTN["Botón del panel<br/>📦 Construir · ▶ Levantar · ⏹ Bajar · 📄 Logs"]
    BTN --> API["POST /api/wslc/{build,up,down,logs}<br/>Panel :9092"]
    API --> WSLC["wslc.exe build / run / stop / rm / logs"]
    WSLC --> CT["Contenedor(es) wslc<br/>node · php · redis · postgres · nginx · …"]
    CT --> HEALTH["Health check http (IPv4 + IPv6)"]
    HEALTH --> UI["UI actualiza estado<br/>running · stopped · missing · degraded"]
    UI --> U

🧭 Flujo recomendado#

1. Abre el panel en http://localhost:9092
2. Elige un caso (por ejemplo, 01 API Node.js)
3. Si el caso usa imagen custom y aparece Imagen sin construir, pulsa 📦 Construir
4. Pulsa ▶ Levantar
5. Comprueba que el estado pasa a ✅ running
6. Pulsa 🌐 Abrir para verlo en el navegador
7. Revisa 📄 Logs si algo queda a medias
8. Pulsa ⏹ Bajar cuando termines

🧠 Diferencia clave#

Ejemplo: 06 Nginx web puede aparecer running en el panel, pero el sitio real lo ves en http://localhost:8104.

🐳 Catálogo de casos y puertos#

Los 12 casos vienen portados de docker-labs y están verificados corriendo con wslc. Se agrupan en tres categorías: starter, platform y infra.

🎯 Operación por casos#

Caso 1 — Construir la imagen de un caso custom#

1. Abre el panel → localiza la tarjeta (p. ej. 01 API Node.js).
2. Si el estado es Imagen sin construir, pulsa 📦 Construir.
3. El panel llama a POST /api/wslc/build, que ejecuta `wslc build -t <imagen>

<contexto> por cada imagen declarada del caso (contexto en containers/NN-*/`).

1. Al terminar verás [build <imagen>] OK en la salida.

Caso 2 — Levantar un caso#

1. Con la imagen ya construida (o si el caso usa imágenes públicas), pulsa ▶ Levantar.
2. El panel llama a POST /api/wslc/up. Por cada contenedor del caso ejecuta

wslc run -d --name … [-p …] [-e …] [--network …]. Si el caso define una red, el panel la crea antes con wslc network create.

1. El estado debería pasar a ✅ running en unos segundos.

Caso 3 — Abrir el caso en el navegador#

1. Con el caso running, pulsa 🌐 Abrir (o escribe la URL a mano).
2. Comprueba la respuesta:

Invoke-WebRequest http://localhost:8101 -UseBasicParsing

Caso 4 — Ver logs#

1. Pulsa 📄 Logs en la tarjeta del caso.
2. El panel llama a POST /api/wslc/logs, que hace `wslc logs <contenedor

principal>` y devuelve las últimas líneas. El contenedor "principal" es el que publica el puerto del caso.

Caso 5 — Bajar un caso#

1. Pulsa ⏹ Bajar.
2. El panel llama a POST /api/wslc/down: hace wslc stop + wslc rm de cada

contenedor del caso y, si el caso tiene red propia, wslc network rm.

1. El estado pasa a ⏹ stopped. La imagen construida permanece en

wslc images, lista para volver a levantar sin reconstruir.

Caso 6 — Verificar el estado global#

# Estado de los 12 casos + disponibilidad del motor wslc
Invoke-RestMethod http://localhost:9092/api/wslc/overview

📊 Tabla de estados#

El panel clasifica cada caso así:

🔌 La API REST (ejemplos PowerShell)#

El panel expone una API sencilla en 127.0.0.1:9092. Todo lo que hacen los botones puedes hacerlo con Invoke-RestMethod. Las acciones POST reciben el id del caso.

Autenticación (opcional)#

Por defecto la API está abierta en modo local. Si defines WSL_LABS_TOKEN antes de arrancar el panel, cada llamada /api requiere el header Authorization: Bearer <token>.

# Cabeceras base (con token opcional)
$h = @{ 'Content-Type' = 'application/json' }
# $h['Authorization'] = 'Bearer <tu-token>'   # solo si activaste WSL_LABS_TOKEN

GET /api/wslc/overview — estado de todo el catálogo#

Invoke-RestMethod http://localhost:9092/api/wslc/overview

POST /api/wslc/build — construir la imagen de un caso#

Invoke-RestMethod -Method Post -Headers $h -Body '{ "id": "01" }' `
  http://localhost:9092/api/wslc/build

POST /api/wslc/up — levantar un caso#

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

POST /api/wslc/down — bajar un caso#

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

POST /api/wslc/logs — leer logs del contenedor principal#

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

✅ Buenas prácticas#

• Construye solo las imágenes de los casos que vayas a usar.
• Usa ▶ Levantar / ⏹ Bajar desde el panel en vez de manipular contenedores a mano.
• Si un caso queda degraded, refresca y mira 📄 Logs antes de reconstruir.
• ⏹ Bajar elimina los contenedores pero conserva la imagen: relanzar es rápido.
• Los casos pesados (11 Elasticsearch, 12 Jenkins) tardan más en pasar a

running: dales tiempo antes de darlos por fallidos.

• Repasa la Guía de resolución de problemas si un caso no levanta.

🔗 Documentos relacionados#

• README del proyecto
• Guía para principiantes
• Setup del panel
• Instalación completa
• Requisitos
• Resolución de problemas
• Track de contenedores WSLC
• RUNBOOK operativo