Saltar al contenido

lección 2

Instalar Docker Desktop: tu fábrica de entornos

Setup paso a paso en Windows y Mac. Verificar la instalación y ejecutar tu primer hello-world.

50 min

Ha llegado el momento de instalar Docker en tu ordenador. Este es uno de esos momentos que recordarás en tu carrera: el día que dejaste de depender de "instalar cosas a mano" y empezaste a usar entornos reproducibles. Después de esta lección, tu portátil se convierte en una fábrica capaz de crear cualquier entorno de datos que necesites: PostgreSQL, Redis, Jupyter, Spark, Airflow — todo a un comando de distancia.

Docker Desktop es la aplicación oficial para Windows y Mac que incluye todo lo que necesitas: el Docker Engine (el motor que ejecuta contenedores), Docker CLI (los comandos de terminal), Docker Compose (para orquestar varios contenedores) y una interfaz gráfica opcional. En Mac, Docker usa una VM Linux ligera por debajo (porque los contenedores necesitan un kernel Linux). En Windows, usa WSL2 (Windows Subsystem for Linux). Tú no necesitas preocuparte por estos detalles — Docker Desktop se encarga de todo.

### Requisitos previos

  • 🟦 Windows: Windows 10 22H2 o superior, o Windows 11 23H2 o superior. Necesitas WSL2 habilitado (Docker Desktop te guía para activarlo si no lo tienes). Mínimo 8 GB de RAM.
  • 🍎 Mac: las tres últimas versiones mayores de macOS (consulta docs.docker.com/desktop/setup/install/mac-install para la lista actualizada). Funciona tanto en chips Intel como en Apple Silicon (M1/M2/M3/M4).
  • Al menos 8 GB de RAM total (Docker necesita 4 GB solo para él, y tu sistema necesita el resto).
  • Al menos 20 GB de espacio en disco (las imágenes Docker ocupan espacio).
  • Conexión a internet (para descargar Docker Desktop e imágenes).

### 🟦 Instalación en Windows

  1. 01.Ve a https://www.docker.com/products/docker-desktop/ y descarga Docker Desktop para Windows.
  2. 02.Ejecuta el instalador (.exe). Acepta las opciones por defecto. Si te pregunta por WSL2 backend, dile que sí.
  3. 03.Si WSL2 no está instalado, Docker te pedirá reiniciar el ordenador y seguir unas instrucciones. Hazlo — WSL2 es necesario.
  4. 04.Después de reiniciar, Docker Desktop se inicia automáticamente. Verás el icono de la ballena (🐳) en la barra de tareas.
  5. 05.Abre PowerShell y ejecuta: docker --version

Problema frecuente en Windows: si Docker Desktop falla al arrancar con un error de "hardware assisted virtualization", necesitas activar la virtualización (VT-x/AMD-V) en la BIOS/UEFI de tu ordenador. El proceso varía por fabricante: reinicia, entra en la BIOS (normalmente pulsando F2, F10 o DEL durante el arranque) y busca la opción de virtualización en la sección CPU/Advanced. Si no la encuentras, busca "[tu modelo de portátil] enable virtualization" en Google.

1# 🟦 Windows — Verificar instalación en PowerShell
2docker --version
3# Deberías ver algo como: Docker version 24.0.7, build afdd53b
4
5# Verificar que Docker Engine está corriendo
6docker info
7# Si ves información del sistema (Server Version, Storage Driver, etc.)
8# ¡Docker está funcionando correctamente!

Verificación en Windows PowerShell

### 🍎 Instalación en Mac

  1. 01.Ve a https://www.docker.com/products/docker-desktop/ y descarga Docker Desktop para Mac (elige Apple Silicon si tienes M1/M2/M3, o Intel si tienes un Mac más antiguo).
  2. 02.Abre el archivo .dmg descargado y arrastra Docker al directorio Applications.
  3. 03.Abre Docker desde Applications. La primera vez te pedirá permisos — concédelos.
  4. 04.Verás el icono de la ballena (🐳) en la barra de menú superior. Cuando esté quieto (no animado), Docker está listo.
  5. 05.Abre Terminal y ejecuta: docker --version
1# 🍎 Mac — Verificar instalación en Terminal
2docker --version
3# Deberías ver algo como: Docker version 24.0.7, build afdd53b
4
5# Verificar que Docker Engine está corriendo
6docker info
7# Si ves información del sistema, ¡Docker está funcionando!
8
9# También verifica docker-compose (viene incluido)
10docker compose version
11# Docker Compose version v2.23.0

Verificación en Mac Terminal

Si docker --version funciona pero docker info da un error como "Cannot connect to the Docker daemon", significa que Docker Desktop no está corriendo. Busca el icono de la ballena 🐳 en tu barra de tareas (Windows) o barra de menú (Mac). Si no está ahí, abre la aplicación Docker Desktop manualmente. Docker Engine necesita estar activo para ejecutar contenedores.

