GPUStack Operator

Topology

GPUStack describes domains such as zones and racks. Kueue accounts for capacity within those domains.

Contents

Overview

Placement and scheduling

A TopologySource can select an inventory path and hierarchy. Without a source, GPUStack uses the default profile. GPUStack publishes profiles and Kueue Topology resources for placement.

Topology discovery and placement flow

Configuration

Topology sources

Choose an inventory path in Topology Operations , then configure Node labels , a ConfigMap snapshot , or a webhook . Topology-Aware Scheduling defines the placement contract.

Operations

  1. Step 1: Choose a source. Select the inventory path that matches your cluster.
  2. Step 2: Configure the source. Apply the TopologySource manifest and any backing snapshot or webhook.
  3. Step 3: Verify the objects. Check the source, queue, assignment and Pod nodes, then request a level .

Use Verification for commands and expected status. Follow the hierarchical placement walkthrough for an example.

Troubleshooting

For a Pending group, follow diagnosis . Compare the requested domain with the queue, topology and available capacity.