starlingx/docs
Code Issues Proposed changes

Merge "Updated Pods Using isolcpus supporting K8s 1.22 and later versions (dsr8, r8)"

Browse Source
This commit is contained in:
Zuul 2023-05-12 17:45:02 +00:00 committed by Gerrit Code Review
commit 281c5645c8
2 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
doc/source/admintasks/kubernetes/isolating-cpu-cores-to-enhance-application-performance.rst
View File

@ -37,6 +37,23 @@ For example:
~(keystone_admin)]$ system host-cpu-modify -f application-isolated -c 3,4 controller-0
~(keystone_admin)]$ system host-cpu-modify -f application-isolated -c 3-5 controller-0
In |this-ver| starting with K8s 1.22, allocation of isolcpus is in an HT-aware
manner.
.. note::
This does not apply to K8s 1.21 that you would use after a platform upgrade.
If an even number of isolcpus is required, |HT| siblings will be provided as
available. If an odd number of isolcpus is required, as many |HT| siblings as
possible will be provided.
.. note::
For optimal results, if |HT| is enabled then isolcpus should be
allocated in multiples of two in order to ensure that both |SMT| siblings
are allocated to the same container.
All |SMT| siblings (hyperthreads, if enabled) on a core will have the same
assigned function. On host boot, any CPUs designated as isolated will be
specified as part of the isolcpus kernel boot argument, which will isolate them
@ -53,7 +70,7 @@ see :ref:`Kubernetes CPU Manager Policies <kubernetes-cpu-manager-policies>`.
number of isolcpus are requested it will provide as many |SMT| siblings as
are available, then allocate singletons whose sibling has already been
allocated, then allocate one sibling from a free |SMT| sibling pair. If
hyperthreading is enabled in the BIOS then containers should request isolcpus
|HT| is enabled in the BIOS then containers should request isolcpus
in pairs. If all containers on a system do this then they will never have
different containers being allocated |SMT| siblings from the same core.

3
doc/source/shared/abbrevs.txt
View File

@ -58,6 +58,7 @@
.. |GCC| replace:: :abbr:`GCC (GNU Compiler Collection)`
.. |GPU| replace:: :abbr:`GPU (Graphics Processing Unit)`
.. |HA| replace:: :abbr:`HA (High Availability)`
.. |HT| replace:: :abbr:`HT (HyperThreading)`
.. |ICA| replace:: :abbr:`ICA (Intermediate Certificate Authority)`
.. |ICAs| replace:: :abbr:`ICAs (Intermediate Certificate Authorities)`
.. |ICMP| replace:: :abbr:`ICMP (Internet Control Message Protocol)`
@ -144,7 +145,7 @@
.. |SMT| replace:: :abbr:`SMT (Simultaneous Multithreading)`
.. |SNAT| replace:: :abbr:`SNAT (Source Network Address Translation)`
.. |SNMP| replace:: :abbr:`SNMP (Simple Network Management Protocol)`
.. |SPO| replace:: :abbr:`SPO (Security Profile Operator)`
.. |SPO| replace:: :abbr:`SPO (Security Profiles Operator)`
.. |SRIOV| replace:: :abbr:`SR-IOV (Single Root I/O Virtualization)`
.. |SRIOVs| replace:: :abbr:`SR-IOVs (Single Root I/O Virtualizations)`
.. |SSD| replace:: :abbr:`SSD (Solid State Drive)`