To list the docker swarm nodes, we can make use of the command docker node ls.

As part of our Docker hosting support service, Bobcares responds to all inquiries, no matter how small.

Let’s examine the various applications of the docker node ls command in more detail.

Docker Swarm List Nodes

docker node ls [OPTIONS] command displays a list of every node the Docker Swarm manager is aware of. We can use the -f or –filter flags to filter.

Options

We’ll go over all of the OPTIONS that are available for this command.

• --filter , -f : Filter the output based on the given conditions.
• --format : Making use of a Go template to pretty-print nodes
• --quiet , -q : only show IDs

Filtering

The format of the filtering flag (-f or –filter) is “key=value.” If there are multiple filters, pass each one separately (for example, –filter “foo=bar” –filter “bif=baz”). Below is a list of the filters that are currently supported:

id

The id filter matches all or a portion of the id of a node.

label

The label filter uses the engine labels and the presence of a label alone or a label and a value to match nodes. In the daemon configuration, engine labels are set. Use node.label to filter on Swarm node labels instead.

node.label

The node.label filter matches nodes based on node labels as well as whether a node.label is present either by itself or in conjunction with a value.

membership

Based on the existence of a membership and a value for accepted or pending, the membership filter matches nodes.

name

The name filter can match the entire node hostname or just a portion of it.

role

Based on the presence of a role and a value worker or manager, the role filter matches nodes.

Formatting

Using a Go template, the formatting options (–format) pretty-print nodes’ output. Below is a list of appropriate placeholders for the Go template:

The node ls command will output the data exactly as the template declares when the --format option is used, or, if the table directive is used, it will also output the column headers.

[Looking for a solution to another query? We are just a click away.]

Conclusion

To sum up, the docker node ls command displays a list of every node that the Docker Swarm manager is aware of. Our Support team explains the details of the various options and the functions we can use with this command.