docker plugin ls

描述	列出插件
用法	`docker plugin ls [OPTIONS]`
别名	`docker plugin list`

描述

列出当前已安装的所有插件。您可以使用 docker plugin install 命令安装插件。您也可以使用-f或--filter标志进行过滤。有关可用筛选选项的更多信息，请参阅过滤部分。

选项

选项	默认值	描述
`-f, --filter`		提供筛选器值（例如，`enabled=true`）
`--format`		使用自定义模板格式化输出 'table': 以表格格式打印输出，包含列标题（默认） 'table TEMPLATE': 使用给定的 Go 模板以表格格式打印输出 'json': 以 JSON 格式打印 'TEMPLATE': 使用给定的 Go 模板打印输出。有关使用模板格式化输出的更多信息，请参阅https://docs.docker.net.cn/go/formatting/。
`--no-trunc`		不截断输出
`-q, --quiet`		仅显示插件 ID

示例

$ docker plugin ls

ID            NAME                                    DESCRIPTION                ENABLED
69553ca1d123  tiborvass/sample-volume-plugin:latest   A test plugin for Docker   true

过滤 (--filter)

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

当前支持的筛选器为：

enabled（布尔值 - true 或 false，0 或 1）
capability（字符串 - 当前为volumedriver、networkdriver、ipamdriver、logdriver、metricscollector或authz）

enabled

enabled 筛选器匹配已启用或已禁用的插件。

capability

capability 筛选器匹配插件功能。一个插件可能具有多个功能。当前支持的功能为volumedriver、networkdriver、ipamdriver、logdriver、metricscollector和authz。

$ docker plugin install --disable vieux/sshfs

Installed plugin vieux/sshfs

$ docker plugin ls --filter enabled=true

ID                  NAME                DESCRIPTION         ENABLED

格式化输出 (--format)

格式化选项 (--format) 使用 Go 模板美化打印插件输出。

Go 模板的有效占位符列在下面

占位符	描述
`.ID`	插件 ID
`.Name`	插件名称和标签
`.Description`	插件描述
`.Enabled`	插件是否启用
`.PluginReference`	用于从注册表推送/拉取的引用

使用--format选项时，plugin ls命令将完全按照模板声明的格式输出数据，或者当使用table指令时，还会包含列标题。

以下示例使用不带标题的模板，并为所有插件输出以冒号 (:) 分隔的ID和Name条目。

$ docker plugin ls --format "{{.ID}}: {{.Name}}"

4be01827a72e: vieux/sshfs:latest

要以 JSON 格式列出所有插件，请使用json指令。

$ docker plugin ls --format json
{"Description":"sshFS plugin for Docker","Enabled":false,"ID":"856d89febb1c","Name":"vieux/sshfs:latest","PluginReference":"docker.io/vieux/sshfs:latest"}