[Docker] docker 디스크 사용 상태 확인 (docker system df)

 

Docker Logo

Contents

---

1. 배경

Amazon의 EC2나 Azure 등 클라우드 서버를 사용하는 경우, 무료 티어에선 용량이 30기가 정도로 매우 적게 할당되는 경우가 있습니다. 웹을 띄우거나, 뭔가 실험적으로 하기엔 매우 적은 용량입니다. docker를 사용하는 경우 이미지나 컨테이너, 컨테이너와 연결된 로컬의 용량 등을 한눈에 파악한다면, docker에서 사용 중인 용량을 한 번에 볼 수 있습니다. 그 방법을 알아보겠습니다.

 

2. docker 디스크 사용 상태 확인

1) docker system df

docker system df

아래 출력이 나와 있습니다. TYPE에는 docker 시스템에서 사용하는 이미지, 컨테이너, 컨테이너와 연결된 로컬의 용량(Local Volumes)등의 종류가 나옵니다. 각 컬럼을 설명드리자면,

 ① TOTAL: 전체 개수입니다. (아래 사진에선 docker 시스템에서 사용하는 전체 이미지는 6개이고, 컨테이너는 3개라는 의미입니다.)

 ② ACTIVE: 사용하는 것의 개수 입니다. (아래 사진에서 이미지는 3개 사용 중이고, 컨테이너도 3개 사용 중이라는 의미입니다.)

 ③ SIZE: 사용 중인 용량입니다. (아래 사진에선, 다운로드한 이미지 전체 용량이 1.44 GB라는 것입니다.)

 ④ RECLAIMABLE: 사용하지 않는 것의 용량과 그 퍼센트입니다. (아래 사진에선, 다운로드한 이미지 중 450.2MB (31%)를 사용하지 않는다는 의미입니다.)

* 출력

docker system df

 

2) 옵션

-v : 이미지별, 컨테이너별,  Locla Volume별 정보를 상세히 확인하는 옵션입니다.

docker system df -v

아래 사진을 보면, 빨간 박스로 영역을 나눴습니다. Images space usage에 이미지에 대해 Repository, Tag, ID, 생성 일자(CREATED), 크기(SIZE), 해당 이미지를 사용하는 컨테이너 개수(CONTAINERS) 등의 정보가 나와있습니다. 그 아래엔, Conatiners space usage로 컨테이너에 대한 자세한 정보가 나와있습니다. 컨테이너 ID, 어떤 이미지로 만들어진 컨테이너인지(IMAGE), 컨테이너에 사용된 명령어(COMMAND) 등의 정보가 나옵니다. 다음으로, Local Volumes space usage에 컨테이너에 연결된 로컬 저장소 사용량이 나와있는데, 저는 없어서 따로 나오지 않았습니다. 마지막으로, 캐시 된 용량(Build cache usage)에 대해서도 자세히 나옵니다.

Images 부분에서 SHARED SIZE는 이미지가 다른 이미지와 공유하는 공통 데이터의 크기를 의미하고, UNIQUE SIZE는 주어진 이미지에서만 사용되는 데이터 크기(용량)를 의미합니다. 

 

* 출력

docker system df -v

 

읽어주셔서 감사합니다.

다음에 더 재미있고 유익한 글로 찾아오겠습니다.

 

Reference)
1. Docker Logo: https://www.docker.com/
2. https://runebook.dev/ko/docs/docker/engine/reference/commandline/system_df/index
3. https://watch-n-learn.tistory.com/16