0.2 · Instalar Docker y lanzar tu primer contenedor

Fundamentos

0.2Instalar Docker y lanzar tu primer contenedor

Objetivo: Instalar Docker en tu equipo y ejecutar tu primer contenedor con total confianza.
Tiempo estimado: 12 min · lectura autónoma · Si solo tienes 5 min: lee «Lo esencial en 30s» + el esquema.

Lo esencial en 30 segundos

  • Docker Desktop en Windows/macOS, Docker Engine en Linux (+ complemento Compose): usa los paquetes oficiales.
  • docker version + docker compose version validan la instalación; docker run hello-world valida la ejecución de extremo a extremo.
  • Retén el trío pull → run → ps: descargar, crear + arrancar, ver — toda la guía lo repite a gran escala.

Minicaso hilado — Idir prepara su equipo en Argel sin conflicto de daemon

Idir, devops junior en Argel, prepara su equipo Windows: en lugar de acumular instaladores, sigue el ritual. Instala Docker Desktop desde los paquetes oficiales (con WSL 2 y la virtualización activada en la BIOS), verifica con docker version y docker compose version, y luego lanza docker run hello-world: aparece el mensaje — cliente, daemon, registro y ejecución funcionan. Después lista con docker images y docker ps -a para leer lo que acaba de pasar, y luego limpia. Su terreno de juego está listo, sin un segundo motor en paralelo.

Caso autónomo de esta sección: reaparece en el curso, el esquema, el guion y el reto 48h de la sección 0.2.

1. ¿Qué hay que instalar?

En Windows y macOS se instala Docker Desktop (interfaz + motor + Compose incluido). En Linux se instala Docker Engine (paquetes oficiales) y luego el complemento Compose. En todos los casos, se verifica con docker version y docker compose version. Idir usa los paquetes oficiales (docs.docker.com), nunca un repositorio exótico, e instala un solo motor para evitar conflictos de daemon.

2. El ritual hello-world

docker run hello-world descarga una miniimagen de prueba, crea un contenedor, lo ejecuta (muestra un mensaje) y luego lo termina. Si aparece este mensaje, todo funciona: el cliente habla con el daemon, el registro responde, la ejecución marcha. Idir conserva hello-world como prueba de regresión: ante una futura avería, repite este ritual para aislar el problema.

3. Leer lo que acaba de pasar

docker images muestra la imagen descargada, docker ps -a el contenedor terminado. Retén el trío: pull (descargar), run (crear + arrancar), ps (ver). Todo el resto de la guía repite este trío a gran escala. Idir lee sus imágenes y sus contenedores tras cada lanzamiento: ver lo que se acaba de hacer es el reflejo básico.

Error frecuente de interpretación: «Instalo dos motores para comparar, olvido la virtualización y lanzo imágenes desconocidas desde el primer día». No, triple falta. Un solo motor: dos daemons en paralelo crean conflictos. En Windows, WSL 2 + virtualización BIOS activada, si no el motor no arranca. Y se empieza con hello-world, la imagen de prueba mínima — no con imágenes desconocidas de contenido ignorado.
Instalación verificada Instalar, verificar las versiones, lanzar hello-world: la base queda validada. Instalar Desktop/Engine Paquetesoficialesdocker version Instalaciónprobadadocker run hello-world Ejecuciónprobada
Instalar, verificar las versiones, lanzar hello-world: la base queda validada.
Versión en texto del esquema (SEO / lectores de pantalla / traducción): 1) Idir, devops junior en Argel, instala el paquete oficial correcto: Docker Desktop en Windows/macOS (con WSL 2 y virtualización BIOS en Windows), Docker Engine + complemento Compose en Linux — un solo motor, no dos. 2) Verifica la instalación con docker version y docker compose version. 3) Valida la ejecución con docker run hello-world (la miniimagen se descarga, el contenedor muestra su mensaje y luego termina), y lee el resultado con docker images y docker ps -a. Lección: este ritual también es la prueba de regresión que hay que repetir ante cada futura avería.

🔎 Ejemplo concreto — 🔎 Ejemplo concreto — Verificación completa

Idir valida su instalación de extremo a extremo con cuatro comandos.

docker version
docker compose version
docker run hello-world
docker ps -a

Lectura: los dos primeros comandos prueban la instalación, el tercero prueba la ejecución, el último muestra el contenedor terminado.

Lección: ante una futura avería, se repite este ritual para aislar el problema.

Vocabulario de la sección

Docker Desktop
La aplicación todo en uno (Windows/macOS): motor, Compose, interfaz.

Ejemplo sencillo: Idir la instala en su Windows con WSL 2.

Lo que no es: el motor Linux solo en línea de comandos.

Reflejo: Windows/macOS → Desktop primero.

Docker Engine
El motor en Linux: daemon + cliente en línea de comandos.

