Limpieza de espacio en disco de Docker

Limpieza de espacio en disco de Docker (Hosts)

Los datos de Docker crecen con el tiempo en las máquinas host. Los alquileres antiguos dejan contenedores detenidos, imágenes sin usar, volúmenes y caché de compilación. Si no lo limpias, el disco raíz se llena y los despliegues empiezan a fallar.

Ejecuta la limpieza solo cuando el servidor esté no alquilado y no necesites ningún dato antiguo de contenedores. Si no estás seguro, detente aquí y primero haz una comprobación de uso de disco.

---

1) Comprobar uso de disco

Espacio en disco a nivel de SO (df -h)

Esto muestra el espacio libre en cada sistema de archivos montado.

df -h

Te interesa principalmente / (raíz) y la partición que contiene /var/lib/docker.

Uso de disco a nivel de Docker (docker system df)

Esto muestra qué está almacenando Docker y cuánto se puede recuperar.

docker system df

Si quieres más detalle por imagen/contenedor:

docker system df -v

---

2) Limpieza completa (recomendado)

Este es el comando para “restablecer los restos de Docker de alquileres anteriores”. Elimina contenedores, imágenes, redes y volúmenes no usados.

docker system prune -a --volumes

-a elimina todas las imágenes no usadas, no solo las “colgantes”. Eso incluye imágenes en caché que podrías querer para despliegues más rápidos en el futuro.

---

3) Comandos de limpieza individuales (más control)

Usa estos cuando quieras limpiar una categoría específica. Son más seguros para mantenimiento incremental.

Contenedores (solo detenidos)

docker container prune

Imágenes (no usadas)

Eliminar solo capas colgantes:

docker image prune

Eliminar todas las imágenes no usadas (mismo riesgo que system prune -a):

docker image prune -a

Volúmenes (no usados)

docker volume prune

Redes (no usadas)

docker network prune

---

4) Mejores prácticas para el mantenimiento del host

1. Limpia entre alquileres o durante tiempos de inactividad planificados.

2. Mantén un margen de seguridad. Apunta a 10–20 GB libres en el disco raíz en todo momento.

3. Comprueba el uso de Docker regularmente:

   • df -h

   • docker system df

4. Prefiere la limpieza incremental primero:

   • docker container prune

   • docker image prune

   • docker volume prune

5. Usa la limpieza completa solo cuando sea necesario:

   • docker system prune -a --volumes

6. Si el uso de disco sigue creciendo rápidamente, investiga:

   • Volúmenes grandes creados por los arrendatarios.

   • Registros bajo /var/lib/docker/containers/*/*.log.

   • Caché de compilación por reconstrucciones frecuentes de imágenes.