이미지·컨테이너 정리로 디스크 확보하기

Docker prune은 사용되지 않는 리소스를 영구 삭제합니다. 실행 중인 컨테이너만 보고 판단하지 말고, 중지된 컨테이너와 재사용할 이미지·볼륨·build cache까지 확인하세요.

Docker 호스트의 디스크를 정리하려고 해.
현재 사용량과 삭제 후보를 먼저 조사하고 이미지, 컨테이너, build cache, volume을 각각 구분해 안전한 순서로 안내해 줘.
데이터가 있는 volume 보호와 작업 후 검증을 반드시 포함해 줘.

1. 사용량과 리소스 확인

docker system df -v
docker ps -a
docker image ls
docker volume ls
docker builder du

중요한 컨테이너가 어떤 volume을 사용하는지 확인합니다.

docker inspect '{{CONTAINER}}'

출력의 Mounts 배열에서 volume 이름, source, destination을 확인합니다.

2. 범위를 나눠 정리

중지된 컨테이너만 정리:

docker container prune

dangling image만 정리:

docker image prune

어떤 컨테이너도 참조하지 않는 이미지까지 정리:

docker image prune -a

build cache 정리:

docker builder prune

docker system prune -a --volumes는 중지 컨테이너, 미사용 네트워크·이미지·build cache와 사용되지 않는 anonymous volume까지 한꺼번에 제거합니다. named volume 전체를 삭제하는 옵션은 아니지만, anonymous volume에도 필요한 데이터가 있을 수 있으므로 백업과 mount 확인 없이 실행하지 마세요.

3. 결과 검증

docker system df -v
docker ps -a
docker volume ls

필수 서비스가 있다면 compose 상태와 health check도 확인합니다.

docker compose ps

삭제된 이미지와 volume은 명령으로 되돌릴 수 없습니다. 데이터 volume은 애플리케이션별 백업·복구 절차를 먼저 검증하세요.

공식 문서: https://docs.docker.com/reference/cli/docker/system/prune/