github.com/sld880311/docker@v0.0.0-20200524143708-d5593973a475/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  ## Description
    31  
    32  Upgrades an existing plugin to the specified remote plugin image. If no remote
    33  is specified, Docker will re-pull the current image and use the updated version.
    34  All existing references to the plugin will continue to work.
    35  The plugin must be disabled before running the upgrade.
    36  
    37  ## Examples
    38  
    39  The following example installs `vieus/sshfs` plugin, uses it to create and use
    40  a volume, then upgrades the plugin.
    41  
    42  ```bash
    43  $ docker plugin install vieux/sshfs DEBUG=1
    44  
    45  Plugin "vieux/sshfs:next" is requesting the following privileges:
    46   - network: [host]
    47   - device: [/dev/fuse]
    48   - capabilities: [CAP_SYS_ADMIN]
    49  Do you grant the above permissions? [y/N] y
    50  vieux/sshfs:next
    51  
    52  $ docker volume create -d vieux/sshfs:next -o sshcmd=root@1.2.3.4:/tmp/shared -o password=XXX sshvolume
    53  sshvolume
    54  $ docker run -it -v sshvolume:/data alpine sh -c "touch /data/hello"
    55  $ docker plugin disable -f vieux/sshfs:next
    56  viex/sshfs:next
    57  
    58  # Here docker volume ls doesn't show 'sshfsvolume', since the plugin is disabled
    59  $ docker volume ls
    60  DRIVER              VOLUME NAME
    61  
    62  $ docker plugin upgrade vieux/sshfs:next vieux/sshfs:next
    63  Plugin "vieux/sshfs:next" is requesting the following privileges:
    64   - network: [host]
    65   - device: [/dev/fuse]
    66   - capabilities: [CAP_SYS_ADMIN]
    67  Do you grant the above permissions? [y/N] y
    68  Upgrade plugin vieux/sshfs:next to vieux/sshfs:next
    69  $ docker plugin enable vieux/sshfs:next
    70  viex/sshfs:next
    71  $ docker volume ls
    72  DRIVER              VOLUME NAME
    73  viuex/sshfs:next    sshvolume
    74  $ docker run -it -v sshvolume:/data alpine sh -c "ls /data"
    75  hello
    76  ```
    77  
    78  ## Related commands
    79  
    80  * [plugin create](plugin_create.md)
    81  * [plugin disable](plugin_disable.md)
    82  * [plugin enable](plugin_enable.md)
    83  * [plugin inspect](plugin_inspect.md)
    84  * [plugin install](plugin_install.md)
    85  * [plugin ls](plugin_ls.md)
    86  * [plugin push](plugin_push.md)
    87  * [plugin rm](plugin_rm.md)
    88  * [plugin set](plugin_set.md)