docker plugin set

プラグインの設定を変更します。

【API 1.25+】このコマンドを使うには、クライアントとデーモン API の両方が、少なくとも 1.25 の必要があります。クライアントとデーモン API のバージョンを調べるには、 docker version コマンドを使います。

使い方

$ docker plugin set PLUGIN KEY=VALUE [KEY=VALUE...]

補足説明

プラグインに対する設定を変更します。プラグインを無効化している必要があります。

現時点では、以下の設定をサポートしています。

  • 環境変数
  • マウント元
  • デバイスのパス
  • 引数

コマンドの使用例は、以下の 使用例のセクション をご覧ください。

使用例

環境変数を変更

以下の例は sample-volume-plugin プラグイン上の環境変数 DEBUG を変更します。

$ docker plugin inspect -f {{.Settings.Env}} tiborvass/sample-volume-plugin
[DEBUG=0]

$ docker plugin set tiborvass/sample-volume-plugin DEBUG=1

$ docker plugin inspect -f {{.Settings.Env}} tiborvass/sample-volume-plugin
[DEBUG=1]

プラグインのマウント元を変更

以下の例は myplugin プラグインの mymount マウント元を変更します。

$ docker plugin inspect -f '{{with $mount := index .Settings.Mounts 0}}{{$mount.Source}}{{end}}' myplugin
/foo

$ docker plugins set myplugin mymount.source=/bar

$ docker plugin inspect -f '{{with $mount := index .Settings.Mounts 0}}{{$mount.Source}}{{end}}' myplugin
/bar

注釈

唯一の source のみ mymount に設定できるように、 docker plugins set mymount=/bar myplugin も同様の挙動です。

デバイスのパスを変更

以下の例は myplugin プラグイン上の mydevice デバイスのパスを変更します。

$ docker plugin inspect -f '{{with $device := index .Settings.Devices 0}}{{$device.Path}}{{end}}' myplugin

/dev/foo

$ docker plugins set myplugin mydevice.path=/dev/bar

$ docker plugin inspect -f '{{with $device := index .Settings.Devices 0}}{{$device.Path}}{{end}}' myplugin

/dev/bar

注釈

唯一の path のみ mydevice に設定できるように、 docker plugins set mydevice=/dev/bar myplugi も同様の挙動です。

引数のソースを変更

以下の例は myplugin プラグイン上の、引数の値を変更します。

$ docker plugin inspect -f '{{.Settings.Args}}' myplugin

["foo", "bar"]

$ docker plugins set myplugin myargs="foo bar baz"

$ docker plugin inspect -f '{{.Settings.Args}}' myplugin

["foo", "bar", "baz"]

親コマンド

コマンド 説明
docker plugin プラグインを管理

関連コマンド

コマンド 説明
docker plugin create rootfs と設定からプラグインを作成。プラグインのデータディレクトリには、 config.json と rootfs ディレクトリが必須
docker plugin disable プラグインの無効化
docker plugin enable プラグインの有効化
docker plugin inspect 1つまたは複数プラグインの詳細情報を表示
docker plugin install プラグインをインストール
docker plugin ls プラグイン一覧表示
docker plugin rm 1つまたは複数プラグインを削除
docker plugin set プラグインの設定を変更
docker plugin upgrade 既存のプラグインを更新