docker plugin install
説明
プラグインをインストールします。
API 1.25 以上
このコマンドを利用するには、クライアントとデーモンの API はともに、最低でも
1.25
である必要があります。
クライアント上においてdocker version
コマンドを実行して、クライアントとデーモンの API バージョンを確認してください。
利用方法
$ docker plugin install [オプション] PLUGIN [KEY=VALUE...]
追加説明
プラグインをインストールして有効化します。 Docker は初めに Docker ホスト内のプラグインを探しにいきます。 ローカルにプラグインが存在していなかった場合は、レジストリからプルされます。 プラグインを提供するために必要となるレジストリの最低バージョンは 2.3.0 です。
本コマンドの利用例については、以下に示す 利用例の節 を参照してください。
オプション
名前/省略形 | デフォルト | 説明 |
--alias |
プラグインのローカル名。 | |
--disable |
インストール後にプラグインを有効にしません。 | |
--disable-content-trust |
true |
イメージの検証を省略します。 |
--grant-all-permissions |
プラグイン実行に必要となる権限をすべて許可します。 |
利用例
以下の例ではプラグインvieus/sshfs
をインストールし、環境変数DEBUG
を1
に 設定 します。
インストールの際には Docker Hub からプラグインをpull
し、プラグインに必要となる権限一覧を示してユーザーへの許可を求めます。
そしてプラグインへのパラメーターを設定した上で、このプラグインを有効にします。
$ docker plugin install vieux/sshfs DEBUG=1
Plugin "vieux/sshfs" 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
プラグインをインストールすれば、プラグイン一覧に表示されるようになります。
$ docker plugin ls
ID NAME DESCRIPTION ENABLED
69553ca1d123 vieux/sshfs:latest sshFS plugin for Docker true
上位コマンド
コマンド | 説明 |
---|---|
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 | 既存プラグインをアップグレードします。 |