Default tolerations
August 17, 2026 ยท View on GitHub
Just like any other scheduler NodeWright will not schedule packages on selected nodes when there are taints that the package does not explicitly tolerate. These nodes however are not just ignored as it is assumed that the user wanted their packages on these nodes due to their selection of nodeSelectors. In this case the following will happen:
On the NodeWright Custom Resource containing the package(s) targeting the affected nodes:
status:
status: blocked
nodeStatus:
[node name]: blocked
conditions:
- reason: TaintNotTolerable
status: "True"
type: TaintNotTolerable
message: Node [X, Y, Z, ...] has taints that are not tolerable. Skipping.
The legacy prefixed nodewright.nvidia.com/TaintNotTolerable condition type is retained for one release to allow existing consumers time to migrate.
Metrics:
- nodewright_node_status_count status=blocked
Default tolerations
The following taints are always tolerated by NodeWright
- Runtime Required (
controllerManager.manager.env.runtimeRequiredTaint, defaultnodewright.nvidia.com=runtime-required:NoSchedule) - Runtime Required, legacy key:
skyhook.nvidia.com=runtime-required:NoSchedule. Tolerated and removed for the rename deprecation window, never applied. See runtime_required.md. - Cordon taint:
node.kubernetes.io/unschedulable
Common Symptoms
The following are common ways a user might know they have taint problem:
- A NodeWright Custom Resource has status as
unknown(Operator < v0.9) orblocked(Operator >= v0.9) - A NodeWright Custom Resource is sitting with incomplete nodes.
Solutions
This can be solved in a few different ways:
- Remove the problem taint(s) from the node(s)
- Change the
nodeSelectorsfor the NodeWright Custom Resources to avoid the nodes - Set the
additionalTolerationson the NodeWright Custom Resources to enable toleration of the taints. An example doing this is included below.
apiVersion: nodewright.nvidia.com/v1alpha1
kind: NodeWright
metadata:
labels:
app.kubernetes.io/part-of: skyhook-operator
app.kubernetes.io/created-by: skyhook-operator
name: taint-scheduling
spec:
nodeSelectors:
matchLabels:
nodewright.nvidia.com/test-node: skyhooke2e
additionalTolerations:
- key: nvidia.com/gpu
effect: NoSchedule
packages: ...