1、docker volume ls 简介

docker volume ls 命令用于列出所有可用的 Docker 卷。

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

参考文档：https://docs.docker.com/engine/reference/commandline/volume_ls/

2、docker volume ls 语法

docker volume ls [OPTIONS]

3、docker volume ls 命令

1）创建卷

docker volume create rosemary

rosemary
docker volume create tyler

tyler
docker volume ls

DRIVER              VOLUME NAME
local               rosemary
local               tyler

2）过滤（--filter）

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

目前支持的过滤器有：

• dangling（布尔值 - true 或 false，0 或 1）
• driver（卷驱动程序的名称）
• label（label= 或 label==）
• name（卷的名称）

3）dangling

dangling 过滤器匹配所有未被任何容器引用的卷。

docker run -d  -v tyler:/tmpwork  busybox

f86a7dd02898067079c99ceacd810149060a70528eff3754d0b0f1a93bd0af18
docker volume ls -f dangling=true
DRIVER              VOLUME NAME
local               rosemary

4）driver

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

以下示例匹配使用 local 驱动程序创建的卷：

docker volume ls -f driver=local

DRIVER              VOLUME NAME
local               rosemary
local               tyler

5）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 的两个卷。

通过同时指定标签的键和值进行过滤，可以得到预期的结果：

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

6）name

name 过滤器根据卷的名称全匹配或部分匹配。

以下过滤器匹配所有名称中包含 rose 字符串的卷：

docker volume ls -f name=rose

DRIVER              VOLUME NAME
local               rosemary

7）格式化输出（--format）

使用 --format 选项，可以使用 Go 模板来格式化输出。

以下是 Go 模板中可以使用的有效占位符：

在使用 --format 选项时，volume ls 命令将根据模板的声明精确输出数据，或者当使用 table 指令时，还包括列标题。

以下示例使用没有标题的模板，以冒号（:）分隔输出所有卷的 Name 和 Driver 条目：

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

vol1: local
vol2: local
vol3: local

要以 JSON 格式列出所有卷，请使用 json 指令：

docker volume ls -f name=rose

DRIVER              VOLUME NAME
local               rosemary

4、命令选项