Docker sem espaço? Como remover volumes órfãos facilmente

Por que o espaço em disco acaba no Docker?

Muitas vezes, quando monitoramos o uso de disco em um servidor Linux, nos deparamos com a partição ocupada por gigabytes de dados que não conseguimos explicar. No ecossistema Docker, isso acontece frequentemente devido ao acúmulo de volumes órfãos. Um volume órfão é, na prática, uma pasta de dados persistentes que foi criada para um container, mas que sobreviveu à remoção desse container. Como o Docker não sabe se você pretende reutilizar esses arquivos, ele os mantém no disco indefinidamente.

Como identificar volumes não utilizados

Antes de apagar qualquer coisa, é fundamental listar o que está ocupando o seu armazenamento. O Docker oferece ferramentas de linha de comando nativas para inspecionar o estado desses recursos. Sem uma verificação periódica, o acúmulo se torna um problema silencioso, semelhante ao que enfrentamos com imagens órfãs que também consomem espaço. Para listar todos os volumes presentes no seu sistema, execute o comando abaixo:

docker volume ls

Este comando exibe uma lista de todos os volumes, independentemente de estarem vinculados a um container ativo. Para ver apenas aqueles que não estão sendo usados, podemos filtrar a saída:

docker volume ls -f dangling=true

Removendo volumes órfãos de forma segura

Quando você confirma que existem volumes que não estão mais conectados a nenhum container, a limpeza é um procedimento direto. A forma mais rápida de realizar essa tarefa é utilizando o comando prune, que foi desenhado especificamente para tarefas de manutenção. Diferente de forçar a remoção de pods no Kubernetes, que exige um controle mais rígido, a limpeza de volumes é um processo comum de gerenciamento de ciclo de vida.

docker volume prune

Ao executar este comando, o Docker pedirá uma confirmação. Se você estiver rodando scripts de automação, pode adicionar a flag -f (force) para pular o prompt. Após o sucesso da operação, o sistema exibirá o total de espaço em disco recuperado, o que geralmente resolve a crise de armazenamento imediata.

Gerenciando volumes específicos

Nem sempre queremos apagar tudo. Se você mantém dados de bancos de dados como PostgreSQL ou arquivos de mídia do seu servidor de streaming, é prudente realizar a remoção manualmente para evitar acidentes. Para deletar um volume específico, utilize o comando abaixo:

docker volume rm nome_do_volume

Se o volume estiver em uso, o Docker impedirá a deleção. Lembre-se sempre de conferir se o container que utiliza aquele volume foi realmente desativado. Monitorar o uso de recursos de forma geral é uma boa prática; assim como otimizamos o limite de CPU de um container, devemos tratar o armazenamento como um recurso limitado e finito.

Considerações finais

A manutenção regular do Docker é o segredo para manter servidores Linux estáveis por anos. Estabelecer um cronograma, mesmo que manual, para rodar comandos de limpeza, evita surpresas desagradáveis no meio da noite. Além disso, considere usar ferramentas de monitoramento para ser alertado antes que o espaço chegue a 100%.

Em suma, não tema o sistema, mas entenda o seu comportamento. O Docker é extremamente eficiente, mas ele não vai limpar a sua bagunça sozinho. A adoção de boas práticas de infraestrutura, incluindo a deleção de volumes de teste e o uso de volumes temporários (tmpfs) quando a persistência não for necessária, é o caminho para uma operação robusta e eficiente.