nova/doc
Artom Lifshitz 0a6b57a9a2 libvirt: remove default cputune shares value
Previously, the libvirt driver defaulted to 1024 * (# of CPUs) for the
value of domain/cputune/shares in the libvirt XML. This value is then
passed directly by libvirt to the cgroups API. Cgroups v2 imposes a
maximum value of 10000 that can be passed in. This makes Nova
unable to launch instances with more than 9 CPUs on hosts that run
cgroups v2, like Ubuntu Jammy or RHEL 9.

Fix this by just removing the default entirely. Because there is no
longer a guarantee that domain/cputune will contain at least a shares
element, we can stop always generating the former, and only generate
it if it will actually contain something.

We can also make operators's lives easier by leveraging the fact that
we update the XML during live migration, so this patch also adds a
method to remove the shares value from the live migration XML if one
was not set as the quota:cpu_shares flavor extra spec.

For operators that *have* set this extra spec to something greater
than 10000, their flavors will have to get updates, and their
instances resized.

Partial-bug: 1978489
Change-Id: I49d757f5f261b3562ada27e6cf57284f615ca395
(cherry picked from commit f77a9fee5b)
2023-11-21 13:47:40 +00:00
..
api_samples api: Introduce microversion 2.89 adjusting os-volume_attachments 2021-08-24 12:07:41 +01:00
api_schemas Fix bond_mode enum 802.1ad -> 802.3ad 2021-04-29 17:42:59 +02:00
ext Add autopep8 to tox and pre-commit 2021-11-08 12:37:27 +00:00
notification_samples object/notification for Adds Pick guest CPU architecture based on host 2022-02-24 12:06:55 -05:00
source libvirt: remove default cputune shares value 2023-11-21 13:47:40 +00:00
test docs: Add new architecture guide 2021-10-19 12:51:39 +01:00
README.rst Update api-ref location 2019-07-22 19:17:28 +02:00
requirements.txt tox: Enable parallel docs build 2021-01-27 16:46:21 +00:00

README.rst

OpenStack Nova Documentation README

Both contributor developer documentation and REST API documentation are sourced here.

Contributor developer docs are built to: https://docs.openstack.org/nova/latest/

API guide docs are built to: https://docs.openstack.org/api-guide/compute/

For more details, see the "Building the Documentation" section of doc/source/contributor/development-environment.rst.