Listing Nodes

List all compute nodes in your Fuzzball cluster

select

Please select either the web UI or CLI tab to see the appropriate instructions for your environment.

web UI

The Nodes page displays all compute nodes with their cluster affiliation, resource totals, and running job counts. When connected to a Federate cluster, a Cluster column identifies which underlying Orchestrate cluster each node belongs to.

CLI

List all compute nodes in the cluster:

$ fuzzball node list

ID               | CLUSTER  | HOSTNAME        | JOBS
node-worker-01     fb-aws    worker-01.local   1
node-worker-02     fb-aws    worker-02.local   0
node-worker-03     fb-aws    worker-03.local   2

The output shows:

ID: Unique identifier for the node
CLUSTER: Resolved cluster name
HOSTNAME: Network hostname
JOBS: Number of jobs currently running on this node

For the full record (CPU type, total/allocated/available cores and memory, device summaries, etc.) use -o yaml or -o json. When connected to a Federate cluster, the CLUSTER column distinguishes which underlying Orchestrate cluster each node is part of.

Available Resources

Use the --available flag to compute the per-node available cores, memory, and devices alongside the totals (visible in JSON / YAML output):

$ fuzzball node list --available -o yaml

JSON Output

For programmatic access or scripting, use the -o json flag:

$ fuzzball node list -o json

This returns node information in JSON format suitable for parsing with tools like jq:

$ fuzzball node list -o json | jq '.[] | select(.running_jobs > 0)'