DockerCLI/docs/reference/commandline/node_inspect.md

3.0 KiB

Warning: this command is part of the Swarm management feature introduced in Docker 1.12, and might be subject to non backward-compatible changes.

node inspect

Usage: docker node inspect [OPTIONS] self|NODE [NODE...]

Return low-level information on a volume

  -f, --format=       Format the output using the given go template.
  --help              Print usage
  -p, --pretty        Print the information in a human friendly format.

Returns information about a node. By default, this command renders all results in a JSON array. You can specify an alternate format to execute a given template for each result. Go's text/template package describes all the details of the format.

Example output:

$ docker node inspect swarm-manager
[
  {
    "ID": "0gac67oclbxq7",
    "Version": {
        "Index": 2028
    },
    "CreatedAt": "2016-06-06T20:49:32.720047494Z",
    "UpdatedAt": "2016-06-07T00:23:31.207632893Z",
    "Spec": {
        "Role": "MANAGER",
        "Membership": "ACCEPTED",
        "Availability": "ACTIVE"
    },
    "Description": {
        "Hostname": "swarm-manager",
        "Platform": {
            "Architecture": "x86_64",
            "OS": "linux"
        },
        "Resources": {
            "NanoCPUs": 1000000000,
            "MemoryBytes": 1044250624
        },
        "Engine": {
            "EngineVersion": "1.12.0",
            "Labels": {
                "provider": "virtualbox"
            }
        }
    },
    "Status": {
        "State": "READY"
    },
    "Manager": {
        "Raft": {
            "RaftID": 2143745093569717375,
            "Addr": "192.168.99.118:4500",
            "Status": {
                "Leader": true,
                "Reachability": "REACHABLE"
            }
        }
    },
    "Attachment": {},
  }
]

$ docker node inspect --format '{{ .Manager.Raft.Status.Leader }}' self
false

$ docker node inspect --pretty self
ID:                     2otfhz83efcc7
Hostname:               ad960a848573
Status:
 State:                 Ready
 Availability:          Active
Manager Status:
 Address:               172.17.0.2:2377
 Raft status:           Reachable
 Leader:                Yes
Platform:
 Operating System:      linux
 Architecture:          x86_64
Resources:
 CPUs:                  4
 Memory:                7.704 GiB
Plugins:
  Network:              overlay, bridge, null, host, overlay
  Volume:               local
Engine Version:         1.12.0