🧰 Referencia de la CLI de wslc#

Referencia completa de la línea de comandos de wslc (WSL Containers, WSL 2.9+), explorada a fondo sobre wslc 2.9.3. Para el enfoque general ver wslc-contenedores.md; para los casos de este repo, el catálogo de casos.

wslc es el motor de contenedores nativo de WSL. Su interfaz replica el subconjunto más usado de Docker. Binario: C:\Program Files\WSL\wslc.exe (se obtiene con wsl --update --pre-release).

🗺️ Estructura de la CLI#

flowchart TD
    W["wslc"] --> C["container"]
    W --> I["image"]
    W --> N["network"]
    W --> V["volume"]
    W --> R["registry"]
    W --> S["system → session"]
    W --> X["settings · version"]
    W -. "atajos de nivel superior" .-> AL["run · build · exec · logs · ps · pull · push · …"]

wslc tiene grupos de comandos (container, image, network, volume, registry, system) y atajos de nivel superior que apuntan a los subcomandos más habituales (por ejemplo wslc run == wslc container run, wslc build == wslc image build).

🐳 Contenedores (wslc container …)#

run — crear y arrancar un contenedor#

wslc run [opciones] <imagen> [comando] [args...]

# Ejemplo: nginx con límites de recursos y una red
wslc run -d --name web --network mi-red -p 8080:80 -m 256M --cpus 0.5 nginx:alpine

create / start / stop / kill / remove#

list — listar contenedores (alias ls, ps)#

wslc list [opciones]

wslc ps                 # contenedores en ejecución
wslc ps -a --format json # todos, en JSON (útil para scripts)

logs — ver logs#

wslc logs [opciones] <id\|nombre>

wslc logs -n 50 -t web

exec — ejecutar en un contenedor vivo#

wslc exec [opciones] <id\|nombre> <comando> [args...]

Opciones: -d, -e/--env, --env-file, -i/--interactive, -t/--tty, -u/--user, -w/--workdir.

wslc exec -it web sh              # shell interactiva dentro del contenedor
wslc exec web env                 # ver variables de entorno

attach / inspect / stats / export#

wslc stats -a           # uso de recursos de todos los contenedores

🖼️ Imágenes (wslc image …)#

build — construir desde un Dockerfile#

wslc build [opciones] <ruta-contexto>

wslc build -t wsl-labs/go-api:latest --target build containers/10-go-api

Resto de comandos de imagen#

🌐 Redes (wslc network …)#

wslc network create mi-red
wslc run -d --name db --network mi-red postgres:15
wslc run -d --name app --network mi-red -p 8000:8000 mi-app   # 'app' alcanza a 'db' por su nombre

💽 Volúmenes (wslc volume …)#

# Persistir los datos de una base de datos entre reinicios del contenedor
wslc volume create pgdata
wslc run -d --name db -v pgdata:/var/lib/postgresql/data postgres:15

🔑 Registro (wslc registry …)#

⚙️ Sistema y sesiones (wslc system session …)#

wslc corre los contenedores dentro de una sesión (una VM ligera de WSL, wslcsession.exe). Normalmente no hace falta gestionarla a mano.

wslc system session list   # p.ej.  Id 1 · wslc-cli-<usuario>

🔧 Otros#

🔀 Equivalencias wslc ↔ docker (resumen)#

🧭 Qué comandos usa el panel de wsl-labs#

El Control Center traduce cada botón a comandos wslc:

🔗 Ver también#

• 🚚 Portabilidad — mover imágenes y volúmenes a otro equipo
• 🐳 Guía de contenedores con WSLC
• 📚 Catálogo de casos
• 🧾 Referencia de runtime por caso
• 🕰️ Historia y referencia de WSL
• 📁 README del repositorio