docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Clean docs for uninstalling UCP

This commit is contained in:
Joao Fernandes 2016-08-11 13:38:01 -07:00
parent 4bf2f96e16
commit 496a18642f
1 changed files with 22 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
installation/uninstall.md
View File

@ -12,55 +12,32 @@ weight=70
# Uninstall UCP
Use the docker/ucp `uninstall-cluster` command to uninstall Docker Universal Control
Plane from your swarm cluster. This command only removes the UCP services,
containers and doesn’t affect any other services or containers. Your swarm
cluster will be left intact.
Docker UCP is designed to scale as your applications grow in size and usage.
You can [add and remove nodes](scale-your-cluster.md) from the cluster, to make
it scale to your needs.
To remove an individual node from UCP, and keep UCP intact, see the
documentation on joining nodes.
You can also uninstall Docker Universal Control plane from your cluster. In this
case the UCP services are stopped and removed, but your Docker Engines will
continue running in swarm mode. You applications will continue running normally.
## Example
After you uninstall UCP from the cluster, you'll no longer be able to enforce
role-based access control to the cluster, or have a centralized way to monitor
and manage the cluster.
In this example we’ll be running the `uninstall-cluster` command interactively, so that
the command prompts for the necessary configuration values.
You can also use flags to pass values to the `uninstall-cluster` command.
To uninstall UCP, log in into a manager node using ssh, and run:
1. Run the `uninstall-cluster` command.
```bash
$ docker run --rm -it \
```bash
$ docker run --rm -it \
-v /var/run/docker.sock:/var/run/docker.sock
--name ucp \
docker/ucp `uninstall-cluster` -i
docker/ucp uninstall-cluster --interactive
```
time="2016-08-09T20:36:36Z" level=info msg="Your engine version 1.12.0, build 8eab29e (4.4.16-boot2docker) is compatible"
time="2016-08-09T20:36:36Z" level=info msg="We're about to uninstall the local components for UCP ID: ZB6V:R3ZR:VMMJ:WM7B:M3US:VHMS:HZZ6:SHEL:RGXF:BHAE:2FPV:K7WH"
Do you want proceed with the uninstall? (y/n): y
time="2016-08-09T20:36:38Z" level=info msg="Uninstalling UCP on each node..."
time="2016-08-09T20:36:56Z" level=info msg="UCP has been removed from this cluster successfully."
time="2016-08-09T20:36:58Z" level=info msg="Removing UCP Services"
```
This runs the uninstall command in interactive mode, so that you are prompted
for any necessary configuration values.
[Check the reference documentation](../reference/index.md) to learn the options
available in the `uninstall-cluster` command.
2. List the images remaining on the node.
## Where to go next
```
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
docker/ucp latest 788bdcfde423 8 days ago 8.239 MB
```
The uninstall command removes all UCP-related images except the
`docker/ucp` image.
3. Remove the docker/ucp image.
```
$ docker rmi docker/ucp
Untagged: docker/ucp:latest
Deleted: sha256:788bdcfde423b6226b90ac98e6f233b15c0c527779177d7017a4e17db31404c9
Deleted: sha256:dee84053b25f9b3edffb734c842a70313021063cc78d9158c63de109e1b3cb72
Deleted: sha256:93743d5df2362466e2fe116a677ec6a4b0091bd09e889abfc9109047fcfcdebf
```
* [Scale your cluster](scale-your-cluster.md)