Solución al fallo de inicialización de Docker Desktop vinculado a la Plataforma de Máquinas Virtuales y WSL2

Análisis de la traza de error

Al ejecutar Docker Desktop en sistemas operativos Windows, la capa de aislamiento se compila sobre una distribución Linux bajo el protocolo WSL2. Cuando el motor falla al registrar el entorno virtualizado, el registro entrega advertencias de nivel crítico como HCS_E_HYPERV_NOT_INSTALLED, evidenciando que el kernel no puede instanciar la máquina por la desactivación de componentes de virtualización o por una gestión incorrecta del hipervisor en la tabla BCD.

deploying WSL2 distributions
ensuring main distro is deployed: deploying "docker-desktop": importing WSL distro "Current computer configuration does not support WSL2... HCS_E_HYPERV_NOT_INSTALLED"

Activación de subsistemas de virtualización

La infraestructura requiere que ciertas capas del núcleo estén expuestas al espacio de usuario. Proceda mediante la interfaz gráfica del sistema:

  1. Navegue a Panel de Control > Programas > Activar o desactivar funciones de Windows.
  2. Marque las casillas correspondientes a: Plataforma de máquina virtual y Hipervisor de plataforma de máquina virtual.
  3. Confirme los permisos, aplique los cambios y reinicie la estación de trabajo.

Diagnóstico y ajuste del ciclo de arranque del hipervisor

En ocasiones los componentes permanecen instalados pero el gestor de configuración del sistema impide su carga automática. Utilice un terminal elevadle para validar y corregir esta variable.

Ejecute la seucencia reestructurada que incluye validación de estado y aplicación condicional:

# Verificar parámetro de arranque
$bcdResult = bcdedit /enum | Select-String -Pattern "hypervisorlaunchtype"
$hvStatus = $bcdResult.Line.ToLower()

# Aplicar corrección si se detecta modo manual o deshabilitado
if ($hvStatus -match "off") {
    Write-Host "[CORRECCIÓN] Hipervisor detectado como desactivado. Estableciendo modo automático..."
    bcdedit /set hypervisorlaunchtype auto
    Write-Host "Se requiere reinicio del sistema para que los cambios surtan efecto."
} else {
    Write-Host "[VERIFICACIÓN] Configuración del hipervisor operativa."
}

# Consultar lista de distribuciones instaladas
wsl --list --verbose

Posterior al reinicio, ejecute nuevamente el comando de listado. Si aparece una base (ej. Ubuntu), migrarla explícitamente al protocolo versión 2:

wsl --set-version Ubuntu 2

Si el sistema retorna vacío, invoque el instalador oficial para provisionar la capa requerida:

wsl --install --default

Cuando la descarga finalice, confirme que la columna Versión muestre 2. En este instante Docker podrá crear sus metadatos y levantar el daemon.

Comandos de administración del subsistema

  • Estado integral del entorno: wsl --status
  • Forzar cierre de procesos activos: wsl --shutdown
  • Reparar tabla de resolución de red: netsh winsock reset
  • Sincronizar manifiestos y binarios: wsl --update
  • Fijar versión por defecto para nuevos despliegues: wsl --set-default-version 2
  • Convertir distribución específica al modelo genérico: wsl --set-version [NombreDistri] 2

Etiquetas: Docker-Desktop wsl2 Hipervisor-Windows bcdedit Virtualización-Máquinas

Publicado el 8-19 21:06