You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/tasks/administer-cluster/memory-manager.md
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -51,7 +51,7 @@ The Memory Manager updates the Node Map during the startup and runtime as follow
51
51
52
52
This occurs once a node administrator employs `--reserved-memory` (section [Reserved memory flag](#reserved-memory-flag)). In this case, the Node Map becomes updated to reflect this reservation as illustrated in [Memory Manager KEP: Memory Maps at start-up (with examples)][5].
53
53
54
-
The administrator must provide `--reserved-memory` flag when `static` policy is configured.
54
+
The administrator must provide `--reserved-memory` flag when `Static` policy is configured.
55
55
56
56
### Runtime
57
57
@@ -61,29 +61,29 @@ Important topic in the context of Memory Manager operation is the management of
61
61
62
62
## Memory Manager configuration
63
63
64
-
Other Managers should be first pre-configured (section [Pre-configuration](#pre-configuration)). Next, the Memory Manger feature should be enabled (section [Enable the Memory Manager feature](#enable-the-memory-manager-feature)) and be run with `static` policy (section [static policy](#static-policy)). Optionally, some amount of memory can be reserved for system or kubelet processes to increase node stability (section [Reserved memory flag](#reserved-memory-flag)).
64
+
Other Managers should be first pre-configured (section [Pre-configuration](#pre-configuration)). Next, the Memory Manger feature should be enabled (section [Enable the Memory Manager feature](#enable-the-memory-manager-feature)) and be run with `Static` policy (section [Static policy](#static-policy)). Optionally, some amount of memory can be reserved for system or kubelet processes to increase node stability (section [Reserved memory flag](#reserved-memory-flag)).
65
65
66
66
### Policies
67
67
68
68
Memory Manager supports two policies. You can select a policy via a `kubelet` flag `--memory-manager-policy`.
69
69
70
70
Two policies can be selected:
71
71
72
-
*`none` (default)
73
-
*`static`
72
+
*`None` (default)
73
+
*`Static`
74
74
75
-
#### none policy {#policy-none}
75
+
#### None policy {#policy-none}
76
76
77
77
This is the default policy and does not affect the memory allocation in any way.
78
78
It acts the same as if the Memory Manager is not present at all.
79
79
80
-
The `none` policy returns default topology hint. This special hint denotes that Hint Provider (Memory Manger in this case) has no preference for NUMA affinity with any resource.
80
+
The `None` policy returns default topology hint. This special hint denotes that Hint Provider (Memory Manger in this case) has no preference for NUMA affinity with any resource.
81
81
82
-
#### static policy {#policy-static}
82
+
#### Static policy {#policy-static}
83
83
84
-
In the case of the `Guaranteed` pod, the `static` Memory Manger policy returns topology hints relating to the set of NUMA nodes where the memory can be guaranteed, and reserves the memory through updating the internal [NodeMap][2] object.
84
+
In the case of the `Guaranteed` pod, the `Static` Memory Manger policy returns topology hints relating to the set of NUMA nodes where the memory can be guaranteed, and reserves the memory through updating the internal [NodeMap][2] object.
85
85
86
-
In the case of the `BestEffort` or `Burstable` pod, the `static` Memory Manager policy sends back the default topology hint as there is no request for the guaranteed memory, and does not reserve the memory in the internal [NodeMap][2] object.
86
+
In the case of the `BestEffort` or `Burstable` pod, the `Static` Memory Manager policy sends back the default topology hint as there is no request for the guaranteed memory, and does not reserve the memory in the internal [NodeMap][2] object.
87
87
88
88
### Reserved memory flag
89
89
@@ -100,7 +100,7 @@ The Memory Manager will not use this reserved memory for the allocation of conta
100
100
101
101
For example, if you have a NUMA node "NUMA0" with `10Gi` of memory available, and the `--reserved-memory` was specified to reserve `1Gi` of memory at "NUMA0", the Memory Manager assumes that only `9Gi` is available for containers.
102
102
103
-
You can omit this parameter, however, you should be aware that the quantity of reserved memory from all NUMA nodes should be equal to the quantity of memory specified by the [Node Allocatable feature](/docs/tasks/administer-cluster/reserve-compute-resources/). If at least one node allocatable parameter is non-zero, you will need to specify `--reserved-memory` for at least one NUMA node. In fact, `eviction-hard` threshold value is equal to `100Mi` by default, so if `static` policy is used, `--reserved-memory` is obligatory.
103
+
You can omit this parameter, however, you should be aware that the quantity of reserved memory from all NUMA nodes should be equal to the quantity of memory specified by the [Node Allocatable feature](/docs/tasks/administer-cluster/reserve-compute-resources/). If at least one node allocatable parameter is non-zero, you will need to specify `--reserved-memory` for at least one NUMA node. In fact, `eviction-hard` threshold value is equal to `100Mi` by default, so if `Static` policy is used, `--reserved-memory` is obligatory.
104
104
105
105
Also, avoid the following configurations:
106
106
1. duplicates, i.e. the same NUMA node or memory type, but with a different value;
@@ -152,7 +152,7 @@ Here is an example of a correct configuration:
@@ -163,7 +163,7 @@ Let us validate the configuration above:
163
163
164
164
## Placing a Pod in the Guaranteed QoS class
165
165
166
-
If the selected policy is anything other than `none`, the Memory Manager identifies pods that are in the `Guaranteed` QoS class. The Memory Manager provides specific topology hints to the Topology Manager for each `Guaranteed` pod. For pods in a QoS class other than `Guaranteed`, the Memory Manager provides default topology hints to the Topology Manager.
166
+
If the selected policy is anything other than `None`, the Memory Manager identifies pods that are in the `Guaranteed` QoS class. The Memory Manager provides specific topology hints to the Topology Manager for each `Guaranteed` pod. For pods in a QoS class other than `Guaranteed`, the Memory Manager provides default topology hints to the Topology Manager.
167
167
168
168
The following excerpts from pod manifests assign a pod to the `Guaranteed` QoS class.
169
169
@@ -270,7 +270,7 @@ spec:
270
270
Next, let us log into the node where it was deployed and examine the state file in `/var/lib/kubelet/memory_manager_state`:
0 commit comments