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.