mirror of
https://github.com/docker/docs.git
synced 2026-04-05 02:38:52 +07:00
Running the UCP upgrade upgrades all managers and workers to the new version, contrary to what is described here. Here is sample output from running this command: $ docker container run --rm -it --name ucp -v /var/run/docker.sock:/var/run/docker.sock docker/ucp:2.2.12 upgrade --interactive Unable to find image 'docker/ucp:2.2.12' locally 2.2.12: Pulling from docker/ucp a073c86ecf9e: Already exists fae35fe3a426: Pull complete f13c1be613a6: Pull complete Digest: sha256:61d4a2e8969a0139187ecf13af8c0020bb7bb5ff5efa2b06e331394a67bd4b68 Status: Downloaded newer image for docker/ucp:2.2.12 INFO[0000] Your engine version 17.06.2-ee-16, build 9ef4f0a (4.4.0-133-generic) is compatible INFO[0000] Upgrade the UCP 2.2.5 installation on this cluster to 2.2.12 for UCP ID: sc3nkn5p6rnc33o1e33mnqa1r INFO[0000] Once this operation completes, all nodes in this cluster will be upgraded. Do you want proceed with the upgrade? (y/n): y
2.8 KiB
2.8 KiB
title, description, keywords
| title | description | keywords |
|---|---|---|
| docker/ucp upgrade | Upgrade the UCP components on this node | 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 command.
After upgrading UCP, go to the UCP web UI 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-username |
The UCP administrator username |
--admin-password |
The UCP administrator password |
--pull |
Pull UCP images: always, when missing, or never |
--registry-username |
Username to use when pulling images |
--registry-password |
Password to use when pulling images |
--id |
The ID of the UCP instance to upgrade |
--host-address |
Override the previously configured host address with this IP or network interface |
--force-minimums |
Force the install/upgrade even if the system does not meet the minimum requirements |
--pod-cidr |
Kubernetes cluster IP pool for the pods to allocated IP from (Default: 192.168.0.0/16 |
--nodeport-range |
Allowed port range for Kubernetes services of type NodePort (Default: 32768-35535) |
--cloud-provider |
The cloud provider for the cluster |
--cni-installer-url |
A URL pointing to a kubernetes YAML file to be used as an installer for the CNI plugin of the cluster |