NodeInventory
What a node advertises through nodeInventoryUpdated events. See §3.6.
Field |
Type |
Repeated |
Description |
total_capacity |
vCPUs (fractional): cluster workers advertise their cpuCount; cloud machine types declare their shape’s vCPUs. |
||
utilization_cap |
|||
total_cores |
|||
gpus |
✅ |
||
capabilities |
✅ |
||
reserved_capacity |
|||
reserved_cores |
|||
reserved_capabilities |
✅ |
||
reachable |
|||
last_seen |
google.protobuf.Timestamp |
||
cordoned |
Set true by an operator drain (§8.6); placement skips this node. |
||
assigned_jobs |
✅ |
||
reserved_host_ports |
✅ |
Host sockets (canonical |
|
held_images |
✅ |
Images this node’s container engine holds — its WARMTH (Phase G of .ai/steve/tasks/90-job-migration-media.md). A launch on a node that already holds a job’s images took 7 s in the demo against 64–118 s on one that did not, so placement wants this on every candidate. A repeated field of its own rather than attributes on a Capability:
The worker refreshes this on the inventory cadence and immediately after a prefetch or a job start, excludes untagged/dangling images, and caps the list (most-recently-created first) so a long-lived node cannot grow the message without bound. |