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)
- 能力(字符串 - 当前
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"}