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.
Top comments (0)