切换语言

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://docs.docker.com/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”。如果还有更多 than 一个 filter，然后传递多个标志（例如--filter "foo=bar" --filter "bif=baz").

当前支持的筛选器包括：

  • 已启用（布尔值 - true 或 false，0 或 1）
  • capability （string - 当前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） pretty-prints 插件输出 使用 Go 模板。

下面列出了 Go 模板的有效占位符：

占 位 符描述
.ID插件 ID
.Name插件名称和标签
.Description插件描述
.Enabled是否启用插件
.PluginReference用于从 registry 推送/拉取的引用

使用--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"}