Instalación de Docker en WSL 2: configuración del primer contenedor

Primero revise su PC

Docker Desktop con el backend WSL 2 necesita tres cosas, y saltarse esta verificación de dos minutos es como la gente pierde una noche. Primero, la versión de Windows: necesita Windows 10 versión 2004 o posterior, o Windows 11. Presione Win + R, escriba winver y presione Entrar para ver su versión exacta.

winver

En segundo lugar, la virtualización debe estar activada en BIOS o UEFI. Abra el Administrador de tareas, vaya a Rendimiento, luego a CPU y busque Virtualización: habilitada. Si dice Desactivado, ninguna configuración de software lo salvará; primero habilite Intel VT-x o AMD SVM en el BIOS. En tercer lugar, conserve unos 4 GB de RAM libres y unos cuantos GB de disco extra: WSL 2 y Docker comparten su máquina, no la reemplazan.

Instale WSL 2 antes que nada

La mayoría de las instalaciones fallidas de Docker en Windows fallan por una razón aburrida: el orden era incorrecto. Docker Desktop espera un WSL 2 funcional debajo, así que primero construya las bases. Abra PowerShell como administrador y ejecute un comando:

wsl --install

Deje que termine, luego reinicie la PC; el reinicio no es opcional, carga los componentes de virtualización. Después del reinicio, Ubuntu (la distribución predeterminada) finaliza su propia configuración y le pide que cree un nombre de usuario y contraseña de Linux.

Verifique que WSL 2 esté realmente listo

Antes de que Docker se acerque a la máquina, confirme la base con dos comandos:

wsl --status
wsl -l -v

Su distribución debería mostrar VERSIÓN 2 en la lista. Si muestra 1, configure la versión predeterminada y convierta la distribución como sugiere el resultado del comando:

wsl --set-default-version 2

Cada capa se prueba antes de que continúe la siguiente, de modo que si algo falla más tarde, sabrá exactamente qué capa es la responsable del problema.

Instale Docker Desktop en la parte superior

Descargue Docker Desktop solo desde docker.com: los sitios de descarga de terceros incluyen basura con instaladores populares. Ejecute el instalador y mantenga marcada la opción Usar WSL 2 en lugar de Hyper-V; en la mayoría de las PC está marcado de forma predeterminada.

Cuando el instalador lo solicite, déjelo cerrar y cierre su sesión o reinícielo si se le solicita. Docker agrega su cuenta de Windows al grupo local docker-users, y la membresía del grupo solo entra en vigencia al iniciar sesión nuevamente; esta es la verificación honesta que la mayoría de las guías omiten, y es la razón por la que Docker a veces se niega a iniciar hasta que usted cierra sesión y vuelve a iniciarla.

Inicie Docker Desktop y espere a que se establezca el icono de ballena en la bandeja del sistema y el panel informe Motor en funcionamiento. El primer comienzo es lento; dale un par de minutos. Acepte honestamente la pantalla del Acuerdo de servicio de suscripción de Docker: es una licencia real.

Ejecute su primer contenedor: Hola mundo

Abra una nueva ventana de PowerShell o Terminal y ejecute los dos comandos que demuestran que toda la cadena funciona:

docker --version
docker run hello-world

docker --version demuestra que el cliente está instalado y en su RUTA. docker run hello-world demuestra todo lo demás: Docker no puede encontrar la imagen localmente, la descarga de Docker Hub, crea un contenedor a partir de ella, la ejecuta e imprime su mensaje ¡Hola desde Docker!. Si aparece ese mensaje, su cadena funciona de extremo a extremo: terminal, cliente, motor dentro de WSL 2, red y registro.