Add labels to cluster nodes

Estimated reading time: 1 minute

After deploying UCP you can add labels to your nodes. Labels are metadata that you can use to organize nodes. You can also use these labels as deployment constraints for your services.

When deploying a service, you can specify constraints, so that the service only gets scheduled on a node that has a label that fulfills all the constraints you specify.

As an example, you can apply labels based on their role in the development lifecycle, or the hardware resources they have.

In this example, when users deploy a service they can add constraints for the service to be scheduled on nodes that have an SSD storage.

Apply labels to a node

Log in with administrator credentials in the UCP web UI, navigate to the Nodes page, and choose the node you want to apply labels to.

Click the Add label button, and add one or more labels to the node.

Once you’re done, click Save Changes.

You can also do this from the CLI by running:

docker node update --label-add <key>=<value> <node-id>

Where to go next

chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page Request docs changes Get support