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

2.8 KiB
Raw Blame History

description keywords menu title
Learn how to uninstall a Docker Universal Control Plane cluster.
docker, ucp, uninstall
main
identifier parent weight
ucp_uninstall mn_ucp_installation 60
Uninstall UCP

Uninstall UCP

Use the docker/ucp uninstall command, to uninstall Docker Universal Control Plane from a node. This command only removes the UCP containers, and doesn’t affect any other containers.

To see what options are available in the uninstall command, check the uninstall command reference.

To uninstall Docker UCP from a cluster, you need to:

  1. Uninstall UCP from every node joined in the cluster,
  2. Uninstall UCP from every controller node, one at a time,
  3. Restart the Docker engine on all the nodes.

Example

In this example we’ll be running the uninstall command interactively, so that the command prompts for the necessary configuration values. You can also use flags to pass values to the uninstall command.

  1. Run the uninstall command.

    $ docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock
  --name ucp \
  docker/ucp uninstall -i

INFO[0000] Were about to uninstall the local components for UCP ID: FEY4:M46O:7OUS:QQA4:HLR3:4HRD:IUTH:LC2W:QPRE:BLYH:UWEM:3TYV
Do you want proceed with the uninstall? (y/n): y

INFO[0000] Removing UCP Containers
INFO[0000] Removing UCP images
INFO[0005] Removing UCP volumes

  2. List the images remaining on the node.

    $ 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

  4. Restart the Docker daemon.

    When you install or join a node, UCP configures the Docker engine on that node for multi-host networking. When uninstalling, the configuration is reverted to its original state, but you need to restart the Docker engine for the configurations to take effect.

    As an example, to restart the Docker engine on a Ubuntu distribution:

    $ sudo service docker restart

  5. Confirm the node was removed from the cluster.

    In the UCP web application, confirm the node is no longer listed. It might take a few minutes for UCP to stop listing that node.