📦 Guía de instalación — WSL Container Center#

Versión: v1 · Estado: 🟢 Activo Audiencia: 👥 Todos Objetivo: Instalar y operar wsl-labs de punta a punta — WSL 2 + wslc + Node.js en Windows + repo + panel + casos de contenedores.

🗺️ Esquema#

flowchart LR
    A["1 · WSL 2<br/>wsl --install"] --> B["2 · wslc (motor)<br/>wsl --update --pre-release"]
    B --> C["3 · Node.js 18+<br/>en Windows"]
    C --> D["4 · Clonar repo<br/>wsl-labs"]
    D --> E["5 · make serve<br/>panel :9092"]
    E --> F["6 · Construir + Levantar casos<br/>📦 -> ▶ -> 🌐"]

✅ Requisitos#

Software#

Hardware recomendado#

Opción A — Instalar desde fuente#

Paso 1 — Instalar WSL 2#

wsl --install

Reinicia si es la primera vez. Después verifica:

wsl --status        # WSL en modo 2 por defecto
wsl -l -v           # tu distro con VERSION 2

Paso 2 — Habilitar el motor de contenedores wslc#

wslc (el motor de contenedores nativo de WSL, tipo Docker) llega con la versión preview de WSL:

wsl --update --pre-release
wsl --version

Verifica que el binario existe:

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

Paso 3 — Instalar Node.js 18+ en Windows#

Descárgalo de https://nodejs.org (LTS) y verifica en PowerShell:

node --version      # >= v18

Paso 4 — Clonar el repo#

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

Paso 5 — Arrancar el panel#

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

Abre → http://localhost:9092.

Paso 6 — Construir y levantar casos desde el panel#

Por cada caso que quieras usar:

1. Si usa imagen custom y aparece Imagen sin construir, pulsa 📦 Construir.
2. Pulsa ▶ Levantar.
3. Verifica que pasa a ✅ running y pulsa 🌐 Abrir.

Eso es todo: el flujo estilo Docker es 📦 Construir → ▶ Levantar → 🌐 Abrir. Los casos con imágenes públicas (redis, postgres, jenkins…) van directo a ▶ Levantar.

Opción B — Operar por terminal con wslc#

Alternativa sin panel, ejecutando wslc a mano. Ejemplo con el caso 01 API Node.js (imagen custom, contexto containers/01-node-api):

# (1) Construir la imagen del caso
& "C:\Program Files\WSL\wslc.exe" build -t wsl-labs/node-api:latest containers/01-node-api

# (2) Levantar el contenedor
& "C:\Program Files\WSL\wslc.exe" run -d --name wslc-node-api -p 8101:3000 wsl-labs/node-api:latest

# (3) Comprobar
Invoke-WebRequest http://localhost:8101 -UseBasicParsing

# (4) Bajar
& "C:\Program Files\WSL\wslc.exe" stop wslc-node-api
& "C:\Program Files\WSL\wslc.exe" rm   wslc-node-api

Opción C — Launcher / instalador Windows#

1. Descarga el instalador desde

GitHub Releases. El archivo se llama wsl-labs-setup-<version>.exe (construido con Inno Setup).

1. Ejecuta el instalador. Si SmartScreen avisa → "Más información" → "Ejecutar de todas formas".
2. Usa el acceso directo wsl-labs. El launcher (wsl-labs-launcher.exe, compilado

desde launcher/windows/main.go) verifica WSL 2, arranca el panel y abre el navegador en http://localhost:9092.

🔍 Verificación inicial#

Comprobación del motor y del catálogo:

& "C:\Program Files\WSL\wslc.exe" version
Invoke-RestMethod http://localhost:9092/api/wslc/overview

⚡ Equipos con recursos limitados#

• Deja solo el panel (9092) arriba y levanta un caso a la vez.
• Empieza por los starter (node, python, go, nginx): una sola imagen ligera.
• Evita 11 Elasticsearch y 12 Jenkins salvo que tengas 16 GB+ de RAM.
• Usa ⏹ Bajar para liberar contenedores; la imagen queda cacheada para relanzar.

📝 Notas de distribución#

🔗 Documentos relacionados#

• Requisitos
• Setup del panel
• Manual de usuario
• Track de contenedores WSLC
• Resolución de problemas
• ENVIRONMENT_SETUP.md
• RUNBOOK operativo