在线文档教程
Docker 17
引擎: CLI | Engine: CLI

docker plugin ls

docker插件ls

描述

列表插件

用法

docker plugin ls [OPTIONS]

选项

名称,简写默认描述
--filter, -f提供过滤器值(例如'enabled = true')
--format打印插件使用Go模板
--no-truncfalse不要截断输出
--quiet, -qfalse只显示插件ID

父命令

命令描述
docker插件管理插件

相关命令

命令描述
docker plugin create从rootfs和配置创建一个插件。插件数据目录必须包含config.json和rootfs目录。
docker plugin disable禁用插件
docker plugin enable启用插件
docker plugin inspect显示一个或多个插件的详细信息
docker plugin install安装一个插件
docker plugin ls列出插件
docker plugin push将插件推送到注册表
docker plugin rm删除一个或多个插件
docker plugin set更改插件的设置
docker plugin upgrade升级现有的插件

扩展描述

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

实例

$ docker plugin ls ID NAME TAG DESCRIPTION ENABLED 69553ca1d123 tiborvass/sample-volume-plugin latest A test plugin for Docker true

过滤

过滤标志(-f--filter)格式为“key = value”。如果有多个过滤器,则传递多个标志(例如--filter "foo=bar" --filter "bif=baz"

目前支持的过滤器是:

  • enabled (boolean - true or false, 0 or 1)

  • capability (string - currently volumedriver, networkdriver, ipamdriver, logdriver, metricscollector, or authz)

enabled

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

capability

capability过滤器上的插件功能相匹配。一个插件可能具有多种功能。目前volumedrivernetworkdriveripamdriverlogdrivermetricscollector,和authz是支持的capabilities。

$ docker plugin install --disable tiborvass/no-remove tiborvass/no-remove $ docker plugin ls --filter enabled=true NAME TAG DESCRIPTION ENABLED

格式化

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

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

占位符描述
.ID插件ID
.Name插件名称
.Description插件描述
.Enabled是否启用插件
.PluginReference用于从注册表中push/pull的参考

当使用--format选项时,plugin ls命令将完全按照模板声明输出数据,或者在使用table指令时也包含列标题。

下面的示例使用的模板没有报头,并输出IDName通过对所有的插件冒号分隔的条目:

$ docker plugin ls --format "{{.ID}}: {{.Name}}" 4be01827a72e: tiborvass/no-remove