码头工人卷ls

描述

清单卷

API 1.21+  客户端和守护程序API都必须至少为 1.21， 才能使用此命令。docker version在客户端上使用命令检查客户端和守护程序API版本。

用法

$ docker volume ls [OPTIONS]

扩展说明

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

有关此命令的示例用法，请参阅下面的示例部分。

选项

名称，简写 默认 描述
--filter ， -f 提供过滤器值（例如'dangling = true'）
--format 使用Go模板打印漂亮的卷
--quiet ， -q 仅显示卷名

例子

创建一个卷

$ docker volume create rosemary

rosemary

$ docker volume create tyler

tyler

$ docker volume ls

DRIVER              VOLUME NAME
local               rosemary
local               tyler

筛选

过滤标志（-f或--filter）的格式为“键=值”。如果有多个过滤器，则传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）

当前支持的过滤器是：

  • 悬挂（布尔-正确或错误，0或1）
  • 驱动程序（卷驱动程序的名称）
  • 标签（label=<key>或label=<key>=<value>）
  • 名称（卷的名称）

晃来晃去

在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过滤器上的卷的名称的全部或部分匹配。

以下过滤器将所有卷与包含该rose字符串的名称匹配。

$ docker volume ls -f name=rose

DRIVER              VOLUME NAME
local               rosemary

格式设定

格式化选项（--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

上级命令

命令 描述
码头工人卷 管理卷
命令 描述
码头工人卷创建 创建一个卷
码头工人体积检查 显示一个或多个卷上的详细信息
码头工人卷ls 清单卷
码头工人修剪 删除所有未使用的本地卷
码头工人卷rm 删除一个或多个卷