Ejemplo sencillo: Idir lo instalará más tarde en su servidor Linux con el complemento Compose.

Lo que no es: la interfaz gráfica Desktop.

Reflejo: Linux → Engine + complemento Compose.

hello-world
La imagen de prueba mínima que valida la instalación.

Ejemplo sencillo: Idir la lanza primero y conserva el comando como prueba de regresión.

Lo que no es: una imagen de aplicación para mantener en producción.

Reflejo: avería sospechosa → repetir hello-world.

Daemon
El servicio de fondo que ejecuta realmente los contenedores.

Ejemplo sencillo: Idir comprende que su docker run hello-world fue ejecutado por el daemon.

Lo que no es: el comando tecleado.

Reflejo: motor que no arranca → virtualización y daemon primero.

Cliente
El comando docker que dialoga con el daemon.

Ejemplo sencillo: Idir escribe docker version: el cliente interroga al daemon.

Lo que no es: el servicio que ejecuta los contenedores.

Reflejo: el cliente ordena, el daemon ejecuta.

En la práctica — En la práctica — Instalar y validar

  1. Instala Docker Desktop (o Engine + Compose en Linux), como Idir, desde los paquetes oficiales.
  2. Lanza docker version y docker compose version.
  3. Ejecuta docker run hello-world y lee el mensaje.
  4. Lista imágenes y contenedores (images, ps -a), y luego limpia.
Tu equipo ejecuta contenedores: el terreno de juego está listo.

Guion paso a paso — instalar y validar como Idir (10 min)

1) Instala el paquete oficial: Docker Desktop en Windows/macOS (activa WSL 2 + virtualización BIOS en Windows) o Engine + complemento Compose en Linux. 2) Escribe docker version y luego docker compose version: ambos responden. 3) Escribe docker run hello-world: lee el mensaje de validación. 4) Escribe docker images y luego docker ps -a: localiza la imagen hello-world y su contenedor terminado. 5) Limpia el contenedor de prueba y conserva la secuencia: es tu prueba de regresión.

Si el motor no arranca en Windows, controla WSL 2 y la virtualización antes que todo lo demás.

Modelo copiar-pegar — mi lista de instalación

docker version
docker compose version
docker run hello-world
docker images
docker ps -a
# OK si : versions affichées + message hello-world + image et conteneur listés.

Equipo Windows

Idir en Windows: Docker Desktop + WSL 2 + virtualización BIOS activada, y luego el ritual hello-world.

Equipo macOS

Colega de Idir en Mac: Docker Desktop, mismos cuatro comandos de validación.

Servidor Linux

Idir en Linux: Docker Engine vía paquetes oficiales + complemento Compose, mismas verificaciones.

Futura avería

El motor parece roto dentro de un mes: Idir repite docker run hello-world para aislar cliente, daemon, registro y ejecución.

✓ Buenas prácticas

  • Usa los paquetes oficiales (docs.docker.com), no los repositorios exóticos.
  • Activa el arranque de Docker Desktop si es necesario.
  • Conserva hello-world como prueba de regresión.

✗ Errores frecuentes

  • Instalar dos motores en paralelo (conflictos de daemon).
  • Olvidar la virtualización activada en la BIOS (Windows).
  • Lanzar imágenes desconocidas desde el primer día.

Puntos clave

  • Desktop en Windows/macOS, Engine en Linux.
  • docker version valida la instalación.
  • docker run hello-world valida la ejecución.
  • pull → run → ps: el trío básico.

Reto 48h — aplica mañana

Ejecuta la lista del modelo en tu equipo como Idir: instala el paquete oficial, muestra las dos versiones, lanza hello-world y luego lista con images y ps -a.

Lista de salida de la sección
  • Docker está instalado desde los paquetes oficiales (Desktop o Engine + Compose).
  • docker version y docker compose version responden.
  • docker run hello-world muestra su mensaje y leo el resultado con images y ps -a.
Autoevaluación 1-5: ¿sé decir lo que prueba cada comando del ritual?Autoevaluación 1-5: ¿mi equipo está listo y limpio (un solo motor, prueba superada)?

Preguntas frecuentes

¿Docker Desktop es gratuito?

Para uso personal, aprendizaje y pequeñas estructuras, sí. Las grandes empresas deben verificar la suscripción. En Linux, el motor sigue siendo libre — Idir aprende así sin pagar.

¿WSL 2 es obligatorio en Windows?

Sí, Docker Desktop se apoya en él: instala WSL 2 y activa la virtualización, si no el motor no arranca. Es el primer control de Idir cuando Desktop se niega a lanzarse.

Comprueba tu comprensión

¿Qué prueba un «docker run hello-world» que muestra su mensaje?

Recursos adicionales (opcional, para ir más allá)

Examen del nivel 0Preguntas inéditas y más difíciles para validar tus conocimientos