Discovery reports a card in MIG mode as its instances instead of the whole card, on both paths: nvidia-smi (-L names them, -q -x gives their memory, ids and processes) and NVML (GetMigMode, GetMaxMigDeviceCount, GetMigDeviceHandleByIndex, behind an interface so it is tested with a fake). Each instance has its MIG UUID, its own memory, and a class from the card's and the profile: a100-80g-mig-3g.40gb. Placement numbers instances 1000 + 100 x card + instance and every view shows them as card/migN. A replica on MIG runs on exactly one instance: a process opens one MIG device and instances have no NVLink between them, so tp, pp, gpus or nodes above one on a MIG class are refused in catalog validation and again in placement, and the planner offers one instance or none. The agent gives the engine CUDA_VISIBLE_DEVICES=MIG-<uuid> (no Vulkan device variable on MIG). Memory and processes are per instance; heat, power and wear the card's; utilisation is left out rather than reported as zero. A card in MIG mode with nothing carved stays out of placement with the reason, and llmgw doctor reports each card's mode and instances and warns of the states in which nothing can run. ctl nodes, ctl status, the console and the plan count devices by class. docs/install.md has a MIG section. Written against fakes of nvidia-smi and NVML output; not yet run on MIG hardware. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
41 lines
1.4 KiB
Go
41 lines
1.4 KiB
Go
package agent
|
|
|
|
import (
|
|
"testing"
|
|
|
|
"gitea.mynodes.xyz/ilker/llmgw/internal/agent/discovery"
|
|
"gitea.mynodes.xyz/ilker/llmgw/internal/agent/engines"
|
|
)
|
|
|
|
func TestAShardPlacedOnAMIGInstanceIsLaunchedWithItsUUID(t *testing.T) {
|
|
// The control plane sends device 1001: card 0's instance 1, by the number
|
|
// placement gives it. Only this node knows the instance's UUID, which is
|
|
// the one thing CUDA will open it by.
|
|
a := &Agent{}
|
|
a.inv.GPUs = []discovery.GPU{
|
|
{Index: 1000, UUID: "MIG-aaa", MIG: &discovery.MIGDevice{ParentIndex: 0, Device: 0, Profile: "3g.40gb"}},
|
|
{Index: 1001, UUID: "MIG-bbb", MIG: &discovery.MIGDevice{ParentIndex: 0, Device: 1, Profile: "3g.40gb"}},
|
|
{Index: 1, UUID: "GPU-whole"},
|
|
}
|
|
|
|
spec := engines.ShardSpec{GPUIndices: []int{1001}}
|
|
a.localizeSpec(&spec)
|
|
if got := engines.NCCLEnv(spec)["CUDA_VISIBLE_DEVICES"]; got != "MIG-bbb" {
|
|
t.Errorf("CUDA_VISIBLE_DEVICES=%q, want MIG-bbb", got)
|
|
}
|
|
|
|
// A whole card is given by index, as it always was.
|
|
whole := engines.ShardSpec{GPUIndices: []int{1}}
|
|
a.localizeSpec(&whole)
|
|
if whole.GPUUUIDs != nil || engines.NCCLEnv(whole)["CUDA_VISIBLE_DEVICES"] != "1" {
|
|
t.Errorf("a whole card was given as %v / %q", whole.GPUUUIDs, engines.NCCLEnv(whole)["CUDA_VISIBLE_DEVICES"])
|
|
}
|
|
|
|
// A device this node does not have is not guessed at.
|
|
gone := engines.ShardSpec{GPUIndices: []int{1002}}
|
|
a.localizeSpec(&gone)
|
|
if gone.GPUUUIDs != nil {
|
|
t.Errorf("an unknown device was named %v", gone.GPUUUIDs)
|
|
}
|
|
}
|