Laboratorio 01 - Instalación de Docker

En este laboratorio instalará Docker y verificará que el entorno pueda descargar imágenes, crear contenedores y ejecutar aplicaciones correctamente.

El procedimiento para Linux se concentra en Ubuntu. Los pasos de instalación pueden cambiar entre distribuciones y versiones debido a diferencias en repositorios, llaves y paquetes. Por esta razón, el laboratorio utiliza una versión de Ubuntu soportada por Docker y remite a la documentación oficial cuando se trabaja con otras distribuciones.

Lo que aprenderá en este laboratorio

Al finalizar podrá

• desinstalar versiones anteriores de Docker que puedan generar conflictos;
• configurar el repositorio oficial de Docker en Ubuntu;
• instalar Docker Engine, Docker CLI y los plugins oficiales;
• verificar la instalación mediante contenedores de prueba;
• ejecutar Docker sin utilizar sudo;
• instalar Docker Desktop en Windows con WSL 2.

Instalación en Ubuntu

Requisitos

Esta ruta requiere una versión de Ubuntu soportada por Docker Engine.

Versión de Ubuntu	Nombre código	Soporte
Ubuntu 25.10	Questing	Estándar
Ubuntu 25.04	Plucky	Estándar
Ubuntu 24.04	Noble	LTS
Ubuntu 22.04	Jammy	LTS

Nota. Docker puede funcionar en distribuciones derivadas de Ubuntu, como Linux Mint, aunque estas no cuentan con soporte oficial.

Desinstalar paquetes que puedan generar conflictos

Antes de instalar Docker desde el repositorio oficial, elimine los paquetes que puedan interferir con la nueva instalación.

Ejecute el siguiente comando.

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)

Nota. Es normal que apt indique que ninguno de estos paquetes está instalado. En ese caso, no se requiere ninguna acción adicional.

Importante. La desinstalación de Docker no elimina automáticamente las imágenes, los contenedores, los volúmenes ni las redes almacenadas en /var/lib/docker/. Si necesita eliminar también estos datos, deberá hacerlo de manera explícita.

Preparar dependencias y llaves

Actualice el índice de paquetes e instale las dependencias necesarias para acceder al repositorio oficial de Docker mediante HTTPS. Después, descargue y registre la llave GPG utilizada para verificar los paquetes.

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

Registrar el repositorio

Configure APT para utilizar el repositorio oficial de Docker correspondiente a su versión de Ubuntu.

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Actualice nuevamente el índice de paquetes para incorporar el repositorio.

sudo apt update

Sugerencia. La expresión UBUNTU_CODENAME con respaldo en VERSION_CODENAME permite obtener el nombre de la versión desde la información del sistema. Este mecanismo también puede funcionar en algunas distribuciones derivadas de Ubuntu.

Instalar Docker Engine

Instale Docker Engine, Docker CLI, containerd y los plugins oficiales de Buildx y Compose.

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Después de la instalación, el servicio de Docker normalmente inicia de forma automática.

Verificar el servicio

Compruebe que el servicio de Docker se encuentre activo.

sudo systemctl status docker

Si el servicio no está activo, inícielo manualmente.

sudo systemctl start docker

Ejecutar un contenedor de prueba con hello-world

La primera prueba permite verificar el funcionamiento básico de Docker. El comando comprueba que el cliente puede comunicarse con el daemon, descargar una imagen y ejecutar un contenedor.

sudo docker run hello-world

La imagen hello-world fue diseñada específicamente para realizar esta verificación.

Realizar una segunda prueba con Python

La siguiente prueba utiliza una imagen de Python y se acerca más a la ejecución habitual de una aplicación dentro de un contenedor.

sudo docker run --rm -it python:3.12 python -c "for i in range(1, 11): print(i)"

Docker descargará la imagen oficial de Python si todavía no está disponible localmente. Después iniciará un contenedor y ejecutará el programa indicado. La opción --rm elimina el contenedor cuando termina la ejecución y -it habilita una sesión interactiva.

Si aparecen en pantalla los números del 1 al 10, Docker pudo descargar la imagen, crear el contenedor y ejecutar el proceso correctamente.

Ejecutar Docker sin sudo

En la configuración inicial de Ubuntu, los comandos de Docker requieren privilegios elevados. Puede evitar el uso repetido de sudo agregando su usuario al grupo docker.

Advertencia de seguridad. Los miembros del grupo docker pueden obtener privilegios equivalentes a root. Utilice esta configuración únicamente cuando sea apropiada para su entorno.

Crear el grupo docker si no existe

sudo groupadd docker

Agregar el usuario actual al grupo

