🎓 Guía para principiantes — WSL Container Center#

Versión: v1 · Guía pensada para quien empieza con contenedores, wslc y este repositorio.

🗺️ Esquema#

graph TD
    subgraph START["🌱 Starter"]
        S1["01 · API Node.js"]
        S2["03 · API Python"]
        S3["10 · API Go"]
        S4["06 · Nginx web"]
    end
    subgraph PLAT["🧩 Platform"]
        P1["04 · Redis + app"]
        P2["05 · API + PostgreSQL"]
        P3["02 · LAMP"]
        P4["09 · Multi-servicio (Mongo)"]
    end
    subgraph INFRA["🏗️ Infra"]
        I1["07 · RabbitMQ"]
        I2["08 · Prometheus + Grafana"]
        I3["11 · Elasticsearch"]
        I4["12 · Jenkins"]
    end
    START --> PLAT --> INFRA

🧭 Si solo lees una cosa#

Empieza así:

1. Instala WSL 2 (wsl --install) y habilita el motor de contenedores:

wsl --update --pre-release.

1. Instala Node.js 18+ en Windows y arranca el panel: make serve

(o node dashboard-server/server.js).

1. Abre el panel en http://localhost:9092.
2. Elige un caso starter → 📦 Construir → ▶ Levantar.
3. Pulsa 🌐 Abrir para verlo en el navegador.
4. Cuando termines, ⏹ Bajar.

Documentos relacionados:

• Instalación completa
• Manual de usuario
• Requisitos

🐳 ¿Qué es un contenedor?#

Un contenedor es una unidad ligera y aislada que empaqueta una app con todo lo que necesita para correr (código, runtime, librerías), a partir de una imagen. Se crea, se ejecuta y se descarta sin "ensuciar" el sistema anfitrión — a diferencia de instalar un programa directamente en el sistema operativo.

Piensa en dos piezas:

• Imagen — la plantilla inmutable (p. ej. nginx:alpine, o una custom construida

desde un Dockerfile).

• Contenedor — una instancia en ejecución de esa imagen, con sus puertos publicados.

🐳 ¿Qué es wslc?#

WSLC es el motor de contenedores nativo de WSL que Microsoft añadió a partir de WSL 2.9+ (en preview). Se maneja con el comando wslc (ejecutable en C:\Program Files\WSL\wslc.exe) y su interfaz es casi idéntica a la de Docker: wslc build / run / images / list / logs / stop / rm / network.

Para obtener wslc:

wsl --update --pre-release
& "C:\Program Files\WSL\wslc.exe" version

🧱 Qué es este repositorio#

wsl-labs es un panel para levantar y controlar contenedores con wslc. Tiene tres piezas:

Los 12 casos se agrupan en tres categorías:

• 🌱 starter — un contenedor, imagen custom, arranque simple (01, 03, 06, 10).
• 🧩 platform — app custom + dependencia sobre una red wslc (02, 04, 05, 09).
• 🏗️ infra — imágenes públicas de infraestructura (07, 08, 11, 12).

🧠 Panel vs contenedor#

Esta es la confusión más común al inicio:

Ejemplo:

• 06 Nginx web puede aparecer running en el panel.
• El sitio real lo abres en http://localhost:8104.

Por eso el panel separa el estado (¿está corriendo y sano?) del botón Abrir (entrar al contenedor real).

🚀 Primer flujo recomendado#

Paso 1 — Verifica los prerrequisitos#

wsl --status                                     # WSL en modo 2
node --version                                   # Node 18+ en Windows (para el panel)
& "C:\Program Files\WSL\wslc.exe" version        # motor wslc disponible

Necesitas como mínimo:

• Windows 10 (2004+) o Windows 11 con WSL 2.9+ y wslc
• Node.js 18+ en Windows (no dentro de WSL)

Paso 2 — Levanta el panel#

make serve
# o:
node dashboard-server/server.js

Paso 3 — Entra al panel#

Abre http://localhost:9092.

Paso 4 — Elige un caso simple#

Pulsa 📦 Construir → ▶ Levantar y luego 🌐 Abrir.

Paso 5 — Observa estas piezas#

Cada vez que levantes un caso, intenta responder:

• si usa imagen custom (hay que construir) o pública (va directo a levantar)
• qué puerto publica
• si es un solo contenedor o varios sobre una red wslc
• cómo se ve su estado en el panel (running / stopped / degraded…)
• cuál es su URL real en localhost

📚 Ruta de aprendizaje (starter → platform → infra)#

El catálogo está pensado para subir de dificultad. Empieza por los starter y ve sumando complejidad.

🌱 Nivel 1 — Starter (un contenedor)#

🧩 Nivel 2 — Platform (multi-contenedor + red)#

🏗️ Nivel 3 — Infra (imágenes públicas)#

💻 Recomendación de hardware#

⚠️ Errores comunes#

El panel abre, pero el caso no#

Posibles causas:

• la imagen custom no está construida (📦 Construir primero)
• el contenedor no está levantado (▶ Levantar)
• el puerto está ocupado por otra app en Windows

El panel dice "unavailable"#

wslc no está disponible. Actualiza WSL con wsl --update --pre-release, reinicia con wsl --shutdown y comprueba & "C:\Program Files\WSL\wslc.exe" version.

Un caso queda "degraded" un rato#

El contenedor arrancó pero su proceso interno aún no responde. Refresca el panel; pasará a running. Los casos infra (Elasticsearch, Jenkins) tardan más. Si persiste, revisa la Guía de resolución de problemas.

✅ Objetivo de esta guía#

Que puedas pasar de:

• "no sé qué es un contenedor ni qué es wslc"

a:

• "sé construir imágenes, levantar y abrir contenedores reales en localhost con wslc,

y entiendo la diferencia entre starter, platform e infra".

🔗 Documentos relacionados#

• ¿Qué es WSL?
• WSL vs Docker vs VM
• Track de contenedores WSLC
• Manual de usuario
• Setup del panel
• Resolución de problemas