docker 插件 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://docker.github.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")。

目前支持的过滤器有:

  • 启用(布尔值 - true 或 false、0 或 1)
  • 能力(字符串 - 当前volumedrivernetworkdriveripamdriverlogdrivermetricscollector、 或authz

已启用

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

能力

过滤capability器与插件功能相匹配。一个插件可能具有多种功能。目前支持的功能有volumedrivernetworkdriveripamdriverlogdrivermetricscollector和。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"}