3c8a66a1c9
Add a resource class representing the number of guests a compute node can host concurrently with memory encrypted at the hardware level. Initially this is required because on AMD SEV-capable hardware, the memory controller has a fixed number of slots for holding encryption keys, one per guest. Typical hardware only has 15 slots, thereby limiting the number of SEV guests which can be run concurrently to 15. nova needs to track how many slots are available and used in order to avoid attempting to exceeding that limit in the hardware. In the future support may be added for equivalent functionality from other vendors, such as Intel MKTME; however it is not yet known whether MKTME would have a similar limit. See http://specs.openstack.org/openstack/nova-specs/specs/train/approved/amd-sev-libvirt-support.html for more details, and http://eavesdrop.openstack.org/irclogs/%23openstack-nova/%23openstack-nova.2019-04-23.log.html#t2019-04-23T20:35:19 https://review.opendev.org/#/c/641994/ for the bike-shedding discussion over the name. Change-Id: I97a015d4070db947e4b96fb35021da01d61016cc blueprint: amd-sev-libvirt-support
110 lines
4.0 KiB
Python
110 lines
4.0 KiB
Python
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
# not use this file except in compliance with the License. You may obtain
|
|
# a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
"""Static symbols for resources classes used by OpenStack.
|
|
|
|
A resource class is a type of countable thing that exists in
|
|
a cloud environment, for example VCPU, DISK_GB. They are
|
|
upper case with underscores. They often include a unit in their
|
|
name.
|
|
|
|
This package provides a collection of standard resource classes
|
|
which are expected to be available in any OpenStack deployment.
|
|
|
|
There also exists a concept of custom resource classes. These
|
|
are countable types that are custom to a particular environment.
|
|
The OpenStack placement API provides a way to create these. A
|
|
custom resource class always begins with a "CUSTOM_" prefix.
|
|
"""
|
|
|
|
import re
|
|
import sys
|
|
|
|
# NOTE(cdent): We don't expect there to be thousands of resource
|
|
# classes and we don't desire to track their history in any
|
|
# particular way so we maintain them as a list of strings ordered by
|
|
# by the time they were added to the list. From that we automatically
|
|
# create symbols in the same package. Ordering is important because
|
|
# it reflects database ids that have been used for resource classes
|
|
# prior to this package existing.
|
|
|
|
|
|
# Extend this list, if required, by adding **to the end of it**.
|
|
STANDARDS = [
|
|
# Virtual CPUs
|
|
'VCPU',
|
|
# Memory Megabytes
|
|
'MEMORY_MB',
|
|
# Disk Gigabytes
|
|
'DISK_GB',
|
|
'PCI_DEVICE',
|
|
'SRIOV_NET_VF',
|
|
'NUMA_SOCKET',
|
|
'NUMA_CORE',
|
|
'NUMA_THREAD',
|
|
'NUMA_MEMORY_MB',
|
|
'IPV4_ADDRESS',
|
|
'VGPU',
|
|
'VGPU_DISPLAY_HEAD',
|
|
# Standard resource class for network bandwidth egress measured in
|
|
# kilobits per second.
|
|
'NET_BW_EGR_KILOBIT_PER_SEC',
|
|
# Standard resource class for network bandwidth ingress measured in
|
|
# kilobits per second.
|
|
'NET_BW_IGR_KILOBIT_PER_SEC',
|
|
# Resource class representing an amount of dedicated CPUs for a single
|
|
# guest. A dedicated CPU is a physical processor that has been marked
|
|
# to be used for a single guest only
|
|
'PCPU',
|
|
# Resource class representing the number of guests a compute node can
|
|
# host with memory encrypted at the hardware level. See
|
|
# http://specs.openstack.org/openstack/nova-specs/specs/train/approved/amd-sev-libvirt-support.html
|
|
'MEM_ENCRYPTION_CONTEXT',
|
|
]
|
|
|
|
# Namespace used for custom resource classes
|
|
CUSTOM_NAMESPACE = 'CUSTOM_'
|
|
|
|
|
|
def is_custom(resource_class):
|
|
return resource_class.startswith(CUSTOM_NAMESPACE)
|
|
|
|
|
|
# Set symbols that match resource class name strings.
|
|
package = sys.modules[__name__]
|
|
for resource_class in STANDARDS:
|
|
setattr(package, resource_class, resource_class)
|
|
|
|
|
|
# NOTE(efried): This method was introduced in nova in commit
|
|
# c6231539a7d39dccf3e859eda54e9336bc164c9f and copied from nova in its current
|
|
# form as of 5a4863aa152f58f6de426b3908a75c2cc1b2efca
|
|
def normalize_name(name):
|
|
"""Converts an input string to a legal* custom resource class name.
|
|
|
|
Legal custom resource class names are prefixed with CUSTOM_ and contain
|
|
only the characters A-Z, 0-9, and _ (underscore).
|
|
|
|
.. note:: Does not attempt to detect an existing ``CUSTOM_`` prefix, so
|
|
results starting with ``CUSTOM_CUSTOM_`` (etc.) are possible.
|
|
|
|
*Does not attempt to handle length restrictions.
|
|
|
|
:param name: A string to be converted.
|
|
:return: A legal* custom resource class name.
|
|
"""
|
|
if name is None:
|
|
return None
|
|
# Replace non-alphanumeric characters with underscores
|
|
norm_name = re.sub('[^0-9A-Za-z]+', '_', name)
|
|
# Bug #1762789: Do .upper after replacing non alphanumerics.
|
|
return CUSTOM_NAMESPACE + norm_name.upper()
|