github.com/olljanat/moby@v1.13.1/docs/reference/commandline/plugin_upgrade.md (about)

     1  ---
     2  title: "plugin upgrade"
     3  description: "the plugin upgrade command description and usage"
     4  keywords: "plugin, upgrade"
     5  ---
     6  
     7  <!-- This file is maintained within the docker/docker Github
     8       repository at https://github.com/docker/docker/. Make all
     9       pull requests against that repo. If you see this file in
    10       another repository, consider it read-only there, as it will
    11       periodically be overwritten by the definitive file. Pull
    12       requests which include edits to this file in other repositories
    13       will be rejected.
    14  -->
    15  
    16  # plugin upgrade
    17  
    18  ```markdown
    19  Usage:  docker plugin upgrade [OPTIONS] PLUGIN [REMOTE]
    20  
    21  Upgrade a plugin
    22  
    23  Options:
    24        --disable-content-trust   Skip image verification (default true)
    25        --grant-all-permissions   Grant all permissions necessary to run the plugin
    26        --help                    Print usage
    27        --skip-remote-check       Do not check if specified remote plugin matches existing plugin image
    28  ```
    29  
    30  Upgrades an existing plugin to the specified remote plugin image. If no remote
    31  is specified, Docker will re-pull the current image and use the updated version.
    32  All existing references to the plugin will continue to work.
    33  The plugin must be disabled before running the upgrade.
    34  
    35  The following example installs `vieus/sshfs` plugin, uses it to create and use
    36  a volume, then upgrades the plugin.
    37  
    38  ```bash
    39  $ docker plugin install vieux/sshfs DEBUG=1
    40  
    41  Plugin "vieux/sshfs:next" is requesting the following privileges:
    42   - network: [host]
    43   - device: [/dev/fuse]
    44   - capabilities: [CAP_SYS_ADMIN]
    45  Do you grant the above permissions? [y/N] y
    46  vieux/sshfs:next
    47  
    48  $ docker volume create -d vieux/sshfs:next -o sshcmd=root@1.2.3.4:/tmp/shared -o password=XXX sshvolume
    49  sshvolume
    50  $ docker run -it -v sshvolume:/data alpine sh -c "touch /data/hello"
    51  $ docker plugin disable -f vieux/sshfs:next
    52  viex/sshfs:next
    53  
    54  # Here docker volume ls doesn't show 'sshfsvolume', since the plugin is disabled
    55  $ docker volume ls
    56  DRIVER              VOLUME NAME
    57  
    58  $ docker plugin upgrade vieux/sshfs:next vieux/sshfs:next
    59  Plugin "vieux/sshfs:next" is requesting the following privileges:
    60   - network: [host]
    61   - device: [/dev/fuse]
    62   - capabilities: [CAP_SYS_ADMIN]
    63  Do you grant the above permissions? [y/N] y
    64  Upgrade plugin vieux/sshfs:next to vieux/sshfs:next
    65  $ docker plugin enable vieux/sshfs:next
    66  viex/sshfs:next
    67  $ docker volume ls
    68  DRIVER              VOLUME NAME
    69  viuex/sshfs:next    sshvolume
    70  $ docker run -it -v sshvolume:/data alpine sh -c "ls /data"
    71  hello
    72  ```
    73  
    74  ## Related information
    75  
    76  * [plugin create](plugin_create.md)
    77  * [plugin disable](plugin_disable.md)
    78  * [plugin enable](plugin_enable.md)
    79  * [plugin inspect](plugin_inspect.md)
    80  * [plugin install](plugin_install.md)
    81  * [plugin ls](plugin_ls.md)
    82  * [plugin push](plugin_push.md)
    83  * [plugin rm](plugin_rm.md)
    84  * [plugin set](plugin_set.md)