docker plugin 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.net.tw/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"）。

目前支援的過濾器有：

enabled (布林值 - true 或 false，0 或 1)
capability (字串 - 當前為 volumedriver, networkdriver, ipamdriver, logdriver, metricscollector, 或 authz)

enabled

enabled 過濾器匹配已啟用或已停用的外掛。

capability

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