these markdown files are not consumed directly in the docs, but only their content is included through the YAML does, so there's no need to have these comments in them Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
92 lines
2.4 KiB
Markdown
92 lines
2.4 KiB
Markdown
---
|
|
title: "plugin upgrade"
|
|
description: "the plugin upgrade command description and usage"
|
|
keywords: "plugin, upgrade"
|
|
---
|
|
|
|
# plugin upgrade
|
|
|
|
```markdown
|
|
Usage: docker plugin upgrade [OPTIONS] PLUGIN [REMOTE]
|
|
|
|
Upgrade a plugin
|
|
|
|
Options:
|
|
--disable-content-trust Skip image verification (default true)
|
|
--grant-all-permissions Grant all permissions necessary to run the plugin
|
|
--help Print usage
|
|
--skip-remote-check Do not check if specified remote plugin matches existing plugin image
|
|
```
|
|
|
|
## Description
|
|
|
|
Upgrades an existing plugin to the specified remote plugin image. If no remote
|
|
is specified, Docker will re-pull the current image and use the updated version.
|
|
All existing references to the plugin will continue to work.
|
|
The plugin must be disabled before running the upgrade.
|
|
|
|
## Examples
|
|
|
|
The following example installs `vieus/sshfs` plugin, uses it to create and use
|
|
a volume, then upgrades the plugin.
|
|
|
|
```bash
|
|
$ 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
|
|
```
|
|
|
|
## Related commands
|
|
|
|
* [plugin create](plugin_create.md)
|
|
* [plugin disable](plugin_disable.md)
|
|
* [plugin enable](plugin_enable.md)
|
|
* [plugin inspect](plugin_inspect.md)
|
|
* [plugin install](plugin_install.md)
|
|
* [plugin ls](plugin_ls.md)
|
|
* [plugin push](plugin_push.md)
|
|
* [plugin rm](plugin_rm.md)
|
|
* [plugin set](plugin_set.md)
|