### Tu primer contenedor: hello-world

Ahora viene el momento mágico. Vamos a ejecutar tu primer contenedor. Docker tiene una imagen especial llamada "hello-world" que simplemente imprime un mensaje confirmando que todo funciona. Es el equivalente al "Hola Mundo" de cualquier lenguaje de programación, pero para contenedores.

1# Ejecuta tu primer contenedor (funciona igual en Windows y Mac)
2docker run hello-world
3
4# Verás algo como esto:
5# Unable to find image 'hello-world:latest' locally
6# latest: Pulling from library/hello-world
7# ...
8# Hello from Docker!
9# This message shows that your installation appears to be working correctly.

El momento mágico: tu primer contenedor Docker

Analicemos qué acaba de pasar con ese simple comando. Docker hizo CINCO cosas en cuestión de segundos: (1) Buscó la imagen "hello-world" en tu ordenador — no la encontró. (2) La descargó automáticamente de Docker Hub (el registro público). (3) Creó un contenedor nuevo a partir de esa imagen. (4) Ejecutó el programa dentro del contenedor. (5) El programa imprimió el mensaje y el contenedor se detuvo.

Los 5 pasos que Docker ejecuta con un simple "docker run"

### Configuración recomendada de Docker Desktop

Docker Desktop funciona bien con su configuración por defecto, pero hay un par de ajustes que recomiendo para que tu experiencia sea óptima. Abre Docker Desktop → Settings (la ruedecita ⚙️):

  • Resources → Memory: asigna al menos 4 GB (si tienes 16 GB de RAM, pon 6-8 GB).
  • Resources → CPUs: asigna al menos 2 CPUs (si tienes 8 cores, pon 4).
  • General → Start Docker Desktop when you sign in: activado (así siempre está listo).
  • General → Use Docker Compose V2: activado (es la versión moderna y más rápida).

Consejo de senior: Docker Desktop consume recursos incluso cuando no estás usando contenedores. Si tu portátil va lento o se calienta sin razón, revisa que no tengas contenedores olvidados corriendo (docker ps te lo dice). Cuando no trabajes con Docker, puedes cerrarlo — pero yo lo dejo siempre activo porque lo uso constantemente.

### Comandos esenciales que acabas de desbloquear

1# Estos comandos funcionan IGUAL en Windows PowerShell y Mac Terminal
2
3# Ver la versión de Docker instalada
4docker --version
5
6# Ver información completa del sistema Docker
7docker info
8
9# Ejecutar un contenedor
10docker run <imagen>
11
12# Ver contenedores que están corriendo AHORA MISMO
13docker ps
14
15# Ver TODOS los contenedores (incluyendo los parados)
16docker ps -a
17
18# Ver las imágenes descargadas en tu ordenador
19docker images

Los comandos Docker más básicos — tu vocabulario inicial

Estos 6 comandos son tu vocabulario básico. En la próxima lección los usaremos intensivamente para ejecutar contenedores reales: Python, Node.js y hasta un servidor de base de datos. Pero antes, asegúrate de que hello-world funcionó correctamente. Si ves el mensaje "Hello from Docker!", ya eres un usuario de Docker. Enhorabuena.

Consejo de senior: crea un alias mental — cada vez que pienses "necesito instalar X para probar algo", tu primer reflejo debe ser "¿existirá una imagen Docker de X?". La respuesta casi siempre es sí. Docker Hub tiene más de 100.000 imágenes oficiales y millones de imágenes de la comunidad.

## ejercicios

[01]

Verifica tu instalación

Genera la guía de verificación para un nuevo miembro del equipo. Usa la forma larga de cada comando (--version, no -v).

💡 Resultado esperado

=== Guía de verificación de Docker ===

Paso 1:
  Ejecuta: docker --version
Cargando editor...
[02]

Quiz: verdadero o falso

Cinco afirmaciones sobre Docker Desktop. Pon True o False en cada una.

💡 Resultado esperado

  VERDADERO  Docker Desktop incluye Docker Compose
  FALSO     Los contenedores Docker arrancan en minutos como las VMs
  VERDADERO  Docker Desktop en Windows usa WSL2 por defecto
  VERDADERO  Docker Hub es el registro público de imágenes
Cargando editor...
[03]

Calcula los recursos para Docker

Tu portátil tiene 16 GB de RAM y 8 CPUs. Si asignas el 50% a Docker, ¿cuánto le queda al sistema? Los valores deben ser enteros.

💡 Resultado esperado

Recurso    Docker     Sistema    Total     
----------------------------------------
RAM (GB)   8          8          16        
CPUs       4          4          8         
Cargando editor...

Regístrate para guardar tu progreso.

## comentarios

Reporta erratas, ayuda a otros o comparte tu opinión. Sé constructivo.

Inicia sesión para comentar y responder.

cargando comentarios...