docker volume ls

描述列出卷
用法docker volume ls [OPTIONS]
别名
docker volume list

描述

列出 Docker 已知的*所有*卷。您可以使用 -f 或 --filter 标志进行过滤。有关可用过滤器选项的更多信息，请参阅过滤部分。

选项

选项默认值描述
--clusterAPI 1.42+ Swarm 仅显示集群卷，并使用集群卷列表格式
-f, --filter提供过滤值（例如 dangling=true）
--format使用自定义模板格式化输出
'table'：以表格格式打印输出，带列头（默认）
'table TEMPLATE'：使用给定的 Go 模板以表格格式打印输出
'json'：以 JSON 格式打印
'TEMPLATE'：使用给定的 Go 模板打印输出。
有关使用模板格式化输出的更多信息，请参阅 https://docs.docker.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

driver 过滤器根据卷的驱动器进行匹配。

以下示例匹配使用 local 驱动器创建的卷

$ docker volume ls -f driver=local

DRIVER              VOLUME NAME
local               rosemary
local               tyler

label

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卷范围 (本地 local, 全局 global)
.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"}