docker plugin upgrade

読む時間の目安: 2 分

説明

既存プラグインをアップグレードします。

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

利用方法

$ docker plugin upgrade [オプション] PLUGIN [REMOTE]

追加説明

指定されたリモートのプラグインイメージに対して、既存プラグインをアップグレードします。 リモートが指定されなかった場合 Docker はカレントイメージを再度プルし、更新されたバージョンを利用します。 存在しているプラグインへの参照はすべて、変わらずに動作します。 プラグインをアップグレードするには無効化しておかなければなりません。

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

オプション

名前／省略形 デフォルト 説明
--disable-content-trust true イメージの検証を省略します。
--grant-all-permissions プラグイン実行に必要な権限をすべて許可します。
--skip-remote-check リモートプラグインと既存のプラグインイメージが一致するかどうかのチェックを行いません。

利用例

以下の例はvieus/sshfsプラグインをインストールします。 これを使ってボリュームを生成して、その後にプラグインをアップグレードします。

$ docker plugin install vieux/sshfs DEBUG=1

Plugin "vieux/sshfs:next" is requesting the following privileges:
 - network: [host]
 - device: [/dev/fuse]
 - capabilities: [CAP_SYS_ADMIN]
Do you grant the above permissions? [y/N] y
vieux/sshfs:next

$ docker volume create -d vieux/sshfs:next -o sshcmd=root@1.2.3.4:/tmp/shared -o password=XXX sshvolume

sshvolume

$ docker run -it -v sshvolume:/data alpine sh -c "touch /data/hello"

$ docker plugin disable -f vieux/sshfs:next

viex/sshfs:next

# Here docker volume ls doesn't show 'sshfsvolume', since the plugin is disabled
$ docker volume ls

DRIVER              VOLUME NAME

$ docker plugin upgrade vieux/sshfs:next vieux/sshfs:next

Plugin "vieux/sshfs:next" is requesting the following privileges:
 - network: [host]
 - device: [/dev/fuse]
 - capabilities: [CAP_SYS_ADMIN]
Do you grant the above permissions? [y/N] y
Upgrade plugin vieux/sshfs:next to vieux/sshfs:next

$ docker plugin enable vieux/sshfs:next

viex/sshfs:next

$ docker volume ls

DRIVER              VOLUME NAME
viuex/sshfs:next    sshvolume

$ docker run -it -v sshvolume:/data alpine sh -c "ls /data"

hello

上位コマンド

コマンド 説明
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 既存プラグインをアップグレードします。