¿Docker sin espacio? Cómo borrar volúmenes huérfanos

¿Por qué se agota el espacio en disco en Docker?

A menudo, cuando monitoreamos el uso de disco en un servidor Linux, nos encontramos con que la partición está ocupada por gigabytes de datos que no logramos explicar. En el ecosistema Docker, esto sucede frecuentemente debido a la acumulación de volúmenes huérfanos. Un volumen huérfano es, en la práctica, una carpeta de datos persistentes que se creó para un contenedor, pero que sobrevivió a la eliminación de este. Como Docker no sabe si planeas reutilizar esos archivos, los mantiene en el disco indefinidamente.

Cómo identificar volúmenes no utilizados

Antes de borrar cualquier cosa, es fundamental listar qué está ocupando tu almacenamiento. Docker ofrece herramientas de línea de comandos nativas para inspeccionar el estado de estos recursos. Sin una verificación periódica, esta acumulación se convierte en un problema silencioso, similar a lo que ocurre con imágenes huérfanas que también consumen espacio. Para listar todos los volúmenes presentes en tu sistema, ejecuta el siguiente comando:

docker volume ls

Este comando muestra una lista de todos los volúmenes, sin importar si están vinculados a un contenedor activo. Para ver solo aquellos que no están siendo utilizados actualmente, podemos filtrar la salida:

docker volume ls -f dangling=true

Eliminando volúmenes huérfanos de forma segura

Cuando confirmas que existen volúmenes que ya no están conectados a ningún contenedor, la limpieza es un procedimiento sencillo. La forma más rápida de realizar esta tarea es utilizando el comando prune, diseñado específicamente para tareas de mantenimiento. A diferencia de forzar la eliminación de pods bloqueados en Kubernetes, que requiere un control más riguroso, la limpieza de volúmenes es un proceso estándar de gestión del ciclo de vida.

docker volume prune

Al ejecutar este comando, Docker solicitará una confirmación. Si estás utilizando scripts de automatización, puedes añadir la opción -f (force) para omitir la confirmación. Tras completar la operación, el sistema mostrará la cantidad total de espacio en disco recuperado, lo cual suele resolver la crisis de almacenamiento inmediata.

Gestionando volúmenes específicos

No siempre queremos borrar todo. Si mantienes datos de bases de datos como PostgreSQL o archivos multimedia en tu servidor de streaming, es prudente realizar la eliminación manualmente para evitar accidentes. Para borrar un volumen específico, utiliza el siguiente comando:

docker volume rm nombre_del_volumen

Si el volumen está en uso, Docker impedirá su eliminación. Recuerda siempre verificar si el contenedor que utiliza ese volumen realmente ha sido desactivado. Monitorear el uso de recursos en general es una buena práctica; así como optimizamos el límite de CPU de un contenedor, debemos tratar el almacenamiento como un recurso limitado y finito.

Consideraciones finales

El mantenimiento regular de Docker es el secreto para mantener servidores Linux estables durante años. Establecer un cronograma, incluso si es manual, para ejecutar comandos de limpieza evita sorpresas desagradables en medio de la noche. Además, considera usar herramientas de monitoreo para recibir alertas antes de que el espacio llegue al 100%.

En resumen, no temas al sistema, sino comprende su comportamiento. Docker es extremadamente eficiente, pero no limpiará tu desorden por sí solo. La adopción de buenas prácticas de infraestructura, incluyendo la eliminación de volúmenes de prueba y el uso de volúmenes temporales (tmpfs) cuando la persistencia no es necesaria, es el camino hacia una operación robusta y eficiente.