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. Alquileres antiguos dejan contenedores detenidos, imágenes no usadas, volúmenes y caché de compilación. Si no lo limpias, el disco raíz se llena y las implementaciones 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 realiza primero una comprobación del uso del disco.

---

1) Comprobar uso del disco

Espacio en disco a nivel del 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 (recomendada)

Este es el comando para “reiniciar los restos de Docker de alquileres previos”. 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 implementaciones futuras más rápidas.

---

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

Úsalos 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) Buenas prácticas para el mantenimiento del host

1. Limpia entre alquileres o durante tiempo de inactividad planificado.

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

3. Revisa 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 del disco sigue creciendo rápidamente, investiga:

   • Grandes volúmenes creados por los inquilinos.

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

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