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.container.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）的格式为“key=value”。如果有多个过滤器，则传递多个标志（例如，--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"}