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/sdaonvme0n1): Sistema operativo montado en/. - Disco 2 (
/dev/sdbonvme1n1): 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 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 Detener los servicios antes de reconfigurar rutas:
sudo systemctl stop docker containerd 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 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 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" } } 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 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 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" sudo chmod +x /etc/cron.weekly/docker-disk-audit ¿Qué nos permite detectar esta política?
- Contenedores activos inflados: Identifica contenedores cuyo writable layer creció desmedidamente (ej. bases de datos escribiendo fuera de un volumen).
- Imágenes dangling y huérfanas: Identifica imágenes sin contenedor asociado listas para
docker image prune. - 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.
