docker volume ls

docker volume ls

docker volume ls는 Docker가 아는 모든 볼륨의 목록을 보여주는 명령이에요. -f/--filter 플래그로 필터링할 수 있어요.

출처: 문서

본문

docker volume ls는 Docker가 아는 모든 볼륨을 나열해요. -f 또는 --filter 플래그로 필터링할 수 있어요.

docker volume ls [OPTIONS]

별칭으로 docker volume list를 쓸 수 있어요.

지원하는 옵션은 다음과 같아요.

옵션 기본값 설명
--cluster API 1.42+ 스웜 클러스터 볼륨만 표시하고 클러스터 볼륨 목록 형식을 써요.
-f, --filter 필터 값을 제공해요 (예: dangling=true).
--format Go 템플릿으로 출력 형식을 정해요. table(기본), table TEMPLATE, json, TEMPLATE을 지원해요.
-q, --quiet 볼륨 이름만 표시해요.

예시

$ docker volume create rosemary

rosemary

$ docker volume ls

DRIVER              VOLUME NAME
local               rosemary
local               tyler

필터링 (--filter)

-f/--filter 형식은 key=value예요. 지원하는 필터는 다음과 같아요.

  • dangling (부울 - true/false, 0/1): 어떤 컨테이너도 참조하지 않는 볼륨
  • driver: 볼륨 드라이버 이름
  • label (label= 또는 label==)
  • name: 볼륨 이름

dangling 필터 예시예요.

$ docker volume ls -f dangling=true

DRIVER              VOLUME NAME
local               rosemary

label 필터 예시예요. is-timelord 라벨을 값에 상관없이 가진 볼륨을 매칭해요.

$ docker volume ls --filter label=is-timelord

DRIVER              VOLUME NAME
local               daleks
local               the-doctor

라벨의 keyvalue를 모두 필터링할 수도 있어요.

$ docker volume ls --filter label=is-timelord=yes

DRIVER              VOLUME NAME
local               the-doctor

여러 label 필터를 지정하면 AND 검색이 돼요. 모든 조건을 만족해야 해요.

name 필터는 볼륨 이름의 전체 또는 일부와 일치해요. 이름에 rose 문자열을 포함한 볼륨을 찾는 예시예요.

$ docker volume ls -f name=rose

DRIVER              VOLUME NAME
local               rosemary

출력 형식 (--format)

--format은 Go 템플릿으로 볼륨 출력을 꾸며줘요. 사용할 수 있는 플레이스홀더는 다음과 같아요.

플레이스홀더 설명
.Name 볼륨 이름
.Driver 볼륨 드라이버
.Scope 볼륨 범위 (local, global)
.Mountpoint 호스트에서 볼륨의 마운트 지점
.Labels 볼륨에 할당된 모든 라벨
.Label 이 볼륨의 특정 라벨 값 (예: {{.Label "project.version"}})

헤더 없이 NameDriver를 콜론으로 구분해 출력하는 예시예요.

$ docker volume ls --format "{{.Name}}: {{.Driver}}"

vol1: local
vol2: local
vol3: local

더 알아보기