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）的格式为 "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"}