docker plugin ls

読む時間の目安: 2 分

説明

プラグインを一覧表示します。

API 1.25 以上  このコマンドを利用するには、クライアントとデーモンの API はともに、最低でも 1.25 である必要があります。 クライアント上においてdocker versionコマンドを実行して、クライアントとデーモンの API バージョンを確認してください。

利用方法

$ docker plugin ls [オプション]

追加説明

現在インストールされているプラグインの一覧を表示します。 プラグインのインストールには docker plugin install コマンドを利用します。 フィルター検索には-fまたは--filterフラグを利用できます。 利用可能な検索フィルターについては フィルター検索 の節を参照してください。

本コマンドの利用例については、以下に示す 利用例の節 を参照してください。

オプション

利用例

$ 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"など。）

現在サポートされているフィルターは以下のとおりです。

• 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）により Go 言語のテンプレートを利用して、プラグインをわかりやすく出力することができます。

Go 言語テンプレートによるプレースホルダー（placeholder）は以下のとおりです。

--formatオプションを利用するとplugin lsコマンドは、テンプレートが定めるデータを直接出力します。 またtableディレクティブを利用すると、カラムヘッダーも同時に出力されます。

以下は、ヘッダーを含めずにテンプレートを利用する例であり、すべてのプラグインにおけるID、Nameの各項目がコロン（:）で区切って表示されます。

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

4be01827a72e: vieux/sshfs:latest

上位コマンド

関連コマンド