sudo usermod -aG docker $USER

Aplicar los cambios

Cierre la sesión y vuelva a iniciarla para que el sistema reconozca la nueva membresía del grupo.

Si necesita aplicar el cambio únicamente en la terminal actual, puede ejecutar el siguiente comando.

newgrp docker

Confirmar la membresía y probar Docker

Compruebe primero los grupos asociados con su usuario y después ejecute nuevamente el contenedor de prueba, esta vez sin sudo.

groups
docker run hello-world

Si hello-world se ejecuta correctamente, la configuración permite utilizar Docker con el usuario actual.

Instalación en Windows con WSL 2

En Windows, Docker Desktop puede utilizar WSL 2 como backend para ejecutar contenedores Linux. Esta integración proporciona el entorno Linux necesario sin requerir una instalación independiente de Docker Engine dentro de la distribución WSL.

Requisitos

Componente	Especificación
Sistema operativo	Windows 11 o Windows 10 22H2 (Enterprise, Pro o Education), 64 bits
WSL	WSL 2 instalado y actualizado
Virtualización	Habilitada en BIOS o UEFI
Memoria RAM	Mínimo 4 GB

Nota. Los requisitos de Docker Desktop pueden cambiar entre versiones. Consulte la documentación oficial de Docker Desktop antes de realizar la instalación.

Importante. Para evitar conflictos, elimine cualquier instalación de Docker Engine o Docker CLI realizada directamente dentro de sus distribuciones WSL antes de instalar Docker Desktop. La documentación oficial de Docker sobre WSL 2 explica esta configuración con mayor detalle.

Instalar o actualizar WSL 2

Abra PowerShell como administrador y ejecute el siguiente comando.

wsl --install

Reinicie el equipo si Windows lo solicita. Después, actualice WSL.

wsl --update

También puede establecer WSL 2 como versión predeterminada para nuevas distribuciones.

wsl --set-default-version 2

Verifique finalmente el estado de WSL y la versión utilizada por cada distribución instalada.

wsl --status
wsl -l -v

Descargar e instalar Docker Desktop

1. Descargue Docker Desktop para Windows desde la página oficial de Docker.
2. Durante la instalación, seleccione el uso de WSL 2 cuando el instalador presente esta opción.

Después de completar la instalación, abra Settings > General y compruebe que la opción Use WSL 2 based engine se encuentre activa. Luego abra Settings > Resources > WSL Integration y habilite la distribución que utilizará, por ejemplo Ubuntu.

Verificar la instalación

Desde PowerShell, compruebe que Docker y Docker Compose estén disponibles.

docker version
docker compose version

Ejecute después un contenedor de Python.

docker run --rm -it python:3.12 python -c "for i in range(1, 11): print(i)"

Si aparecen en pantalla los números del 1 al 10, Docker Desktop puede descargar imágenes y ejecutar contenedores correctamente.

Resolver el mensaje WSL 2 installation is incomplete

Si Docker Desktop muestra este mensaje o no inicia correctamente, actualice primero WSL.

wsl --update

Reinicie el equipo y compruebe después que la distribución utilice WSL 2.

wsl -l -v

Si trabaja con una versión antigua de Windows que no admite wsl --install, utilice la guía de instalación manual de WSL de Microsoft.

Nota. La instalación manual puede requerir habilitar los componentes Windows Subsystem for Linux y VirtualMachinePlatform mediante dism.exe, además de instalar la actualización correspondiente del kernel de WSL 2.

Lo que cubrió este laboratorio

En este laboratorio

• eliminó paquetes que podían generar conflictos en Ubuntu;
• configuró el repositorio oficial de Docker y su llave GPG;
• instaló Docker Engine, Docker CLI, Buildx y Compose;
• verificó la instalación mediante hello-world y un contenedor de Python;
• configuró el uso de Docker sin sudo;
• instaló y verificó Docker Desktop en Windows con WSL 2.

Referencias

Docker Engine en Linux

Distribución	Documentación
Ubuntu	Docker Docs - Install Docker Engine on Ubuntu
Debian	Docker Docs - Install Docker Engine on Debian
Fedora	Docker Docs - Install Docker Engine on Fedora
CentOS	Docker Docs - Install Docker Engine on CentOS

Docker Desktop en Windows

Recurso	Documentación
Instalación y requisitos	Docker Docs - Install Docker Desktop on Windows
Backend WSL 2	Docker Docs - Docker Desktop WSL 2 backend

WSL

Recurso	Documentación
Instalación de WSL	Microsoft Learn - Instalación de WSL
Instalación manual para versiones anteriores	Microsoft Learn - Instalación manual de WSL