码头工人ls

描述

列出插件

API 1.25+  客户端和守护程序API都必须至少为 1.25， 才能使用此命令。docker version在客户端上使用命令检查客户端和守护程序API版本。

用法

$ docker plugin ls [OPTIONS]

扩展说明

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

有关此命令的示例用法，请参阅下面的示例部分。

选项

名称，简写 默认 描述
--filter ， -f 提供过滤器值（例如“ enabled = true”）
--format 使用Go模板的精美打印插件
--no-trunc 不要截断输出
--quiet ， -q 仅显示插件ID

例子

$ docker plugin ls

ID            NAME                                    DESCRIPTION                ENABLED
69553ca1d123  tiborvass/sample-volume-plugin:latest   A test plugin for Docker   true

筛选

过滤标志（-f或--filter）的格式为“键=值”。如果有多个过滤器，则传递多个标志（例如--filter "foo=bar" --filter "bif=baz"）

当前支持的过滤器是：

  • 启用（布尔值-正确或错误，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）使用Go模板输出漂亮的插件输出。

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

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

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

以下示例使用没有标题的模板，ID并为所有插件输出Name以冒号（:）分隔的 和条目：

$ docker plugin ls --format "{{.ID}}: {{.Name}}"

4be01827a72e: vieux/sshfs:latest

上级命令

命令 描述
码头工人插件 管理插件
命令 描述
docker插件创建 从rootfs和配置创建一个插件。插件数据目录必须包含config.json和rootfs目录。
docker插件禁用 禁用插件
docker插件启用 启用插件
码头插件检查 显示有关一个或多个插件的详细信息
docker插件安装 安装插件
码头工人ls 列出插件
docker插件推送 将插件推送到注册表
docker插件rm 删除一个或多个插件
码头工人插件集 更改插件的设置
Docker插件升级 升级现有插件