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.com/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"）。

目前支持的过滤器有：

启用 (布尔值 - true 或 false, 0 或 1)
能力 (字符串 - 目前为 volumedriver, networkdriver, ipamdriver, logdriver, metricscollector, 或 authz)

已启用

enabled 过滤器匹配已启用或已禁用的插件。

能力

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"}