CLI Reference

nvcrectl cluster

View as Markdown

nvcrectl cluster info

Discovers GPU nodes in the cluster and reports the detected platform, GPU architecture, per-node GPU count, and network topology (rack/T1 leaf switch grouping).

$nvcrectl cluster info [flags]

The topology key is auto-detected per cloud platform:

PlatformTopology label
AWStopology.k8s.aws/network-node-layer-1
GCPcloud.google.com/gce-topology-block
Azurekubernetes.azure.com/ppg

Use --topology-key to override for other environments.

Flags

FlagDefaultDescription
--output / -otableOutput format: table, json, or yaml
--topology-keyautoNode label for topology grouping

Example

$# Table output (default)
$nvcrectl cluster info
$
$# JSON output for scripting
$nvcrectl cluster info -o json

Sample output

Platform:     aws
GPU:          NVIDIA H100 80GB HBM3 (h100, 8 GPUs/node)
Nodes:        16 ready
TOPOLOGY (topology.k8s.aws/network-node-layer-1):
  rack-a    8 nodes
  rack-b    8 nodes