1、docker plugin ls 简介
docker plugin ls
命令用于列出所有已经安装的 Docker 插件。使用该命令可以查看插件的 ID、名称、版本号、描述和启用状态等信息。列出当前安装的所有插件。可以使用docker plugin install
命令安装插件。也可以使用-f
或--filter
标志进行过滤。有关可用过滤器选项的更多信息,请参阅过滤部分。
参考文档:https://docs.docker.com/engine/reference/commandline/plugin_ls/
2、docker plugin ls 语法
docker plugin ls [OPTIONS]
3、docker plugin ls 命令
1)列出所有已经安装的插件
docker plugin ls ID NAME DESCRIPTION ENABLED 69553ca1d123 tiborvass/sample-volume-plugin:latest A test plugin for Docker true
2)过滤(--filter)
筛选标志(-f
或 --filter
)的格式为“键=值”。如果有多个筛选条件,则需要传递多个标志(例如,--filter "foo=bar" --filter "bif=baz"
)。
目前支持的筛选条件包括:
enabled(布尔类型 - true 或 false,0 或 1)capability(字符串 - 目前支持 volumedriver、networkdriver、ipamdriver、logdriver、metricscollector 或 authz)enabledenabled 筛选条件匹配已启用或已禁用的插件。
capabilitycapability 筛选条件匹配插件的功能。一个插件可能具有多个功能。目前支持 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 | 从registry推送/拉取时使用的引用 |
当使用 --format
选项时,plugin ls 命令将根据模板的声明输出数据,或者当使用表格指令时,也会输出列标题。
以下示例使用不带标题的模板,并为所有插件输出 ID 和名称条目,中间用冒号(:)隔开:
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"}
4、命令选项
选项 | 默认值 | 描述 |
--filter , -f | 提供过滤器值(例如:enabled=true) | |
--format | 可以使用--format选项指定输出格式。下面是可用的选项: table(默认):使用表格格式以带有列标题的形式打印输出。 table TEMPLATE:使用给定的Go模板以表格格式打印输出。 json:以JSON格式打印输出。 TEMPLATE:使用给定的Go模板打印输出。 这些选项都有自己的功能和语法, 如果您需要了解如何使用模板格式化输出, | |
--no-trunc | 不要截断输出 | |
--quiet , -q | 只显示插件ID |
5、子命令
命令 | 描述 |
docker plugin create | 从根文件系统和配置文件创建插件。 插件数据目录必须包含config.json和 rootfs目录。 |
docker plugin disable | 禁用一个插件。 |
docker plugin enable | 启用一个插件。 |
docker plugin inspect | 显示一个或多个插件的详细信息。 |
docker plugin install | 安装一个插件。 |
docker plugin ls | 列出所有安装的插件。 |
docker plugin push | 将一个插件推送到registry。 |
docker plugin rm | 删除一个或多个插件。 |
docker plugin set | 更改插件的设置。 |
docker plugin upgrade | 升级一个已经存在的插件。 |