Saltar al contenido principal

Instalar Docker Engine en Ubuntu

Advertencia: No use apt para instalar Docker en Ubuntu. Siempre siga las instrucciones a continuación para configurar correctamente el repositorio APT de Docker antes de intentar instalar Docker.

Prerrequisitos​

Requisitos del sistema operativo​

Docker es compatible con las siguientes versiones de Ubuntu:

  • Ubuntu Mantic 23.10
  • Ubuntu Jammy 22.04 (LTS)
  • Ubuntu Focal 20.04 (LTS)

Docker se puede instalar en plataformas de 64 bits x86 o en plataformas ARM. Se recomiendan las versiones LTS (soporte a largo plazo) de Ubuntu para entornos de producción, ya que reciben 5 años de actualizaciones de seguridad.

Desinstalar versiones antiguas​

Las versiones anteriores de Docker se llamaban docker o docker-engine. Si están instaladas, primero desinstálelas:

$ for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker; do sudo apt-get remove $pkg; done

Además, Docker Engine depende de containerd y runc. Desinstálelos también para evitar conflictos:

$ sudo apt-get remove containerd runc

Instalar usando el repositorio APT​

Configurar el repositorio APT de Docker​

Actualice el índice de paquetes apt e instale paquetes para permitir que apt utilice un repositorio a través de HTTPS:

# Agregar la clave GPG oficial de Docker:
sudo apt-get update
sudo apt-get 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

# Agregar el repositorio a las fuentes de Apt:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Si usa una distribución derivada de Ubuntu, como Linux Mint, es posible que necesite usar UBUNTU_CODENAME en lugar de VERSION_CODENAME.

Instalar paquetes Docker​

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

Instalar usando el script de conveniencia​

Docker proporciona un script de conveniencia para agilizar el proceso de instalación en entornos de prueba y desarrollo. En Ubuntu, puede usar este script y opcionalmente usar la bandera --mirror para instalar desde un repositorio espejo:

# $ curl -fsSL test.docker.com -o get-docker.sh
$ curl -fsSL get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh --mirror Aliyun
# $ sudo sh get-docker.sh --mirror AzureChinaCloud

Este script se encargará automáticamente de todos los requisitos previos e instalará la última versión estable de Docker.

Iniciar Docker​

$ sudo systemctl enable docker
$ sudo systemctl start docker

Administrar Docker como un usuario no root​

Por defecto, el comando docker utiliza el socket Unix para comunicarse con el motor de Docker. Solo root y los usuarios del grupo docker pueden acceder al socket Unix.

Para evitar usar root, cree un grupo docker y agregue su usuario a él:

$ sudo groupadd docker
$ sudo usermod -aG docker $USER

Cierre sesión y vuelva a iniciarla para que los cambios surtan efecto.

Probar la instalación de Docker​

$ docker run --rm hello-world

Incapaz de encontrar la imagen 'hello-world:latest' localmente
latest: Extrayendo de library/hello-world
b8dfde127a29: Extracción completa
Digest: sha256:308866a43596e83578c7dfa15e27a73011bdd402185a84c5cd7f32a88b501a24
Estado: Imagen más nueva descargada para hello-world:latest

¡Hola desde Docker!
Este mensaje muestra que su instalación parece estar funcionando correctamente.

...

Si ve el resultado anterior, Docker está instalado correctamente.

Referencias​