Docker 컨테이너 삭제 및 정리 방법 (실무에서 자주 쓰는 명령어)

Docker 컨테이너 삭제 및 정리 방법 (실무에서 자주 쓰는 명령어)

Docker를 사용하다 보면 어느 순간 이런 상황이 생깁니다.

• 테스트용 컨테이너가 계속 쌓임
• 중지된 컨테이너가 여러 개 남아 있음
• 디스크 용량이 점점 줄어듦

Docker는 컨테이너를 쉽게 만들 수 있는 만큼 정리도 주기적으로 해주는 것이 중요합니다.

이번 글에서는 Docker 컨테이너 삭제 및 정리 방법을 실제 개발 환경에서 자주 사용하는 명령어 중심으로 정리해 보겠습니다.

---

목차

• Docker 컨테이너 목록 확인
• Docker 컨테이너 중지
• Docker 컨테이너 삭제
• 중지된 컨테이너 한 번에 정리
• 사용하지 않는 Docker 리소스 정리
• 정리

---

Docker 컨테이너 목록 확인

먼저 현재 실행 중인 컨테이너를 확인해야 합니다.

docker ps

위 명령어를 실행하면 현재 실행 중인 컨테이너 목록이 출력됩니다.

중지된 컨테이너까지 확인하려면 다음 명령어를 사용합니다.

docker ps -a

개발 환경에서는 보통 이 명령어를 많이 사용합니다.

---

Docker 컨테이너 중지

실행 중인 컨테이너는 바로 삭제할 수 없습니다. 먼저 컨테이너를 중지해야 합니다.

docker stop 컨테이너ID

예시

docker stop a1b2c3d4

이렇게 하면 해당 컨테이너가 중지됩니다.

---

Docker 컨테이너 삭제

컨테이너를 중지한 후에는 다음 명령어로 삭제할 수 있습니다.

docker rm 컨테이너ID

예시

docker rm a1b2c3d4

여러 개의 컨테이너를 한 번에 삭제하는 것도 가능합니다.

docker rm 컨테이너ID1 컨테이너ID2

---

실행 중인 컨테이너 강제 삭제

가끔 컨테이너가 실행 중인데 바로 삭제하고 싶을 때가 있습니다.

이럴 때는 -f 옵션을 사용합니다.

docker rm -f 컨테이너ID

이 명령어는

• 컨테이너 중지
• 컨테이너 삭제

두 작업을 한 번에 처리합니다.

---

중지된 컨테이너 한 번에 정리

Docker를 오래 사용하다 보면 중지된 컨테이너가 많이 쌓입니다.

이럴 때는 다음 명령어를 사용하면 됩니다.

docker container prune

이 명령어는 중지된 컨테이너만 자동으로 정리합니다.

실행하면 확인 메시지가 나타납니다.

Are you sure you want to continue? [y/N]

여기서 y를 입력하면 정리가 진행됩니다.

---

사용하지 않는 Docker 리소스 정리

컨테이너뿐만 아니라 다음 리소스도 쌓일 수 있습니다.

• 사용하지 않는 이미지
• 네트워크
• 볼륨

이런 리소스를 한 번에 정리하려면 다음 명령어를 사용합니다.

docker system prune

이 명령어는 다음 항목을 정리합니다.

• 중지된 컨테이너
• 사용하지 않는 네트워크
• dangling 이미지

디스크 용량이 부족할 때 특히 유용한 명령어입니다.

---

정리

Docker 컨테이너 정리에 자주 사용하는 명령어를 정리하면 다음과 같습니다.

컨테이너 목록 확인
docker ps -a

컨테이너 중지
docker stop 컨테이너ID

컨테이너 삭제
docker rm 컨테이너ID

중지된 컨테이너 정리
docker container prune

Docker 리소스 전체 정리
docker system prune

Docker를 사용할 때는 컨테이너와 이미지가 계속 쌓이기 때문에 주기적으로 정리해 주는 것이 좋습니다.

특히 개발 환경에서는 테스트 컨테이너가 많이 생성되기 때문에 prune 명령어를 기억해 두면 매우 편합니다.

---

자주 묻는 질문 (FAQ)

Docker 컨테이너를 삭제하면 이미지도 삭제되나요?

아닙니다. 컨테이너와 이미지는 별개입니다. 컨테이너를 삭제해도 이미지는 그대로 남아 있습니다.

Docker system prune은 안전한가요?

사용하지 않는 리소스만 삭제되기 때문에 일반적으로 안전합니다. 하지만 중요한 컨테이너가 중지 상태라면 삭제될 수 있으니 주의해야 합니다.

Docker를 사용하면 디스크 용량이 많이 늘어나나요?

이미지와 컨테이너가 계속 쌓이면 용량이 증가할 수 있습니다. 그래서 주기적으로 정리하는 것이 좋습니다.