a4f5e30249
* Reword lots of instances of 'will' * Reword lots of instances of won't * Reword lots of instances of we'll * Eradicate you'll * Eradicate 'be able to' type of phrases * Eradicate 'unable to' type of phrases * Eradicate 'has / have to' type of phrases * Eradicate 'note that' type of phrases * Eradicate 'in order to' type of phrases * Redirect to official Chef and Puppet docs * Eradicate gratuitous 'please' * Reduce use of e.g. * Reduce use of i.e. * Reduce use of N.B. * Get rid of 'sexagesimal' and correct some errors
3.2 KiB
description, keywords, title
| description | keywords | title |
|---|---|---|
| Installs Docker Universal Control Plane. | docker, ucp, install | UCP tool reference |
Installs Docker Universal Control Plane.
Usage
$ docker run --rm -it \
--name ucp \
-v /var/run/docker.sock:/var/run/docker.sock \
docker/ucp \
command [arguments...]
Description
Docker Universal Control Plane Tool
This tool has commands to 'install' the UCP initial controller and 'join' nodes to that controller. The tool can also 'uninstall' the product. This tool must run as a container with a well-known name and with the docker.sock volume mounted, which you can cut-and-paste from the usage example below.
This tool will generate TLS certificates and will attempt to determine your hostname and primary IP addresses. This may be overridden with the '--host-address' option. The tool may not discover your externally visible fully qualified hostname. For proper certificate verification, you should pass one or more Subject Alternative Names with '--san' during 'install' and 'join' that matches the fully qualified hostname you intend to use to access the given system.
Many settings can be passed as flags or environment variables. When passing as an environment variable, use the 'docker run -e VARIABLE_NAME ...' syntax to pass the value from your shell, or 'docker run -e VARIABLE_NAME=value ...' to specify the value explicitly on the command line.
Additional help is available for each command with the '--help' option.
Options
| Option | Description |
|---|---|
--help, h |
Show help |
--version, -v |
Print the version |
Commands
| Command | Description |
|---|---|
install |
Install UCP on this engine |
join |
Join this engine to an existing UCP |
upgrade |
Upgrade the UCP components on this engine |
images |
Verify the UCP images on this engine |
uninstall |
Uninstall UCP components from this engine |
dump-certs |
Dump out the public certs for this UCP controller |
support |
Generate a support dump for this engine |
fingerprint |
Dump out the TLS fingerprint for the UCP controller running on this engine |
id |
Dump out the ID of the UCP components running on this engine |
engine-discovery |
Manage the engine discovery configuration |
backup |
Stream a tar file to stdout containing all UCP data volumes |
restore |
Stream a tar file on stdin containing all local UCP data volumes |
regen-certs |
Regenerate keys and certificates for a UCP controller |
help |
Shows a list of commands or help for one command |