Node Addition in UCP cluster

Adding worker nodes to your Docker Universal Control Plane (UCP) cluster allows you to scale applications and distribute workloads. In this guide, you’ll learn how to provision a new host, install Docker Engine, join the Swarm cluster, and verify the node in the UCP console.

Prerequisites

• A running UCP cluster with at least one manager node
• A new host with a supported Linux distribution (e.g., Ubuntu, CentOS)
• SSH access and root or sudo privileges on the new host
• Network connectivity on ports 2376 (Docker daemon) and 2377 (Swarm)

1. Provisioning and Installing Docker Engine

On the new worker node, install Docker Engine using Docker’s official convenience script:

# On the new worker node
curl -fsSL https://get.docker.com | sh
sudo systemctl enable docker
sudo systemctl start docker

2. Joining the Swarm Cluster

First, retrieve the worker join token on your UCP manager:

# On the Swarm manager
docker swarm join-token worker

You’ll see output similar to:

To add a worker to this swarm, run the following command:

    docker swarm join --token SWMTKN-1-0abcd1234efgh5678ijkl9012mnop3456 10.0.0.5:2377

Copy the docker swarm join command and execute it on the new worker:

# On the new worker node
docker swarm join --token SWMTKN-1-0abcd1234efgh5678ijkl9012mnop3456 10.0.0.5:2377

3. Automatic UCP Agent Deployment

UCP configures its agent as a global service in Docker Swarm. After the worker joins:

1. Docker Swarm schedules the UCP agent on the new node.
2. The agent pulls and installs UCP components (e.g., UCP proxy).
3. The node is automatically registered with the UCP control plane.

4. Verification in UCP Console

1. Open the UCP web UI on your manager node.
2. Navigate to Nodes in the sidebar.
3. Confirm the new worker appears with the Worker role and a Ready status.

Next, let’s walk through a live demo to see this process in action!

Links and References

• Docker Engine Installation
• Docker Swarm Overview
• UCP Administration Guide