dcos node list

Displaying DC/OS node information

Description

The dcos node list command displays a list of DC/OS master and agent nodes with identifying information, including:

  • Hostname
  • IP address
  • Public IP address
  • Unique identifier
  • Node type
  • Cluster region
  • Availability zone

You can use this command to look up the public agent IP address if DC/OS is deployed on a public cloud provider such as AWS, Google Cloud, or Azure. If DC/OS is installed on an internal network (on-premise) or on a private cloud, nodes do not typically have separate public and private IP addresses. For nodes on an internal network or private cloud, the public IP address is most often the same as the IP address defined for the server in the DNS namespace.

In most cases, you can use this command to return both the private and public IP addresses for each node. You should keep in mind, however, that the public and private IP addresses returned might not be accurate if the Edge-LB pool uses virtual networks.

Usage

  1. dcos node list [OPTION]

Options

Name, shorthandDescription
—field nameSpecifies the name of one or more additional fields you want to include in the output of the dcos node command. You can include this option multiple times to add multiple fields.
—help, hDisplays usage.
—infoDisplays a short description of this subcommand.
—jsonDisplays JSON-formatted data.
—mesos-idOnly displays the information concerning a node with a specific Mesos ID.
—versionDisplays version information.

Permissions

Running this command requires your service or user account to have the following administrative permissions:

dcos:adminrouter:ops:mesos full dcos:adminrouter:ops:mesos-dns full

If you don’t have an account with at least these permissions, the command returns an error.

To use this command to return public-facing IP addresses, your service or user account must have the following administrative permission:

dcos:adminrouter:ops:networking full

If you run the dcos node list command without this permission, the command returns node information but does not include the Public IP address column in the output. For more information about setting and managing permissions, see Permissions Management and Permissions Reference.

Parent command

CommandDescription
dcos nodeView DC/OS node information.

Example

To following example illustrates how you can use this command to find the public-facing IP address for nodes in a small cluster:

  1. dcos node list
  3. dcos node list
  4.     HOSTNAME         IP      PUBLIC IP(S)                     ID                          TYPE        STATUS       REGION           ZONE
  5.   10.0.2.148     10.0.2.148                 69e4f34a-e5c4-4271-85b5-b6609056bcde-S1  agent            ACTIVE    aws/us-west-2  aws/us-west-2a
  6.   10.0.4.118     10.0.4.118  52.34.156.169  69e4f34a-e5c4-4271-85b5-b6609056bcde-S0  agent (public)   ACTIVE    aws/us-west-2  aws/us-west-2a
  7.   master.mesos.  10.0.7.51   54.202.215.97  69e4f34a-e5c4-4271-85b5-b6609056bcde     master (leader)            aws/us-west-2  aws/us-west-2a

The following example illustrates adding port information to the output for the command:

  1. dcos node list --field port
  3.     HOSTNAME         IP      PUBLIC IP(S)                     ID                          TYPE        STATUS       REGION           ZONE       PORT
  4.   10.0.2.148     10.0.2.148                 69e4f34a-e5c4-4271-85b5-b6609056bcde-S1  agent             ACTIVE   aws/us-west-2  aws/us-west-2a  5051
  5.   10.0.4.118     10.0.4.118  52.34.156.169  69e4f34a-e5c4-4271-85b5-b6609056bcde-S0  agent (public)    ACTIVE   aws/us-west-2  aws/us-west-2a  5051
  6.   master.mesos.  10.0.7.51   54.202.215.97  69e4f34a-e5c4-4271-85b5-b6609056bcde     master (leader)            aws/us-west-2  aws/us-west-2a