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
라벨의 key와 value를 모두 필터링할 수도 있어요.
$ 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"}}) |
헤더 없이 Name과 Driver를 콜론으로 구분해 출력하는 예시예요.
$ docker volume ls --format "{{.Name}}: {{.Driver}}"
vol1: local
vol2: local
vol3: local