docker plugin ls

說明列出插件
用法docker plugin ls [選項]
別名
docker plugin list

說明

列出目前已安裝的所有插件。您可以使用 docker plugin install 指令安裝插件。您也可以使用 -f 或 --filter 旗標進行篩選。有關可用篩選選項的更多資訊，請參閱篩選章節。

選項

選項預設值說明
-f, --filter提供篩選值（例如 enabled=true）
--format使用自訂範本格式化輸出
'table'：以表格格式列印輸出，包含欄位標題（預設）
'table TEMPLATE'：使用指定的 Go 範本以表格格式列印輸出
'json'：以 JSON 格式列印
'TEMPLATE'：使用指定的 Go 範本列印輸出。
有關使用範本格式化輸出的更多資訊，請參閱 https://docker-docs.dev.org.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）
  • 功能 (字串 - 目前支援 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用於從 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"}