mirror of https://github.com/docker/cli.git
89 lines
2.8 KiB
Markdown
89 lines
2.8 KiB
Markdown
---
|
|
title: "plugin upgrade"
|
|
description: "the plugin upgrade command description and usage"
|
|
keywords: "plugin, upgrade"
|
|
---
|
|
|
|
<!-- This file is maintained within the docker/docker Github
|
|
repository at https://github.com/docker/docker/. Make all
|
|
pull requests against that repo. If you see this file in
|
|
another repository, consider it read-only there, as it will
|
|
periodically be overwritten by the definitive file. Pull
|
|
requests which include edits to this file in other repositories
|
|
will be rejected.
|
|
-->
|
|
|
|
# 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)
|