From 9f830bf9a7740121c5bae7efb43cb617c74591aa Mon Sep 17 00:00:00 2001 From: Julien Pepy Date: Thu, 18 Dec 2025 14:31:15 +0100 Subject: [PATCH] Fix max-allowable-numa-nodes documentation The current documentation implies that the value for `max-allowable-numa-nodes` is a boolean, whereas an integer is actually expected. Adding also a kubelet config example since TopologyManager options are wrapped as string. See: https://github.com/kubernetes/kubernetes/blob/bb52ae5e24a4eb118460e8feadee86b9f41b4244/pkg/kubelet/cm/topologymanager/policy_options.go#L61 --- .../docs/tasks/administer-cluster/topology-manager.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/content/en/docs/tasks/administer-cluster/topology-manager.md b/content/en/docs/tasks/administer-cluster/topology-manager.md index 8142340d73dbc..b13c26ae3d891 100644 --- a/content/en/docs/tasks/administer-cluster/topology-manager.md +++ b/content/en/docs/tasks/administer-cluster/topology-manager.md @@ -271,7 +271,14 @@ lack of data, using this policy option with Kubernetes {{< skew currentVersion > at your own risk. {{< /note >}} -You can enable this option by adding `max-allowable-numa-nodes=true` to the Topology Manager policy options. +You can enable this option by adding to the Topology Manager policy options `max-allowable-numa-nodes=`, +where `numa_nodes_threshold` is an integer defining the new NUMA nodes threshold for starting the kubelet. +Here is an example of such configuration in kubelet configuration file: + +```yaml +topologyManagerPolicyOptions: + max-allowable-numa-nodes: "32" +``` Setting a value of `max-allowable-numa-nodes` does not (in and of itself) affect the latency of pod admission, but binding a Pod to a (Kubernetes) node with many NUMA does have an impact. @@ -394,4 +401,4 @@ assignments. (beta) for more options. 1. The scheduler is not topology-aware, so it is possible to be scheduled on a node and then fail - on the node due to the Topology Manager. + on the node due to the Topology Manager. \ No newline at end of file