docker 이미지를 생성하는데, volume, network, cache 등이 남아있게 됩니다. 이처럼 효과적인 방법으로 docker image를 생성하고, 잔여 이미지들을 prune 하는 방법에 대하여 알아보도록 하겠습니다.

Docker Build

docker compose up --build는 기본적으로 캐시를 사용해서 빌드합니다. 만약 캐시를 무시하고 새로 빌드하고 싶다면, --build와 함께 docker compose build --no-cache를 먼저 실행 합니다. 참고로 docker compose up에는 --no-cache 옵션이 없습니다. 그래서 반드시 build 명령어에만 --no-cache를 사용해야 합니다.

캐시 없이 완전 새로 빌드하고 up 실행하는 방법들로 다음 중 선택하여 실행 합니다.

# 두 명령어로 나눠서 실행
$ docker compose build --no-cache
$ docker compose up

# 캐시 없이 한 줄로 실행 (쉘에서 && 연결)
$ docker compose build --no-cache && docker compose up

# 캐시 없이 한 줄로 실행 (쉘에서 && 연결 && 백그라운드 모드로 실행)
docker compose build --no-cache && docker compose up -d

Docker Prune

docker compose를 실행하고 테스트하다 보면 캐시나 불필요한 이미지, 컨테이너, 볼륨, 네트워크, 빌드 캐시 등이 계속 쌓이게 되죠. 아래에 안전하게 정리하는 방법을 목적별로 정리해드릴게요.

빌드 캐시 정리

# 빌드 캐시만 삭제하고 싶을 때
$ docker builder prune

# 확인 없이 강제로:
$ docker builder prune -f

# 예: `Dockerfile` 수정 후 캐시 없이 새로 빌드하려면
$ docker compose build --no-cache

사용하지 않는 모든 것 정리 (docker system prune)

# 중지된 컨테이너 + 안 쓰는 이미지 + 네트워크 + 캐시 모두 정리
$ docker system prune

# 강력한 정리 (볼륨 포함)
# `--volumes` 옵션은 데이터베이스 데이터까지 날릴 수 있습니다
$ docker system prune --volumes

중지된 컨테이너 제거

# 중지된 컨테이너만 제거
$ docker container prune

# 안 쓰는 이미지만 제거
$ docker image prune

# 사용되지 않는 네트워크 제거
$ docker network prune

# 사용되지 않는 볼륨 제거
$ docker volume prune

실전 예시 - compose 테스트 끝나고 전체 클린업

• down -v: 관련된 볼륨까지 삭제
• --rmi all: 생성된 이미지 삭제
• --remove-orphans: 연결되지 않은 서비스 컨테이너 제거
• system prune: 나머지 불필요한 캐시, 중지 컨테이너 등 정리

  $ docker compose down -v --rmi all --remove-orphans
  $ docker system prune -f --volumes