DEV Community

Horacio Degiorgi
Horacio Degiorgi

Posted on

Setup de Servidor Docker en Debian/Ubuntu: 2 Discos, Rutas Dedicadas y Control de Espacio

Aquí tien

Cuando un servidor de contenedores colapsa, casi siempre se debe al mismo motivo: Docker llenó el disco raíz del sistema operativo.

Para evitarlo en entornos de producción o home labs serios, la mejor práctica es desacoplar el sistema operativo del almacenamiento de Docker y Containerd utilizando discos físicos dedicados.

A continuación, el paso a paso escueto y funcional para Debian/Ubuntu.


1. Esquema de Discos

  • Disco 1 (/dev/sda o nvme0n1): Sistema operativo montado en /.
  • Disco 2 (/dev/sdb o nvme1n1): Almacenamiento de contenedores, imágenes y volúmenes.

Preparación del Disco 2

Formateamos y montamos el segundo disco en /mnt/docker-data:

# Formatear a ext4 (o xfs)
sudo mkfs.ext4 -m 1 /dev/sdb

# Crear punto de montaje y registrar en /etc/fstab por UUID
sudo mkdir -p /mnt/docker-data
UUID_DISCO=$(sudo blkid -s UUID -o value /dev/sdb)
echo "UUID=${UUID_DISCO} /mnt/docker-data ext4 defaults,noatime 0 2" | sudo tee -a /etc/fstab

# Montar
sudo mount -a
Enter fullscreen mode Exit fullscreen mode

2. Instalación de Docker y Containerd

Instalación rápida desde los repositorios oficiales de Docker:

sudo apt-get update && sudo apt-get install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/$(. /etc/os-release && echo "$ID")/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/$(. /etc/os-release && echo "$ID") \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update && sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Enter fullscreen mode Exit fullscreen mode

Detener los servicios antes de reconfigurar rutas:

sudo systemctl stop docker containerd
Enter fullscreen mode Exit fullscreen mode

3. Configuración de Rutas de Almacenamiento

Creamos la estructura en el disco dedicado:

sudo mkdir -p /mnt/docker-data/docker
sudo mkdir -p /mnt/docker-data/containerd
Enter fullscreen mode Exit fullscreen mode

A. Configurar Containerd (/etc/containerd/config.toml)

Generamos la configuración por defecto (si no existe) y modificamos la directiva root:

sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml > /dev/null

# Cambiar la directiva 'root' al disco dedicado
sudo sed -i 's|^root = .*|root = "/mnt/docker-data/containerd"|' /etc/containerd/config.toml
Enter fullscreen mode Exit fullscreen mode

B. Configurar Docker (/etc/docker/daemon.json)

Definimos data-root hacia el segundo disco e incluimos rotación de logs local para evitar sorpresas:

{
  "data-root": "/mnt/docker-data/docker",
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "20m",
    "max-file": "3"
  }
}
Enter fullscreen mode Exit fullscreen mode

Nota: Guarda este archivo en /etc/docker/daemon.json (no .js).

C. Iniciar y validar servicios

sudo systemctl start containerd
sudo systemctl start docker

# Verificar que Docker use la nueva ruta:
docker info | grep "Docker Root Dir"
# Salida esperada: Docker Root Dir: /mnt/docker-data/docker
Enter fullscreen mode Exit fullscreen mode

4. Política de Control y Auditoría de Almacenamiento

El comando docker system df es útil, pero en sistemas con decenas de contenedores no permite discernir con facilidad qué contenedor activo está acumulando datos en su capa escribible vs. imágenes huérfanas o build cache.

Adoptamos como política el script de auditoría docker-df-report, que convierte la salida detallada de Docker en un reporte HTML interactivo.

Instalación de la herramienta

sudo mkdir -p /opt/docker-audit
sudo curl -fsSL https://gist.githubusercontent.com/horaciod/e5795255c6d9931e23a9530a7b4fadf9/raw -o /opt/docker-audit/report.py
sudo chmod +x /opt/docker-audit/report.py
Enter fullscreen mode Exit fullscreen mode

Automatización semanal (Cron)

Creamos una tarea en /etc/cron.weekly/docker-disk-audit:

#!/usr/bin/env bash
set -e

TMP_DF="/tmp/docker_df_verbose.txt"
OUTPUT_HTML="/var/www/html/docker-storage-report.html"

# 1. Volcar análisis detallado
docker system df -v > "$TMP_DF"

# 2. Generar dashboard HTML
python3 /opt/docker-audit/report.py "$TMP_DF" "$OUTPUT_HTML"

# 3. Limpieza de temporal
rm -f "$TMP_DF"
Enter fullscreen mode Exit fullscreen mode
sudo chmod +x /etc/cron.weekly/docker-disk-audit
Enter fullscreen mode Exit fullscreen mode

¿Qué nos permite detectar esta política?

  1. Contenedores activos inflados: Identifica contenedores cuyo writable layer creció desmedidamente (ej. bases de datos escribiendo fuera de un volumen).
  2. Imágenes dangling y huérfanas: Identifica imágenes sin contenedor asociado listas para docker image prune.
  3. Build cache obsoleto: Evita que BuildKit consuma gigabytes silenciosamente.

Conclusión

Con esta configuración:

  • Tu sistema operativo nunca sufrirá Kernel Panics o fallos de arranque por falta de espacio en /.
  • Containerd y Docker operan en el disco secundario de alto tráfico.
  • Cuentas con un reporte HTML automatizado para auditar el uso de disco sin esperar a que salte una alerta de emergencia.

Enter fullscreen mode Exit fullscreen mode

Top comments (0)