docker volume ls
| 描述 | 列出卷 |
|---|---|
| 用法 | docker volume ls [选项] |
| 别名 | docker volume list |
描述
列出 Docker 已知的所有卷。可以使用 -f 或 --filter 标志进行过滤。有关可用过滤选项的更多信息，请参阅过滤部分。
选项
| 选项 | 默认值 | 描述 |
|---|---|---|
--cluster | API 1.42+ Swarm 仅显示集群卷，并使用集群卷列表格式 | |
-f, --filter | 提供过滤值（例如 dangling=true） | |
--format | 使用自定义模板格式化输出 'table': 以带列标题的表格格式打印输出（默认） 'table TEMPLATE': 使用给定的 Go 模板以表格格式打印输出 'json': 以 JSON 格式打印 'TEMPLATE': 使用给定的 Go 模板打印输出。 有关使用模板格式化输出的更多信息，请参阅https://docs.container.net.cn/go/formatting/ | |
-q, --quiet | 仅显示卷名 |
示例
创建一个卷
$ docker volume create rosemary
rosemary
$ docker volume create tyler
tyler
$ docker volume ls
DRIVER VOLUME NAME
local rosemary
local tyler
过滤 (--filter)
过滤标志（-f 或 --filter）的格式为“key=value”。如果有多个过滤器，则传递多个标志（例如，--filter "foo=bar" --filter "bif=baz"）
目前支持的过滤器有：
- dangling（布尔值 - true 或 false，0 或 1）
- driver（卷驱动程序名称）
- label (
label=<key>或label=<key>=<value>) - name（卷名）
dangling
dangling 过滤器匹配所有未被任何容器引用的卷
$ docker run -d -v tyler:/tmpwork busybox
f86a7dd02898067079c99ceacd810149060a70528eff3754d0b0f1a93bd0af18
$ docker volume ls -f dangling=true
DRIVER VOLUME NAME
local rosemary
驱动程序
driver 过滤器根据卷的驱动程序进行匹配。
以下示例匹配使用 local 驱动程序创建的卷
$ docker volume ls -f driver=local
DRIVER VOLUME NAME
local rosemary
local tyler
标签
label 过滤器根据是否存在 label 或 label 及其值进行匹配。
首先，创建一些卷来说明这一点；
$ docker volume create the-doctor --label is-timelord=yes
the-doctor
$ docker volume create daleks --label is-timelord=no
daleks
以下示例过滤器匹配具有 is-timelord 标签的卷，无论其值如何。
$ docker volume ls --filter label=is-timelord
DRIVER VOLUME NAME
local daleks
local the-doctor
如上述示例所示，返回了带有 is-timelord=yes 和 is-timelord=no 的两个卷。
同时过滤标签的 key 和 value 会产生预期的结果
$ docker volume ls --filter label=is-timelord=yes
DRIVER VOLUME NAME
local the-doctor
指定多个标签过滤器会产生“与”搜索；所有条件都应满足；
$ docker volume ls --filter label=is-timelord=yes --filter label=is-timelord=no
DRIVER VOLUME NAME
name
name 过滤器匹配卷名的全部或部分。
以下过滤器匹配所有名称中包含 rose 字符串的卷。
$ docker volume ls -f name=rose
DRIVER VOLUME NAME
local rosemary
格式化输出 (--format)
格式选项（--format）使用 Go 模板漂亮地打印卷输出。
Go 模板的有效占位符如下所示
| 占位符 | 描述 |
|---|---|
.Name | 卷名 |
.Driver | 卷驱动程序 |
.Scope | 卷范围（本地、全局） |
.Mountpoint | 卷在主机上的挂载点 |
.Labels | 分配给卷的所有标签 |
.Label | 此卷特定标签的值。例如 {{.Label "project.version"}} |
使用 --format 选项时，volume ls 命令将完全按照模板声明的方式输出数据，或者在使用 table 指令时，也包含列标题。
以下示例使用不带标题的模板，并为所有卷输出由冒号（:）分隔的 Name 和 Driver 条目
$ docker volume ls --format "{{.Name}}: {{.Driver}}"
vol1: local
vol2: local
vol3: local
要以 JSON 格式列出所有卷，请使用 json 指令
$ docker volume ls --format json
{"Driver":"local","Labels":"","Links":"N/A","Mountpoint":"/var/lib/docker/volumes/docker-cli-dev-cache/_data","Name":"docker-cli-dev-cache","Scope":"local","Size":"N/A"}