starlingx/docs
Code Issues Proposed changes

Uprev Platform App - app-kubernetes-power-manager

Browse Source 
Story: 2011069
Task: 49755

Change-Id: Ic81425411796b2a98dc32302a9d7e86063eb82be
Signed-off-by: Ngairangbam Mili <ngairangbam.mili@windriver.com>
This commit is contained in:
Ngairangbam Mili 2024-05-30 07:31:27 +00:00
parent 297649d3e0
commit fd280ee882
1 changed files with 87 additions and 71 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

158
doc/source/node_management/kubernetes/configurable-power-manager-04c24b536696.rst
View File

@ -81,12 +81,18 @@ application.
intel-power-operator intel-power-operator
* - Role * - Role
- operator-custom-resource-definitions-role - operator-custom-resource-definitions-role
* - RoleBinding
- operator-custom-resource-definitions-role-binding
* - Cluster Role * - Cluster Role
- operator-nodes - operator-nodes
manager-role manager-role
node-agent-cluster-resources node-agent-cluster-resources
* - Cluster Role Binding
- operator-nodes-binding
node-agent-cluster-resources-binding
* - Custom Resource Definition * - Custom Resource Definition
- cstates.power.intel.com - cstates.power.intel.com
@ -220,8 +226,7 @@ and select all CPU cores available except the platform cores that use the
.. note:: .. note::
The CPU p-state of the platform cores will not be managed by Power Manager The CPU p-state of the platform cores is managed by the use of the ``reservedProfile`` parameter.
and will continue to use the settings defined as tuned.
.. rubric:: **Node Agent Pod** .. rubric:: **Node Agent Pod**
@ -280,6 +285,9 @@ min:
reservedCPUs: reservedCPUs:
List of CPU cores to not apply the profile (platform cores) List of CPU cores to not apply the profile (platform cores)
reservedProfile:
The profile to apply to platform cores
.. rubric:: **c-states Profile [section cstatesProfile]:** .. rubric:: **c-states Profile [section cstatesProfile]:**
sharedPoolCStates: sharedPoolCStates:
@ -288,11 +296,11 @@ sharedPoolCStates:
individualCoreCStates: individualCoreCStates:
List of all platform CPU cores: List of all platform CPU cores:
- setList of CPU c-states for each application core and their status (on/off) - List of CPU c-states for each application core and their status (on/off)
See the example below to to configure host controller-0. This setting will See the example below to configure host controller-0. This setting will
override the CPU governor and maximum CPU frequency in Shared Profile and override the CPU governor and maximum CPU frequency in Shared Profile and
disable C2 state for the platform cores (0,32) and enable C2 state for all disable C6 state for the platform cores (0,96) and enable C6 state for all
application cores through the c-state Profile. application cores through the c-state Profile.
.. code-block:: none .. code-block:: none
@ -306,11 +314,11 @@ application cores through the c-state Profile.
controller-0: controller-0:
individualCoreCStates: individualCoreCStates:
"0": "0":
C2: false C6: false
"32": "96":
C2: false C6: false
sharedPoolCStates: sharedPoolCStates:
C2: true C6: true
Applying these ``user_overrides`` will generate a new configuration Applying these ``user_overrides`` will generate a new configuration
(``combined_overrides``) by merging and overriding the auto-generated (``combined_overrides``) by merging and overriding the auto-generated
@ -323,62 +331,70 @@ in the ``system_overrides`` section and the user configuration in
(keystone_admin)]$ system helm-override-show kubernetes-power-manager kubernetes-power-manager intel-power (keystone_admin)]$ system helm-override-show kubernetes-power-manager kubernetes-power-manager intel-power
+--------------------+--------------------------------------------------------------------+ +--------------------+---------------------------------------------------------------------+
| Property | Value | | Property | Value |
+--------------------+--------------------------------------------------------------------+ +--------------------+---------------------------------------------------------------------+
| attributes | enabled: true | | attributes | enabled: true |
| | | | | |
| combined_overrides | cstatesProfile: | | combined_overrides | cstatesProfile: |
| | controller-0: | | | controller-0: |
| | individualCoreCStates: | | | individualCoreCStates: |
| | "0": | | | "0": |
| | C1: true | | | C1: true |
| | C2: false | | | C1E: true |
| | "32": | | | C6: false |
| | C1: true | | | C6: false |
| | C2: false | | | POLL: true |
| | sharedPoolCStates: | | | "96": |
| | C1: true | | | C1: true |
| | C2: true | | | C1E: true |
| | sharedProfile: | | | C6: false |
| | controller-0: | | | POLL: true |
| | governor: powersave | | | sharedPoolCStates: |
| | max: 2000 | | | C1: true |
| | min: 800 | | | C1E: false |
| | reservedCPUs: | | | C6: true |
| | - 0 | | | POLL: true |
| | - 32 | | | sharedProfile |
| | | | | controller-0: |
| name | kubernetes-power-manager | | | governor: powersave |
| namespace | intel-power | | | max: 2000 |
| system_overrides | cstatesProfile: | | | min: 800 |
| | controller-0: | | | reservedCPUs: '[0, 96]' |
| | individualCoreCStates: | | | reservedProfile: performance |
| | '0': {C1: true, C2: true} | | | shared: true |
| | '32': {C1: true, C2: true} | | | |
| | sharedPoolCStates: {C1: true, C2: false} | | | |
| | sharedProfile: | | name | kubernetes-power-manager |
| | controller-0: | | namespace | intel-power |
| | governor: performance | | system_overrides | cstatesProfile: |
| | max: 3000 | | | controller-0: |
| | min: 800 | | | individualCoreCStates: |
| | reservedCPUs: [0, 96] | | | '0': {C1: true, C1E: true, C6: true, POLL: true} |
| | | | | '96': {C1: true, C1E: true, C6: true, POLL: true} |
| user_overrides | cstatesProfile: | | | sharedPoolCStates: {C1: true, C1E: false, C6: false, POLL: true}|
| | controller-0: | | | sharedProfile: |
| | individualCoreCStates: | | | controller-0: |
| | "0": | | | governor: performance |
| | C2: false | | | max: 3000 |
| | "32": | | | min: 800 |
| | C2: false | | | reservedCPUs: [0, 96] |
| | sharedPoolCStates: | | | reservedProfile: performance, shared: true} |
| | C2: true | | user_overrides | cstatesProfile: |
| | sharedProfile: | | | controller-0: |
| | controller-0: | | | individualCoreCStates: |
| | governor: powersave | | | "0": |
| | max: 2000 | | | C6: false |
| | | | | "96": |
+--------------------+--------------------------------------------------------------------+ | | C6: false |
| | sharedPoolCStates: |
| | C6: true |
| | sharedProfile: |
| | controller-0: |
| | governor: powersave |
| | max: 2000 |
| | |
+--------------------+---------------------------------------------------------------------+
This final configuration will be published into Kubernetes as a Shared Profile This final configuration will be published into Kubernetes as a Shared Profile
and c-state Profile when you reapply the application. and c-state Profile when you reapply the application.
@ -396,20 +412,20 @@ including c-states for performance profile:
sharedProfile: sharedProfile:
controller-0: controller-0:
governor: powersave governor: powersave
max: 2000 max: 2000
cstatesProfile: cstatesProfile:
controller-0: controller-0:
individualCoreCStates: individualCoreCStates:
"0": "0":
C2: false C6: false
"32": "96":
C2: false C6: false
sharedPoolCStates: sharedPoolCStates:
C2: true C6: true
exclusivePoolCstates: exclusivePoolCstates:
performance: performance:
C2: true C6: true
There are other features available in the Power Manager, such as Uncore There are other features available in the Power Manager, such as Uncore