Comment on page

Advanced Label Selectors

Use advanced label selectors for precise workload scheduling

Selecting the right hardware for your workloads is key for performance. While the basic node labels as listed in the Node Types list are typically all that is needed to include in a Deployment manifest to schedule workloads properly, there are some situations in which more specific designations may be required, such as some instances of deploying custom containers.
On CoreWeave, compute nodes are tagged with Kubernetes labels, which specify their hardware type. In turn, Kubernetes affinities are specified in workload Deployment manifests to select these labels, ensuring that your workloads are correctly scheduled to the desired hardware type.
Note
For any questions about advanced scheduling or other special requirements, please contact support.
The following labels are attached to nodes on CoreWeave Cloud, and may be selected using affinities in the Deployment manifests, as demonstrated in the following affinity usage examples.
CPU model
Label
Refers to
Value options
node.coreweave.cloud/cpu
The CPU family of the CPU on the node
See CPU-only instances for a list of types and their values
Affinity usage example
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
          - key: node.coreweave.cloud/cpu
            operator: In
            values:
              - amd-epyc-rome
              - intel-xeon-v4
GPU count
Important
Using this selector is not recommended. Instead, request GPU resources by setting the GPU count in the Deployment spec; see the guide on deploying Custom Containers for examples.
Label
Refers to
Value options
gpu.nvidia.com/count
Number of GPUs provisioned in the node
4 to 8; must be included as a string
Affinity usage example
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
          - key: gpu.nvidia.com/count
            operator: In
            values:
              - "3"
GPU model
Label
Refers to
Value options
gpu.nvidia.com/class
The GPU model provisioned in the node
See Node Types for a list of types and their values
Affinity usage example
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
          - key: gpu.nvidia.com/class
            operator: In
            values:
              - A40
GPU VRAM
Label
Refers to
Value options
gpu.nvidia.com/vram
The GPU VRAM, in Gigabytes, on the GPUs provisioned in the node
See the VRAM column in the GPU-enabled Node Types list​
Affinity usage example
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
          - key: gpu.nvidia.com/vram
            operator: In
            values:
              - "8"
Uplink speed
Label
Refers to
Value options
ethernet.coreweave.cloud/speed
Uplink speed from node to the backbone
10G, 40G, 100G
Affinity usage example
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
          - key: ethernet.coreweave.cloud/speed
            operator: In
            values:
              - 40G
NVLink
Important
This label is currently applicable only for Tesla_V100 nodes.
Label
Refers to
Value options
gpu.nvidia.com/nvlink
Denotes whether or not GPUs are interconnected with NVLink
true, false
Affinity usage example
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
          - key: gpu.nvidia.com/nvlink
            operator: In
            values:
              - true
Data center region
Label
Refers to
Value options
topology.kubernetes.io/region
The region the node is placed in
ORD1, LAS1, LGA1
Affinity usage example
affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
          - key: topology.kubernetes.io/region
            operator: In
            values:
              - ORD1

Label	Refers to	Value options
`node.coreweave.cloud/cpu`	The CPU family of the CPU on the node	See CPU-only instances for a list of types and their values

Label	Refers to	Value options
`gpu.nvidia.com/count`	Number of GPUs provisioned in the node	`4` to `8`; must be included as a string

Label	Refers to	Value options
`gpu.nvidia.com/class`	The GPU model provisioned in the node	See Node Types for a list of types and their values

Label	Refers to	Value options
`gpu.nvidia.com/vram`	The GPU VRAM, in Gigabytes, on the GPUs provisioned in the node	See the VRAM column in the GPU-enabled Node Types list

Label	Refers to	Value options
`ethernet.coreweave.cloud/speed`	Uplink speed from node to the backbone	`10G`, `40G`, `100G`

Label	Refers to	Value options
`gpu.nvidia.com/nvlink`	Denotes whether or not GPUs are interconnected with NVLink	`true`, `false`

Label	Refers to	Value options
`topology.kubernetes.io/region`	The region the node is placed in	`ORD1`, `LAS1`, `LGA1`

CoreWeave Kubernetes - Previous

Sealed Secrets

Next - CoreWeave Kubernetes

CoSchedulers

Last modified 8mo ago