docker plugin set

読む時間の目安: 2 分

説明

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

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

利用方法

$ 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

メモ

mymountにおいてはsourceだけが設定可能であるため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

メモ mydeviceにおいてはpathだけが設定可能であるためdocker plugins set mydevice=/dev/bar mypluginとしても動作します。

引数値の変更

以下の例は、プラグイン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 push	レジストリにプラグインをプッシュします。
docker plugin rm	1 つまたは複数のプラグインを削除します。
docker plugin set	プラグインの設定を変更します。
docker plugin upgrade	既存プラグインをアップグレードします。