Instalar Docker

Antes de empezar

Los pasos de instalación varían según la plataforma de desarrollo y la distribución Linux de producción. El Docker client puede correr en Linux, Windows y macOS, pero los Linux containers solo se construyen y lanzan en un sistema Linux. Por eso, en Windows y macOS necesitas o una VM o un server remoto que aloje el Docker server. Docker Desktop, Docker Community Edition y Vagrant son las tres formas principales de resolver esto.

Docker Client

El Docker client soporta nativamente versiones 64-bit de Linux, Windows y macOS. La mayoría de las distribuciones Linux populares vienen de Debian (usa apt) o Red Hat (usa rpm + yum/dnf). Alpine Linux, popular en containers por su tamaño mínimo, usa apk. En macOS y Windows hay installers GUI y también package managers populares (Homebrew y Chocolatey).

Linux

Recomendado usar una release moderna. Kernel 3.8+ mínimo, idealmente la última stable de tu distribución preferida. Las instrucciones asumen Ubuntu 22.04 o Fedora 36.

Ubuntu 22.04 (64-bit)

# Limpia versiones antiguas
sudo apt-get remove docker docker.io containerd runc
sudo apt-get remove docker-engine

# Instala dependencias y añade el repo de Docker
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) \
signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" \
| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Instala Docker
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io \
  docker-compose-plugin

Fedora 36 (64-bit)

# Limpia versiones antiguas
sudo dnf remove -y docker docker-client docker-client-latest \
  docker-common docker-latest docker-latest-logrotate \
  docker-logrotate docker-selinux docker-engine-selinux \
  docker-engine

# Añade el repo
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo \
  https://download.docker.com/linux/fedora/docker-ce.repo

# Instala Docker
sudo dnf install -y docker-ce docker-ce-cli containerd.io \
  docker-compose-plugin

macOS

Docker Desktop (GUI installer)

Descarga el instalador de Docker Desktop para Mac, doble clic y sigue los prompts. Docker Desktop para macOS usa xhyve y el Apple Hypervisor framework para dar una capa de virtualización ligera que provee el Linux server component necesario para construir imágenes y correr containers.

Homebrew

brew install --cask docker

Windows 11

Docker Desktop para Windows puede usar Hyper-V para virtualizar el Linux server, pero WSL2 da la mejor experiencia para Linux containers.

# Descarga el instalador de Docker Desktop para Windows
# Doble clic y sigue los prompts

# Para instalar el CLI via Chocolatey (opcional):
choco install docker-desktop

Cambiar entre Linux y Windows containers

Por defecto, Docker Desktop en Windows viene configurado para Linux containers. Si ves un error como “no matching manifest for windows/amd64”, está en modo Windows containers. Click derecho en el icono de Docker en la taskbar → “Switch to Linux containers…”.

Servidor en VM Linux (Vagrant)

Si no puedes usar Docker Desktop (versión vieja de Windows, no quieres Hyper-V, etc.), puedes usar Vagrant para crear y gestionar la VM Linux que correrá el Docker server. Vagrant funciona sobre varios hypervisors:

Ejemplo de Vagrantfile que crea un host Docker con Ubuntu 22.04:

$script = <<-SCRIPT
echo '{"hosts": ["tcp://0.0.0.0:2375", "unix:///var/run/docker.sock"]}' \
  | sudo tee /etc/docker/daemon.json
sudo mkdir -p /etc/systemd/system/docker.service.d
echo -e "[Service]\nExecStart=\nExecStart=/usr/bin/dockerd" \
  | sudo tee /etc/systemd/system/docker.service.d/docker.conf
sudo systemctl daemon-reload
sudo systemctl restart docker
SCRIPT

Vagrant.configure(2) do |config|
  config.vm.box = 'bento/ubuntu-22.04'
  config.vm.provision :docker
  config.vm.provision "shell", inline: $script, run: "always"
  config.vm.network "forwarded_port",
    guest: 2375, host: 12375, protocol: "tcp", auto_correct: true
end

Arranca la VM y configura el contexto de Docker:

vagrant up
docker context create vagrant --docker host=tcp://127.0.0.1:12375
docker context use vagrant
docker version
# Cuando termines:
vagrant halt
docker context use default

Docker Server

El Docker server es un binario separado del client. Si usaste Docker Desktop o Community Edition, el server ya está configurado. Solo asegúrate de que esté corriendo. En Windows y macOS, eso es arrancar la app de Docker. En Linux con systemd:

sudo systemctl enable docker
sudo systemctl start docker

Testear el setup

Una vez tengas client y server funcionando, testea que todo se comunica bien. Lanza un container basado en una imagen oficial y entra a una shell:

# Ubuntu
docker container run --rm -ti docker.io/ubuntu:latest /bin/bash

# Fedora
docker container run --rm -ti docker.io/fedora:latest /bin/bash

# Alpine Linux
docker container run --rm -ti docker.io/alpine:latest /bin/sh

Si todo va bien, verás un prompt de root dentro del container (root@<hash>:# o /# para Alpine). Sale con exit. Esto demuestra que puedes correr containers basados en cualquier distribución Linux.

Explorando el Docker server

Aunque normalmente el server arranca automáticamente, ver el comando manual ayuda a entender qué pasa por debajo:

sudo dockerd \
  -H unix:///var/run/docker.sock \
  --config-file /etc/docker/daemon.json

El flag -H define dónde escucha el daemon (Unix socket), y --config-file apunta al archivo de configuración (por defecto /etc/docker/daemon.json).

El archivo de configuración del daemon es típicamente /etc/docker/daemon.json (o /containers/services/docker/rootfs/etc/docker/daemon.json en Docker Desktop). Puede estar vacío o casi vacío porque Docker usa defaults razonables. En Docker Desktop, edítalo desde Preferences → Docker Engine.

Próximos pasos

• 04-trabajar-con-imagenes-docker: anatomía de un Dockerfile, instrucciones clave (FROM, RUN, COPY, ENV, ARG, LABEL, USER, WORKDIR, CMD), build, run, build args, env vars como configuración, y custom base images.