mirror of https://github.com/docker/docs.git
46 lines
2.3 KiB
Markdown
46 lines
2.3 KiB
Markdown
---
|
|
title: docker/ucp upgrade
|
|
description: Upgrade the UCP components on this node
|
|
keywords: ucp, cli, upgrade
|
|
---
|
|
|
|
Upgrade the UCP cluster.
|
|
|
|
## Usage
|
|
|
|
```
|
|
docker container run --rm -it \
|
|
--name ucp \
|
|
-v /var/run/docker.sock:/var/run/docker.sock \
|
|
docker/ucp \
|
|
upgrade [command options]
|
|
```
|
|
|
|
## Description
|
|
|
|
This command upgrades the UCP running on this cluster.
|
|
|
|
Before performing an upgrade, you should perform a backup by using the
|
|
[backup](backup.md) command.
|
|
|
|
After upgrading UCP, go to the UCP web interface and confirm each node is
|
|
healthy and that all nodes have been upgraded successfully.
|
|
|
|
|
|
## Options
|
|
|
|
| Option | Description |
|
|
|:------------------------------|:------------------------------------------------------------------------------------|
|
|
| `--debug, D` | Enable debug mode |
|
|
| `--jsonlog` | Produce json formatted output for easier parsing |
|
|
| `--interactive, i` | Run in interactive mode and prompt for configuration values |
|
|
| `--admin-password` *value* | The UCP administrator password |
|
|
| `--admin-username` *value* | The UCP administrator username |
|
|
| `--force-minimums` | Force the install/upgrade even if the system does not meet the minimum requirements |
|
|
| `--host-address` *value* | Override the previously configured host address with this IP or network interface |
|
|
| `--id` | The ID of the UCP instance to upgrade |
|
|
| `--manual-worker-upgrade` | Whether to manually upgrade worker nodes. Defaults to false |
|
|
| `--pull` | Pull UCP images: `always`, when `missing`, or `never` |
|
|
| `--registry-password` *value* | Password to use when pulling images |
|
|
| `--registry-username` *value* | Username to use when pulling images |
|