第 9 章 nova


下面的章节包含有关 nova 服务中的配置选项的信息。

9.1. nova.conf

本节包含 /etc/nova/nova.conf 文件的选项。

9.1.1. DEFAULT

下表概述了 /etc/nova/nova.conf 文件中的 [DEFAULT] 组下可用的选项。

.

配置选项 = 默认值类型Description

allow_resize_to_same_host = False

布尔值

允许目标机器与源进行调整大小。在单主机环境中测试时很有用。默认情况下,不允许调整到同一主机的大小。将此选项设置为 true 会将同一主机添加到目标选项中。如果允许 ServerGroupAffinityFilter 并需要调整大小,则也设置为 true。要使此选项更改生效,需要重启 nova-api 服务。

arq_binding_timeout = 300

整数值

加速器请求(ARQ)绑定事件消息的超时。

等待 ARQ 绑定解析事件到达的秒数。事件表示实例的每个 ARQ 都已成功绑定或绑定失败。如果没有到达,则实例上线会中止,并显示异常。

backdoor_port = None

字符串值

启用 eventlet backdoor。可接受值为 0、<port> 和 <start>:<end>,其中 0 会导致侦听一个随机的 tcp 端口号;<port> 会导致侦听指定的端口号(如果该端口正在使用),并且 <start>:<end> 会导致在指定端口号范围内侦听最小未使用的端口号。所选端口显示在服务的日志文件中。

backdoor_socket = None

字符串值

启用 eventlet backdoor,使用提供的路径作为可接收连接的 unix 套接字。这个选项与 backdoor_port 相互排斥,其中只能提供一个。如果同时提供了这两个选项,则此选项存在会覆盖该选项的使用。在路径 {pid} 中,路径将被当前进程的 PID 替换。

block_device_allocate_retries = 60

整数值

在服务器创建过程中附加卷前,检查卷是否"可用"的次数。

使用块设备映射创建服务器时,source_type空白的imagesnapshot,而 destination_typenova-compute 服务将创建卷,然后将它附加到服务器。在卷可以被连接前,它必须处于"available"状态。这个选项控制在附加前检查所创建的卷为 "available" 的次数。

如果操作超时,如果块设备映射 delete_on_termination 值为 True,则卷将被删除。

建议您在块存储服务中配置镜像缓存,以加快此操作。详情请查看 https://docs.openstack.org/cinder/latest/admin/blockstorage-image-volume-cache.html

可能的值:

  • 60 (默认)
  • 如果值为 0,则进行一次尝试。
  • 对于任何值 > 0,总尝试为(value + 1)

相关选项:

  • block_device_allocate_retries_interval - 控制检查之间的间隔

block_device_allocate_retries_interval = 3

整数值

失败时块设备分配重试之间的间隔(以秒为单位)。

这个选项允许用户指定连续重试之间的时间间隔。block_device_allocate_retries 选项指定重试的最大数量。

可能的值:

  • 0 :禁用该选项。
  • 任何正整数(以秒为单位)都启用该选项。

相关选项:

  • block_device_allocate_retries - 控制重试次数

cert = self.pem

字符串值

SSL 证书文件的路径。

相关选项:

  • key
  • ssl_only
  • [console] ssl_ciphers
  • [console] ssl_minimum_version

compute_driver = None

字符串值

定义用来控制虚拟化的驱动程序。

可能的值:

  • libvirt.LibvirtDriver
  • fake.FakeDriver
  • ironic.IronicDriver
  • vmwareapi.VMwareVCDriver
  • hyperv.HyperVDriver
  • zvm.ZVMDriver

compute_monitors = []

列出值

以逗号分隔的 monitor 列表,可用于获取计算指标。您可以对 nova.compute.monitors unset 命名空间使用 setuptools 入口点中的 alias/name。如果没有提供命名空间,则会假设 "cpu." 命名空间用于向后兼容。

注意

每个命名空间只能有一个 monitor (例如 cpu)一次可以加载。

可能的值:

  • 空列表将禁用该功能(默认)。
  • 启用 CPU 的示例

    使用 virt 驱动程序变体的带宽监控
    compute_monitors = cpu.virt_driver

config_drive_format = iso9660

字符串值

配置驱动器格式。

配置驱动器格式,其中包含在引导时附加到实例的元数据。

相关选项:

  • 当出现以下替代方案之一时,这个选项非常有意义:

    1. force_config_drive 选项设置为 true
    2. 创建实例的 REST API 调用包含配置驱动器选项的 enable 标记
    3. 用于创建实例的镜像需要配置驱动器,这由该镜像的 img_config_drive 属性定义。
  • 运行 Hyper-V hypervisor 的计算节点可以配置为将配置驱动器作为 CD 驱动器附加。要将配置驱动器作为 CD 驱动器附加,请将 [hyperv] config_drive_cdrom 选项设置为 true。

弃用自:19. 0.0

原因: 此选项最初添加为 libvirt v1.2.17 中错误的一个临时解决方案,它已在 libvirt v1.2.17 中解决。因此,这个选项不再是必需的或有用。

conn_pool_min_size = 2

整数值

连接过期策略的池大小限制

conn_pool_ttl = 1200

整数值

池中闲置连接的生存时间

console_host = <based on operating system>

字符串值

用于连接到此主机上实例的控制台代理主机。它是控制台主机的公开可见名称。

可能的值:

  • 当前主机名(默认)或代表主机名的任何字符串。

control_exchange = nova

字符串值

主题范围的默认交换。可以被 transport_url 选项中指定的交换名称覆盖。

cpu_allocation_ratio = None

浮点值

虚拟 CPU 和物理 CPU 分配比率。

此选项用于配置 VCPU 清单的分配比率,从而影响放置 API 所选择的主机。

  1. note::

    This option does not affect `PCPU` inventory, which cannot be
    overcommitted.
  2. note::

    If this option is set to something *other than* `None` or `0.0`, the
    allocation ratio will be overwritten by the value of this option, otherwise,
    the allocation ratio will not change. Once set to a non-default value, it is
    not possible to "unset" the config to get back to the default behavior. If
    you want to reset back to the initial value, explicitly specify it to the
    value of `initial_cpu_allocation_ratio`.

可能的值:

  • 任何有效的正整数或浮点值

相关选项:

  • initial_cpu_allocation_ratio

daemon = False

布尔值

作为后台进程运行。

debug = False

布尔值

如果设置为 true,则日志级别将设为 DEBUG,而不是默认的 INFO 级别。

default_access_ip_network_name = None

字符串值

用于为实例设置访问 IP 的网络名称。如果有多个 IP 可供选择,则将选择一个任意 IP。

可能的值:

  • none (默认)
  • 代表网络名称的任何字符串。

default_availability_zone = nova

字符串值

计算服务的默认可用区。

此选项决定 nova-compute 服务的默认可用性区域,如果服务不属于与可用性区域元数据聚合,则将使用它。

可能的值:

  • 代表现有可用区名称的任何字符串。

default_ephemeral_format = None

字符串值

默认格式是 ephemeral_volume 的创建时被格式化。

可能的值:

  • ext2
  • ext3
  • ext4
  • xfs
  • NTFS (仅适用于 Windows 客户机)

default_log_levels = ['amqp=WARN', 'amqplib=WARN', 'boto=WARN', 'qpid=WARN', 'sqlalchemy=WARN', 'suds=INFO', 'oslo.messaging=INFO', 'oslo_messaging=INFO', 'iso8601=WARN', 'requests.packages.urllib3.connectionpool=WARN', 'urllib3.connectionpool=WARN', 'websocket=WARN', 'requests.packages.urllib3.util.retry=WARN', 'urllib3.util.retry=WARN', 'keystonemiddleware=WARN', 'routes.middleware=WARN', 'stevedore=WARN', 'taskflow=WARN', 'keystoneauth=WARN', 'oslo.cache=INFO', 'oslo_policy=INFO', 'dogpile.core.dogpile=INFO', 'glanceclient=WARN', 'oslo.privsep.daemon=INFO']

列出值

以 logger=LEVEL 的形式列出软件包日志级别列表。如果设置了 log_config_append,则忽略这个选项。

default_schedule_zone = None

字符串值

实例的默认可用区。

此选项决定了实例的默认可用性区域,当用户在创建实例时不指定域时,将使用该选项。实例将绑定到其生命周期的可用区。

可能的值:

  • 代表现有可用区名称的任何字符串。
  • none,这意味着如果实例从一个计算节点移动到另一个计算节点,可以在其生命周期内从一个可用区移到另一个可用区。

相关选项:

  • [cinder]/cross_az_attach

disk_allocation_ratio = None

浮点值

虚拟磁盘与物理磁盘分配比率。

此选项用于配置 DISK_GB 清单的分配比率,以影响放置 API 选择的主机。

配置后,如果比率大于 1.0,将会导致超额订阅可用物理磁盘。这在使用一个没有使用整个虚拟磁盘的镜像创建实例时更高效地打包实例(如稀疏或压缩镜像)。它可以设置为 0.0 和 1.0 之间的值,以便保留磁盘百分比,以便在实例以外的使用。

  1. note::

    If the value is set to `>1`, we recommend keeping track of the free disk
    space, as the value approaching `0` may result in the incorrect
    functioning of instances using it at the moment.
  2. note::

    If this option is set to something *other than* `None` or `0.0`, the
    allocation ratio will be overwritten by the value of this option, otherwise,
    the allocation ratio will not change. Once set to a non-default value, it is
    not possible to "unset" the config to get back to the default behavior. If
    you want to reset back to the initial value, explicitly specify it to the
    value of `initial_disk_allocation_ratio`.

可能的值:

  • 任何有效的正整数或浮点值

相关选项:

  • initial_disk_allocation_ratio

enable_new_services = True

布尔值

在此主机上自动启用新的 nova-compute 服务。

当一个新的 nova-compute 服务启动时,它将作为已启用的服务在数据库中注册。有时,注册新的计算服务处于 disabled 状态时很有用,然后在稍后启用。此选项仅为 nova-compute 服务设置此行为,它不会自动禁用 nova-conductor、nova-scheduler 或 nova-osapi_compute 等其他服务。

可能的值:

  • 正确 :在注册后,每个新的计算服务都会立即启用。
  • 错误 : Compute 服务必须通过 os-services REST API 调用或使用 nova service-enable <hostname> <binary&gt; 的 CLI 启用,否则它们未就绪。

enabled_apis = ['osapi_compute', 'metadata']

列出值

默认情况下要启用的 API 列表。

enabled_ssl_apis = []

列出值

启用 SSL 的 API 列表。

Nova 为 API 服务器提供 SSL 支持。enabled_ssl_apis 选项允许配置 SSL 支持。

executor_thread_pool_size = 64

整数值

当 executor 为 threading 或 eventle 时,executor 线程池的大小。

fatal_deprecations = False

布尔值

启用或禁用弃用的严重状态。

flat_injected = False

布尔值

这个选项决定是否在引导前将网络设置信息注入虚拟机。虽然它最初只设计为由 nova-network 使用,但 vmware virt 驱动程序也使用它来控制是否将网络信息注入虚拟机。当我们使用 config_drive 配置网络来控制是否将网络信息注入虚拟机时,libvirt virt 驱动程序也会使用它。

force_config_drive = False

布尔值

强制注入在配置驱动器中进行

当默认将此选项设置为 true 配置驱动器功能时,用户仍然可以通过 REST API 或镜像元数据属性启用配置驱动器。启动的实例不受此选项的影响。

可能的值:

  • true :无论 REST API 调用中的用户输入如何,强制使用配置驱动器。
  • false :不强制使用配置驱动器。配置驱动器仍可通过 REST API 或镜像元数据属性启用。

相关选项:

  • 使用 mkisofs_cmd 标志来设置安装 genisoimage 程序的路径。如果 genisoimage 与 nova-compute 服务位于同一个路径中,则不需要设置此标志。
  • 要使用 Hyper-V 的配置驱动器,您必须将 mkisofs_cmd 值设置为 mkisofs.exe 安装的完整路径。另外,您必须将 hyperv 配置部分中的 qemu_img_cmd 值设置为 qemu-img 命令安装的完整路径。

force_raw_images = True

布尔值

强制将后备镜像转换为原始格式。

可能的值:

  • true :备份镜像文件将转换为原始镜像格式
  • false :不会转换备份镜像文件

相关选项:

  • compute_driver :只有 libvirt 驱动程序使用这个选项。
  • [libvirt]/images_type: 如果 images_type 是 rbd,则不允许将此选项设置为 False。详情请查看 https://bugs.launchpad.net/nova/+bug/1816686 错误。

graceful_shutdown_timeout = 60

整数值

指定一个超时,之后安全关闭服务器将退出。零值表示无限等待。

heal_instance_info_cache_interval = 60

整数值

实例网络信息缓存更新之间的间隔。

各个计算节点运行任务之后的秒数,以查询 Neutron 以获取其所有实例网络信息,然后使用该信息更新 Nova db。如果此选项设置为 0,则 Nova 不会更新它。如果不更新缓存,元数据服务和 nova-api 端点将代理有关实例的网络数据。因此,不建议将此选项设置为 0。

可能的值:

  • 任何正整数(以秒为单位)。
  • 任何值 HEKETI0 将禁用同步。不建议这样做。

host = <based on operating system>

主机域值

此主机的主机名、FQDN 或 IP 地址。

用作:

  • nova-compute worker 的 oslo.messaging 队列名称
  • 我们把这个值用于发送到 neutron 的 binding_host。这意味着,如果您使用 neutron 代理,它应该具有相同的值。
  • Cinder 主机附加信息

必须在 AMQP 键内有效。

可能的值:

  • 带有主机名、FQDN 或 IP 地址的字符串。默认为此主机的主机名。

initial_cpu_allocation_ratio = 4.0

浮点值

初始虚拟 CPU 与物理 CPU 分配比率。

这仅在最初为给定 nova-compute 服务创建 computes_nodes 表记录时使用。

如需了解更多详细信息和使用场景,请参阅 https://docs.openstack.org/nova/latest/admin/configuration/schedulers.html

相关选项:

  • cpu_allocation_ratio

initial_disk_allocation_ratio = 1.0

浮点值

初始虚拟磁盘与物理磁盘分配比率。

这仅在最初为给定 nova-compute 服务创建 computes_nodes 表记录时使用。

如需了解更多详细信息和使用场景,请参阅 https://docs.openstack.org/nova/latest/admin/configuration/schedulers.html

相关选项:

  • disk_allocation_ratio

initial_ram_allocation_ratio = 1.0

浮点值

初始虚拟内存和物理 RAM 分配比率。

这仅在最初为给定 nova-compute 服务创建 computes_nodes 表记录时使用。

如需了解更多详细信息和使用场景,请参阅 https://docs.openstack.org/nova/latest/admin/configuration/schedulers.html

相关选项:

  • ram_allocation_ratio

injected_network_template = $pybasedir/nova/virt/interfaces.template

字符串值

/etc/network/interfaces 模板的路径。

/etc/network/interfaces-style 文件的路径,它将由 nova 填充,然后由 cloudinit 使用。这提供了一种在没有 DHCP 服务器的环境中配置网络连接的方法。

模板将使用 Jinja2 模板引擎渲染,并接收名为 interfaces 的顶级密钥。此键将包含一个字典列表,每个接口对应一个。

如需更多信息,请参阅 cloudinit 文档:

https://cloudinit.readthedocs.io/en/latest/topics/datasources.html

可能的值:

  • 到 Debian /etc/network/interfaces 文件的 Jinja2 格式模板的路径。即使使用非 Debian 派生的客户机也是如此。

相关选项:

  • flat_inject :这必须设置为 True,以确保 nova 将网络配置信息嵌入到通过配置驱动器提供的元数据中。

instance_build_timeout = 0

整数值

实例构建可能需要的最长时间(以秒为单位)。

如果这个计时器过期,实例状态将更改为 ERROR。启用此选项将确保实例在较长时间内不会处于 BUILD 状态。

可能的值:

  • 0 :禁用该选项(默认)
  • 任何正整数(以秒为单位):启用该选项。

instance_delete_interval = 300

整数值

重试失败的实例文件删除的时间间隔。

此选项取决于 maximum_instance_delete_attempts。此选项指定重试删除的频率,而 maximum_instance_delete_attempts 指定可以进行的重试尝试的最大数量。

可能的值:

  • 0 :将以默认的定期间隔运行。
  • 任何值 < 0:禁用该选项。
  • 任何正整数(以秒为单位)。

相关选项:

  • maximum_instance_delete_attempts 来自 instance_cleaning_opts 组。

`instance_format = [instance: %(uuid)s] `

字符串值

通过日志消息传递的实例格式。

instance_name_template = instance-%08x

字符串值

用于生成实例名称的模板字符串。

此模板控制实例的创建数据库名称。这不是 您在创建实例时输入的显示名称(通过 Horizon 或 CLI)。对于新部署,建议将默认值(使用数据库自动递增)更改为另一个值,以利用实例的属性,如 instance-%(uuid) s。如果您在更改时已在部署中已有实例,您的部署将中断。

可能的值:

  • 使用实例数据库 ID 的字符串(如默认值)
  • 包含指定数据库列的列表的字符串,如 %(id) d%(uuid) s%(hostname) s

instance_usage_audit = False

布尔值

此选项启用定期 compute.instance.exists 通知。每个计算节点必须配置为生成系统使用量数据。这些通知由 OpenStack Telemetry 服务使用。

instance_usage_audit_period = month

字符串值

生成实例使用的时间周期。通过附加 @ 字符后跟数字定义偏移,可以定义指定周期的可选偏移量。

可能的值:

  • 周期,例如: 小时月份
  • 带有偏移的句点,例如: month@15 将会导致每月审计从每月 15 天开始。

`instance_uuid_format = [instance: %(uuid)s] `

字符串值

通过日志消息传递的实例 UUID 格式。

instances_path = $state_path/instances

字符串值

指定实例存储在虚拟机监控程序磁盘上的位置。它可以指向本地连接的存储或 NFS 上的目录。

可能的值:

  • $state_path/instances,其中 state_path 是一个配置选项,用于指定维护 nova 状态的顶级目录。(默认)或代表目录路径的任何字符串。

相关选项:

  • [workarounds]/ensure_libvirt_rbd_instance_dir_cleanup

internal_service_availability_zone = internal

字符串值

内部服务的可用区。

此选项决定了各种内部 nova 服务的可用性区域,如 nova-schedulernova-conductor 等。

可能的值:

  • 代表现有可用区名称的任何字符串。

key = None

字符串值

SSL 密钥文件(如果与证书分开)。

相关选项:

  • cert

live_migration_retry_count = 30

整数值

live_migration 中最多 1 秒重试次数。它指定在 iptables 投诉时的重试次数。当用户持续将实时迁移请求发送到同一主机时,会发生这种情况,从而将并发请求发送到 iptables。

可能的值:

  • 任何代表重试数的正整数。

log-config-append = None

字符串值

日志配置文件的名称。此文件附加到任何现有日志记录配置文件中。有关日志记录配置文件的详情,请查看 Python 日志记录模块文档。请注意,当使用日志记录配置文件时,会在配置文件中设置所有日志记录配置,并忽略其他日志记录配置选项(例如 log-date-format)。

log-date-format = %Y-%m-%d %H:%M:%S

字符串值

在日志记录中定义 %%(asctime) s 的格式字符串。默认: %(default) s。如果设置了 log_config_append,则忽略这个选项。

log-dir = None

字符串值

(可选)用于相对 log_file 路径的基础目录。如果设置了 log_config_append,则忽略这个选项。

log-file = None

字符串值

(可选)要将日志输出发送到的日志文件名称。如果没有设置默认值,日志记录将进入由 use_stderr 定义的 stderr。如果设置了 log_config_append,则忽略这个选项。

log_options = True

布尔值

启动服务( DEBUG 级别)时,启用或禁用所有注册选项的日志记录值。

log_rotate_interval = 1

整数值

轮转日志文件前的时间长度。除非 log_rotation_type 设为 "interval",否则此选项会被忽略。

log_rotate_interval_type = days

字符串值

轮转间隔类型。调度下一个轮转时使用上次文件更改(或服务启动时的时间)。

log_rotation_type = none

字符串值

日志轮转类型。

logging_context_format_string = %(asctime) s.%(msecs) 03d %(process) d %(levelname) s %(name) s [%(global_request_id) s %(request_id) s %(user_identity) s] %(instance) s%(message) s

字符串值

用于带有上下文的日志消息的格式字符串。由 oslo_log.formatters.ContextFormatter 使用

logging_debug_format_suffix = %(funcName)s %(pathname)s:%(lineno)d

字符串值

当消息的日志记录级别为 DEBUG 时,要附加到日志消息的额外数据。由 oslo_log.formatters.ContextFormatter 使用

logging_default_format_string = %(asctime) s.%(msecs) 03d %(process) d %(levelname) s %(name) s [-] %(instance) s%(message) s

字符串值

上下文未定义时用于日志消息的格式字符串。由 oslo_log.formatters.ContextFormatter 使用

logging_exception_prefix = %(asctime)s.%(msecs)03d %(process)d ERROR %(name)s %(instance)s

字符串值

使用这种格式为每行例外输出加上前缀。由 oslo_log.formatters.ContextFormatter 使用

logging_user_identity_format = %(user) s %(project) s %(system_scope) s %(user_domain) s %(project_domain) s

字符串值

定义 logging_context_format_string 中使用的 %(user_identity) s 格式字符串。由 oslo_log.formatters.ContextFormatter 使用

long_rpc_timeout = 1800

整数值

这个选项允许为可能需要很长时间的 RPC 调用设置备用超时值。如果设置,则对其他服务的 RPC 调用将使用这个值作为超时(以秒为单位),而不是全局 rpc_response_timeout 值。

使用这个值的 RPC 调用的操作:

  • 实时迁移
  • scheduling
  • 启用/禁用计算服务
  • 镜像预缓存
  • 基于快照的/跨单元调整大小
  • 调整大小/冷迁移
  • 卷附加

相关选项:

  • rpc_response_timeout

max_concurrent_builds = 10

整数值

限制 nova-compute 同时运行的最大实例构建数量。如果要求这样做,计算服务可以尝试构建无限数量的实例。强制实施这个限制,以避免在计算节点上同时构建无限实例。这个值可以为每个计算节点设置。

可能的值:

  • 0 :被视为无限。
  • 代表最大并发构建的任何正整数。

max_concurrent_live_migrations = 1

整数值

并发运行的最大实时迁移数量。这个限制会被强制,以避免出现出站实时迁移,导致主机/网络造成失败。不建议您修改,除非您非常确定这样做是安全稳定的。

可能的值:

  • 0 :被视为无限。
  • 任何正整数,代表并发运行的最大实时迁移数。

max_concurrent_snapshots = 5

整数值

并发运行的最大实例快照操作数。这个限制会被强制以防止快照导致主机/网络/存储造成失败。这个值可以为每个计算节点设置。

可能的值:

  • 0 :被视为无限。
  • 代表最大并发快照的任何正整数。

max_local_block_devices = 3

整数值

在虚拟机监控程序节点上创建会导致本地镜像的最大设备数。

负数表示无限。将 max_local_block_devices 设置为 0 表示任何尝试创建本地磁盘的请求都会失败。这个选项旨在限制创建服务器时使用的 imageRef 以及任何其他临时磁盘和交换内存时所使用的本地磁盘的数量(因此,根本地磁盘是结果)。0 并不意味着镜像将自动从卷转换为卷和引导实例 - 它只是意味着尝试创建本地磁盘的所有请求都将失败。

可能的值:

  • 0 :不允许创建本地磁盘。
  • 负数:允许无限数量的本地磁盘。
  • 正数 :只允许这些数量的本地磁盘。

max_logfile_count = 30

整数值

轮转日志文件的最大数量。

max_logfile_size_mb = 200

整数值

日志文件的最大大小(以 MB 为单位)。如果 "log_rotation_type" 没有设置为 "size",则忽略这个选项。

maximum_instance_delete_attempts = 5

整数值

尝试获取实例文件的次数。

此选项指定可以进行的重试尝试的最大数量。

可能的值:

  • 任何正整数都定义了尝试次数。

相关选项:

  • [DEFAULT] instance_delete_interval 可用于禁用这个选项。

metadata_listen = 0.0.0.0

字符串值

元数据 API 将侦听的 IP 地址。

元数据 API 服务侦听此 IP 地址以获取传入请求。

metadata_listen_port = 8775

端口值

元数据 API 将侦听的端口。

元数据 API 服务侦听此端口号以获取传入请求。

metadata_workers = <based on operating system>

整数值

元数据服务的 worker 数量。如果没有指定可用 CPU 的数量,则将使用。

元数据服务可以配置为作为多进程(workers)运行。这解决了 API 请求并发增加时吞吐量减少的问题。元数据服务将在指定数量的进程中运行。

可能的值:

  • 任何正整数
  • none (默认值)

migrate_max_retries = -1

整数值

失败前重试实时迁移的次数。

可能的值:

  • 如果 == -1,请尝试直到主机外(默认)
  • 如果 == 0,只尝试一次,则不会重试
  • 大于 0 的整数

mkisofs_cmd = genisoimage

字符串值

用于 ISO 镜像创建的工具名称或路径。

使用 mkisofs_cmd 标志来设置安装 genisoimage 程序的路径。如果 genisoimage 位于系统路径中,则不需要更改默认值。

要使用 Hyper-V 的配置驱动器,您必须将 mkisofs_cmd 值设置为 mkisofs.exe 安装的完整路径。另外,您必须将 hyperv 配置部分中的 qemu_img_cmd 值设置为 qemu-img 命令安装的完整路径。

可能的值:

  • ISO 镜像创建器程序的名称,如果它与 nova-compute 服务位于同一个目录中
  • ISO 镜像创建程序的路径

相关选项:

  • 启用配置驱动器时这个选项非常有意义。
  • 要将配置驱动器与 Hyper-V 搭配使用,您必须将 hyperv 配置部分中的 qemu_img_cmd 值设置为 qemu-img 命令安装的完整路径。

my_block_storage_ip = $my_ip

字符串值

用于连接到块存储网络的 IP 地址。

可能的值:

  • 具有有效 IP 地址的字符串。默认为此主机的 IP 地址。

相关选项:

  • my_ip - 如果没有设置 my_block_storage_ip,则使用 my_ip 值。

my_ip = <based on operating system>

字符串值

主机用于连接管理网络的 IP 地址。

可能的值:

  • 具有有效 IP 地址的字符串。默认为此主机的 IPv4 地址。

相关选项:

  • my_block_storage_ip

network_allocate_retries = 0

整数值

重试网络分配的次数。如果虚拟接口插件失败,需要尝试网络分配重试。

可能的值:

  • 任何代表重试数的正整数。

non_inheritable_image_properties = ['cache_in_nova', 'bittorrent']

列出值

在拍摄快照时不应从实例继承的镜像属性。

这个选项为您提供了选择新创建快照不应继承哪些 image-properties 的机会。

  1. note::

    The following image properties are *never* inherited regardless of
    whether they are listed in this configuration option or not:
    • cinder_encryption_key_id
    • cinder_encryption_key_deletion_policy
    • img_signature
    • img_signature_hash_method
    • img_signature_key_type
    • img_signature_certificate_uuid

可能的值:

  • 以逗号分隔的列表,其项是 image 属性。通常只能包含仅由基础镜像所需的镜像属性,因为从基础镜像创建的快照不需要它们。
  • 默认列表: cache_in_nova, bittorrent

osapi_compute_listen = 0.0.0.0

字符串值

OpenStack API 将侦听的 IP 地址。

OpenStack API 服务侦听此 IP 地址以获取传入请求。

osapi_compute_listen_port = 8774

端口值

OpenStack API 将侦听的端口。

OpenStack API 服务侦听传入请求的此端口号。

`osapi_compute_unique_server_name_scope = `

字符串值

设置检查唯一实例名称的范围。

默认不会检查唯一名称。如果设置了名称检查的范围,则启动新实例或带有重复名称的现有实例的更新会导致 'InstanceExists' 错误。唯一性是不区分大小写的。设置此选项可以提高最终用户的可用性,因为它们不必区分名称相同的实例。

osapi_compute_workers = None

整数值

OpenStack API 服务的 worker 数量。默认值为可用的 CPU 数量。

OpenStack API 服务可以配置为作为多进程(workers)运行。这解决了 API 请求并发增加时吞吐量减少的问题。OpenStack API 服务将在指定数量的进程中运行。

可能的值:

  • 任何正整数
  • none (默认值)

password_length = 12

整数值

生成的实例管理员密码的长度。

periodic_enable = True

布尔值

启用定期任务。

如果设置为 true,这个选项允许服务定期在管理器上运行任务。

如果运行多个调度程序或编排器,您可能需要只在一个主机上运行定期任务 - 在这种情况下,为所有主机禁用这个选项,但其中一个。

periodic_fuzzy_delay = 60

整数值

启动定期任务调度程序时随机延迟的秒数,以减少时间戳。

当计算 worker 在集群中 unison 重启时,它们最终最终会同时运行定期任务,从而导致外部服务出现问题。要缓解此行为,periodic_fuzzy_delay 选项允许您在启动定期任务调度程序时引入随机初始延迟。

可能的值:

  • 任何正整数(以秒为单位)
  • 0 :禁用随机延迟

pointer_model = usbtablet

字符串值

用于指定指针类型的通用属性。

输入设备允许与图形帧缓冲的交互。例如,为绝对光标移动提供图形表。

如果设置,则 hw_input_bushw_pointer_model 镜像元数据属性优先于这个配置选项。

相关选项:

  • usbtablet 必须在启用 VNC 的情况下配置,也可以启用 SPICE 代理并禁用 SPICE 代理。与 libvirt 一起使用时,实例模式应配置为 HVM。

preallocate_images = none

字符串值

要使用的镜像预分配模式。

镜像预分配允许在实例初始置备时预先分配实例镜像的存储。这样可确保如果没有足够的空间,则立即提供反馈。另外,它应该显著提高新块写入的性能,甚至可能会提高 I/O 性能,因为碎片减少。

publish_errors = False

布尔值

启用或禁用错误事件的发布。

pybasedir = /usr/lib/python3.9/site-packages

字符串值

安装了 Nova python 模块的目录。

此目录用于存储网络和远程控制台访问的模板文件。它还是其他需要保留 Nova 内部数据的其他配置选项的默认路径。不太可能您需要更改这个选项的默认值。

可能的值:

  • 到目录的完整路径。

相关选项:

  • state_path

ram_allocation_ratio = None

浮点值

虚拟 RAM 与物理 RAM 分配比率。

此选项用于配置 MEMORY_MB 清单的分配比率,以影响放置 API 选择的主机。

  1. note::

    If this option is set to something *other than* `None` or `0.0`, the
    allocation ratio will be overwritten by the value of this option, otherwise,
    the allocation ratio will not change. Once set to a non-default value, it is
    not possible to "unset" the config to get back to the default behavior. If
    you want to reset back to the initial value, explicitly specify it to the
    value of `initial_ram_allocation_ratio`.

可能的值:

  • 任何有效的正整数或浮点值

相关选项:

  • initial_ram_allocation_ratio

rate_limit_burst = 0

整数值

每个 rate_limit_interval 的最大日志信息数。

rate_limit_except_level = CRITICAL

字符串值

通过速率限制使用的日志级别名称:CRITICAL、ERROR、INFO、WARNING、DEBUG 或空字符串。不过滤级别大于或等于 rate_limit_except_level 的日志。空字符串表示过滤所有级别。

rate_limit_interval = 0

整数值

日志速率限制的时间间隔、秒数。

reboot_timeout = 0

整数值

硬重启实例的时间间隔。

当进行软重启时,客户机内核可能会完全挂起,从而导致软重启任务无法完成。如果将这个选项设置为一个时间段(以秒为单位),如果它一直处于重新引导状态超过 N 秒,则会自动重启实例。

可能的值:

  • 0 :禁用该选项(默认)。
  • 任何正整数(以秒为单位):启用该选项。

reclaim_instance_interval = 0

整数值

重新声明已删除实例的间隔。

大于 0 的值将启用 SOFT_DELETE 实例。这个选项决定是否要删除的服务器是否会被置于 SOFT_DELETED 状态。如果这个值大于 0,则删除的服务器不会立即删除,而是会被放入队列,直到它太旧(删除的时间大于 reclaim_instance_interval 的值)。可以使用 restore 操作从删除队列恢复服务器。如果删除的服务器保持超过 reclaim_instance_interval 的值,它将由计算服务中的定期任务自动删除。

请注意,此选项从 API 和计算节点读取,并且必须全局设置,否则服务器可以在 API 中放入软删除状态,并且实际上永远不会在计算节点上回收(删除)。

  1. 注:当使用此选项时,您还应配置 [cinder] auth 选项,如 auth_typeauth_url用户名 等等。由于重新声明发生在定期任务中,因此没有用户令牌来清理附加到任何 SOFT_DELETED 服务器的卷,因此 nova 必须通过管理员角色访问权限来清理 Cinder 中的这些资源。

可能的值:

  • 任何大于 0 的正整数(以秒为单位)将启用这个选项。
  • 任何值 HEKETI0 将禁用该选项。

相关选项:

  • [Cinder] 身份验证选项,用于在重新声明过程中清理附加到服务器的卷

record = None

字符串值

用于存储此主机上运行的代理服务(如 VNC、spice、serial)接收和发送的 websocket 帧的文件名。如果没有设置,则不会进行任何记录。

reimage_timeout_per_gb = 20

整数值

重新建立卷的超时。

等待 volume-reimaged 事件在继续或失败前等待的秒数。

这是一个每 GB 时间,默认值为 20 秒,并将乘以 GB 的映像大小。例如:镜像 6 GB 将超时为 20 * 6 = 120 秒。如果每个 GB 的镜像副本需要更长的时间且您达到超时失败,请尝试增加超时时间。

report_interval = 10

整数值

指示给定虚拟机监控程序上服务状态报告的秒数。Nova 需要知道这一点,以确定部署的整体健康状况。

相关选项:

  • service_down_time report_interval 应该小于 service_down_time。如果 service_down_time 小于 report_interval,则服务将定期考虑,因为它们很少报告。

rescue_timeout = 0

整数值

取消删除实例在 RESCUE 中卡住的间隔。

可能的值:

  • 0 :禁用该选项(默认)
  • 任何正整数(以秒为单位):启用该选项。

reserved_host_cpus = 0

整数值

为主机进程保留的主机 CPU 数量。

主机资源使用情况报告给调度程序,持续来自计算节点上运行的 nova-compute。这个值用于决定向放置报告的 保留 值。

如果定义了 [compute] cpu_shared_set[compute] cpu_dedicated_set 配置选项,则无法设置这个选项。定义这些选项时,未包含在这些值中的任何主机 CPU 都将被视为主机保留。

可能的值:

  • 任何代表要为主机保留的物理 CPU 数量的正整数。

相关选项:

  • [compute] cpu_shared_set
  • [compute] cpu_dedicated_set

reserved_host_disk_mb = 0

整数值

以 MB 为单位的磁盘资源量,使它们始终可用于主机。磁盘用量报告的信息来自计算节点上运行的 nova-compute 的调度程序。为防止磁盘资源被视为可用,可使用此选项为该主机保留磁盘空间。

可能的值:

  • 任何代表要为主机保留的磁盘的正整数。

reserved_host_memory_mb = 512

整数值

为主机保留的内存量(以 MB 为单位),以便主机进程始终可用。主机资源使用情况报告给调度程序,持续来自计算节点上运行的 nova-compute。为防止主机内存被视为可用,此选项用于为主机保留内存。

可能的值:

  • 任何代表要为主机保留的内存量的正整数。

reserved_huge_pages = None

字典值

每个 NUMA 主机单元保留的巨页数量。

可能的值:

  • 有效的 key=value 列表,它反映 NUMA 节点 ID、页大小

    (默认单位为 KiB)和要保留的页数。例如:

    reserved_huge_pages = node:0,size:2048,count:64 reserved_huge_pages = node:1,size:1GB,count:1

    In this example we are reserving on NUMA node 0 64 pages of 2MiB
    and on NUMA node 1 1 page of 1GiB.

resize_confirm_window = 0

整数值

N 秒后自动确认调整大小。

调整大小的功能将在调整大小前保存现有服务器。调整大小完成后,会请求用户来确认调整大小。用户有机会确认或恢复所有更改。确认调整大小将删除原始服务器,并将服务器状态从调整大小调整为 active。将此选项设置为时间段(以秒为单位)将在服务器处于调整大小的时间超过该时间时自动确认调整大小。

可能的值:

  • 0 :禁用该选项(默认)
  • 任何正整数(以秒为单位):启用该选项。

resize_fs_using_block_device = False

布尔值

通过块设备启用调整文件系统的大小。

如果启用,请通过通过块设备访问镜像来尝试调整文件系统的大小。这由主机完成,如果镜像包含最新版本的 cloud-init,可能不需要这样做。可能的机制需要 nbd 驱动程序(用于 qcow 和 raw)或 loop (用于 raw)。

resume_guests_state_on_host_boot = False

布尔值

此选项指定是否在主机重启前启动正在运行的客户机。它确保 Nova 计算节点上的所有实例在每次计算节点引导时都恢复其状态。

rootwrap_config = /etc/nova/rootwrap.conf

字符串值

rootwrap 配置文件的路径。

根打包程序的目标是允许特定服务的非特权用户以最安全的方式以 root 用户身份运行多个操作。此处使用的配置文件必须与 sudoers 条目中定义的配置文件匹配。

rpc_conn_pool_size = 30

整数值

RPC 连接池的大小。

rpc_ping_enabled = False

布尔值

添加端点以回答 ping 调用。端点名为 oslo_rpc_server_ping

rpc_response_timeout = 60

整数值

等待来自调用的响应的秒数。

run_external_periodic_tasks = True

布尔值

某些定期任务可以在单独的进程中运行。我们是否应该在此处运行?

running_deleted_instance_action = reap

字符串值

计算服务定期检查数据库中删除的实例,但仍然在计算节点上运行。以上选项允许在识别此类实例时采取操作。

相关选项:

  • running_deleted_instance_poll_interval
  • running_deleted_instance_timeout

running_deleted_instance_poll_interval = 1800

整数值

清理操作之间等待的时间间隔(以秒为单位)。如果设置为 0,则禁用以上检查。如果 "running_deleted_instance _action" 设置为 "log" 或 "reap",则必须设置大于 0 的值。

可能的值:

  • 任何正整数(以秒为单位)都启用该选项。
  • 0 :禁用该选项。
  • 1800: 默认值。

相关选项:

  • running_deleted_instance_action

running_deleted_instance_timeout = 0

整数值

等待在数据库中标记为已删除的实例的时间间隔(以秒为单位)有资格清理。

可能的值:

  • 任何正整数(以秒为单位为 0)。

相关选项:

  • "running_deleted_instance_action"

scheduler_instance_sync_interval = 120

整数值

发送调度程序列表之间的间隔,以验证其实例的视图是否与 nova 同步。

如果 CONF 选项 scheduler_tracks_instance_changes 为 False,则不会进行同步调用。因此,更改这个选项将无效。

如果不同步情况不常见,则可以增加此间隔,以减少要发送的 RPC 消息数量。同样,如果同步问题导致问题,可以降低间隔以更频繁地检查。

可能的值:

  • 0 :将以默认的定期间隔运行。
  • 任何值 < 0:禁用该选项。
  • 任何正整数(以秒为单位)。

相关选项:

  • 如果将 scheduler_tracks_instance_changes 设为 False,则此选项不会影响。

service_down_time = 60

整数值

自上次检查服务以来的最大时间(以秒为单位)

每个计算节点根据指定的报告间隔定期更新其数据库状态。如果计算节点没有更新 service_down_time 的状态,则计算节点被视为 down。

相关选项:

  • report_interval (service_down_time 不应小于 report_interval)

servicegroup_driver = db

字符串值

此选项指定用于 servicegroup 服务的驱动程序。

nova 中的 ServiceGroup API 启用检查计算节点的状态。当计算工作程序运行 nova-compute 守护进程启动时,它会调用 join API 来加入计算组。nova 调度程序等服务可以查询 ServiceGroup API 来检查节点是否处于活动状态。在内部,ServiceGroup 客户端驱动程序会自动更新计算 worker 状态。此服务有多个后端实现:database ServiceGroup 驱动程序和 Memcache ServiceGroup 驱动程序。

相关选项:

  • service_down_time (自上次检查服务以来的最长时间)

shelved_offload_time = 0

整数值

半情况下,需要经过的时间才能从主机移除实例。

默认情况下,此选项设置为 0,在 shelve 操作后立即从 hypervisor 中删除实例。否则,实例将保留以 shelved_offload_time (以秒为单位)的值,以便在未shelve 操作期间发生,然后定期任务将在 shelved_offload_time 通过后从 hypervisor 中删除实例。

可能的值:

  • 0: 实例将立即卸载。
  • 任何值 < 0: 实例永远不会卸载。
  • 任何正整数(以秒为单位):实例将在卸载前指定的秒数。

shelved_poll_interval = 3600

整数值

轮询 shelved 实例卸载的时间间隔。

定期任务会针对每个 shelved_poll_interval 的秒数运行,并检查是否有任何 shelved 实例。如果它找到 shelved 实例,它基于 shelved_offload_time 配置值,它会卸载 shelved 实例。检查 shelved_offload_time 配置选项描述以了解详细信息。

可能的值:

  • 任何值 swig 0:禁用该选项。
  • 任何正整数(以秒为单位)。

相关选项:

  • shelved_offload_time

shutdown_timeout = 60

整数值

实例执行干净的关闭总时间(以秒为单位)。

它决定了虚拟机允许执行干净的关闭的整体周期(以秒为单位)。在执行 stop、rescue 和 shelve 时,重建操作可让虚拟机在实例关闭前执行受控的关闭。默认超时为 60 秒。值 0 (零)表示客户机将立即关闭,而不会对客户机操作系统进行清理。

超时值可以逐个镜像覆盖,使用 os_shutdown_timeout 是一个镜像元数据设置,允许不同类型的操作系统指定完全关闭所需的时间。

可能的值:

  • 一个正整数或 0 (默认值为 60)。

source_is_ipv6 = False

布尔值

如果使用 IPv6 解决了源主机,则设置为 True。

ssl_only = False

布尔值

不允许未加密的连接。

相关选项:

  • cert
  • key

state_path = $pybasedir

字符串值

维护 Nova 状态的顶级目录。

此目录用于存储 Nova 的内部状态。它被各种从中获取的其他配置选项使用。在某些情况下(如迁移)使用在多个计算主机(例如通过 NFS)之间共享的存储位置。除非 option instances_path 被覆盖,否则此目录可能会非常大。

可能的值:

  • 到目录的完整路径。默认为 pybasedir 中提供的值。

sync_power_state_interval = 600

整数值

在数据库和虚拟机监控程序之间同步电源状态的间隔。

Nova 检查实际虚拟机电源状态和 Nova 在其数据库中具有的电源状态的时间间隔。如果用户关闭其虚拟机,Nova 将更新 API 以报告虚拟机已经关闭。如果出现虚拟机意外打开,Nova 将重新关闭虚拟机,使系统保持在预期状态。

可能的值:

  • 0 :将以默认的定期间隔运行。
  • 任何值 < 0:禁用该选项。
  • 任何正整数(以秒为单位)。

相关选项:

  • 如果 workarounds 组中的 handle_virt_lifecycle_events 为 false,并且此选项为负数,那么在虚拟机监控程序和 Nova 数据库之间不同步的实例必须手动同步。

sync_power_state_pool_size = 1000

整数值

可用于同步电源状态的 greenthreads 数量。

这个选项可用于减少对虚拟机监控程序或具有实际实例电源状态的并发请求数,例如使用 Ironic。

可能的值:

  • 任何代表绿色线程数的正整数。

syslog-log-facility = LOG_USER

字符串值

syslog 工具可接收日志行。如果设置了 log_config_append,则忽略这个选项。

tempdir = None

字符串值

明确指定临时工作目录。

timeout_nbd = 10

整数值

等待 NBD 设备启动的时间(以秒为单位)。

transport_url = rabbit://

字符串值

用于连接到消息传递后端的网络地址和可选用户凭证,采用 URL 格式。预期的格式是:

driver://[user:pass@]host:port[,[userN:passN@]hostN:portN]/virtual_host?query

示例:rabbit://rabbitmq:password@127.0.0.1:5672//

有关 URL 中字段的详情,请查看 oslo_messaging.TransportURL 文档 https://docs.openstack.org/oslo.messaging/latest/reference/transport.html

update_resources_interval = 0

整数值

更新计算资源的间隔。

这个选项指定 update_available_resource 定期任务运行的频率。小于 0 的值表示完全禁用任务。保留默认值 0 将导致这以默认的定期间隔运行。将它设置为任何正值将导致其在大约的秒数中运行。

可能的值:

  • 0 :将以默认的定期间隔运行。
  • 任何值 < 0:禁用该选项。
  • 任何正整数(以秒为单位)。

use-journal = False

布尔值

为日志记录启用 journald。如果在 systemd 环境中运行,您可能需要启用日志支持。这样做将使用日志原生协议,该协议包括日志消息外的结构化元数据。如果设置了 log_config_append,则忽略此选项。

use-json = False

布尔值

使用 JSON 格式进行日志记录。如果设置了 log_config_append,则忽略这个选项。

use-syslog = False

布尔值

使用 syslog 进行日志记录。现有 syslog 格式为 DEPRECATED,稍后将更改为遵循 RFC5424。如果设置了 log_config_append,则忽略这个选项。

use_cow_images = True

布尔值

启用使用 copy-on-write (cow)镜像。

QEMU/KVM 允许使用 qcow2 作为后备文件。通过禁用此功能,将不会使用后备文件。

use_eventlog = False

布尔值

日志输出到 Windows 事件日志。

use_rootwrap_daemon = False

布尔值

开始使用可运行需要以 root 特权运行的命令的守护进程。在运行 nova 计算进程的节点上通常启用此选项。

use_stderr = False

布尔值

将日志输出到标准错误。如果设置了 log_config_append,则忽略这个选项。

vcpu_pin_set = None

字符串值

可用于 VCPU 资源的主机 CPU 掩码。

此选项的行为取决于 [compute] cpu_dedicated_set 选项的定义,并影响 [compute] cpu_shared_set 选项的行为。

  • 如果定义了 [compute] cpu_dedicated_set,定义这个选项会导致错误。
  • 如果没有定义 [compute] cpu_dedicated_set,此选项将用于确定 VCPU 资源的清单,并限制可调度固定和未固定实例的主机 CPU,覆盖 [compute] cpu_shared_set 选项。

可能的值:

  • 可以从中分配虚拟 CPU 的物理 CPU 编号的逗号分隔列表。每个元素应该是单个 CPU 编号、CPU 编号范围或一个 caret,后跟一个要从其中排除的 CPU 号。

    之前的范围.例如:
    vcpu_pin_set = "4-12,^8,15"

相关选项:

  • [compute] cpu_dedicated_set
  • [compute] cpu_shared_set

弃用自:20.0.0

原因: 此选项已被 ''[compute] cpu_dedicated_set'' 和 ''[compute] cpu_shared_set' 选项取代,允许同一主机上固定和未固定实例等内容(用于 libvirt 驱动程序)。

vif_plugging_is_fatal = True

布尔值

确定实例是否应在 VIF 插入超时上引导或失败。

Nova 在实例调度后向 Neutron 发送端口更新,为 Neutron 提供必要的信息来完成端口设置。完成后,Neutron 会通知 Nova 已完成设置端口,此时 Nova 将恢复实例的引导,因为现在应该存在网络连接。如果在给定间隔后没有收到回复,则会出现超时。

此选项决定了 VIF 插入超时事件时 Nova 的作用。启用后,实例将出错。禁用后,实例将继续启动,假设端口已就绪。

可能的值:

  • true :实例应该在 VIF 插入超时后失败
  • false :实例应该在 VIF 插入超时后继续引导

vif_plugging_timeout = 300

整数值

Neutron VIF 插入事件消息的超时。

等待 Neutron vif 插入事件在继续或失败前等待的秒数(请参阅 vif_plugging_is_fatal)。

如果您大规模达到超时失败,请考虑通过 [agent]/root_helper_daemon neutron 配置选项在 neutron 代理中运行 rootwrap 以"daemon 模式"。

相关选项:

  • vif_plugging_is_fatal - 如果 vif_plugging_timeout 设为零,并且 vif_plugging_is_fatal 为 False,则事件不应该全部到达。

virt_mkfs = []

多值

临时设备的 mkfs 命令的名称。

格式为 <os_type>=<mkfs command>

volume_usage_poll_interval = 0

整数值

收集卷使用量的间隔。

这个选项更新每个 volume_usage_poll_interval 秒数的卷使用缓存。

可能的值:

  • 任何大于 0 的正整数(以秒为单位)将启用这个选项。
  • 任何值 HEKETI0 将禁用该选项。

watch-log-file = False

布尔值

使用旨在监视文件系统的日志记录处理程序。当移动或删除日志文件时,此处理程序将立即打开具有指定路径的新日志文件。只有在指定了 log_file 选项并使用 Linux 平台时才有意义。如果设置了 log_config_append,则忽略这个选项。

web = /usr/share/spice-html5

字符串值

带有 Web 服务器提供的内容的目录路径。

9.1.2. api

下表概述了 /etc/nova/nova.conf 文件中的 [api] 组下可用的选项。

表 9.1. api
配置选项 = 默认值类型Description

auth_strategy = keystone

字符串值

确定用于身份验证的策略。

弃用自: 21.0.0

原因: 只有非默认选择 ''noauth2'' 仅用于内部开发和测试目的,不应在部署中使用。这个选项及其中间件 NoAuthMiddleware[V2_18] 将在以后的版本中删除。

compute_link_prefix = None

字符串值

此字符串添加到常规 URL 前,该 URL 返回至 OpenStack Compute API 的链接。如果它为空(默认),则 URL 将保持不变。

可能的值:

  • 任何字符串,包括空字符串(默认)。

config_drive_skip_versions = 1.0 2007-01-19 2007-03-01 2007-08-29 2007-10-10 2007-12-15 2008-02-01 2008-09-01

字符串值

当收集配置驱动器的现有元数据时,所有没有出现在此选项中的版本都会返回 EC2 样式元数据。从 Liberty 发行版本开始,可用的版本有:

  • 1.0
  • 2007-01-19
  • 2007-03-01
  • 2007-08-29
  • 2007-10-10
  • 2007-12-15
  • 2008-02-01
  • 2008-09-01
  • 2009-04-04

选项采用单个字符串的格式,每个版本由空格分隔。

可能的值:

  • 代表零或更多版本的字符串,用空格分隔。

dhcp_domain = novalocal

字符串值

用于为实例配置 FQDN 的域名。

为实例主机名配置完全限定域名。该值后缀到数据库中的实例主机名,以构造元数据 API 中显示的主机名。要禁用此行为(例如,正确地支持微版本 2.94 FQDN 主机名),请将其设置为空字符串。

可能的值:

  • 任何是有效域名的字符串。

enable_instance_password = True

布尔值

启用通过相关服务器 API 调用返回实例密码,如 create, rebuild, evacuate, 或 rescue。如果虚拟机监控程序不支持密码注入,则返回的密码将不正确,因此,如果您的虚拟机监控程序不支持密码注入,则将其设置为 False。

glance_link_prefix = None

字符串值

此字符串添加到常规 URL 的前面,该 URL 返回链接到 Glance 资源。如果它为空(默认),则 URL 将保持不变。

可能的值:

  • 任何字符串,包括空字符串(默认)。

instance_list_cells_batch_fixed_size = 100

整数值

如果 instance_list_cells_batch_strategy' 设置为 fixed,这控制从每个单元数据库请求的实例批处理大小。无论系统中的单元格或任何其他因素是什么,这个集成值都会定义每次请求实例批处理时发出的限制。根据 instance_list_cells_batch_strategy 文档中的名为 out 的一般逻辑,每个批处理的最小值为 100 记录。

相关选项:

  • instance_list_cells_batch_strategy
  • max_limit

instance_list_cells_batch_strategy = distributed

字符串值

这控制 API 在大型实例列表操作期间在较小的批处理中查询单元数据库的方法。如果执行批处理,则大型实例列表操作将首先从每个单元数据库请求部分整体 API 限制,并且会根据需要从每个单元格中重新请求与记录相同的批处理大小(重新返回)。较大的批处理意味着 API 和数据库之间较少的 chattiness,但可能更多的努力处理不会返回给用户的结果。任何策略都会生成至少 100 个记录的批处理大小,以避免用户在请求中造成大量小数据库查询。

相关选项:

  • instance_list_cells_batch_fixed_size
  • max_limit

instance_list_per_project_cells = False

布尔值

启用后,这将导致 API 仅查询租户已映射实例的单元数据库。这在每个列表前需要额外在 API 数据库中查询(快速),但(可能)限制必须查询的单元数据库数量以提供结果。如果您有少量单元,或者租户可能在所有单元中包含实例,则这应该是 False。如果您有很多单元,尤其是当您将租户限制为这些单元的一个子集时,这应该是 True。

list_records_by_skipping_down_cells = True

布尔值

当设置为 False 时,如果基础架构失败(如不响应的单元格),则会导致 API 返回 500 错误。如果您希望 API 跳过下单元,并从 up cells 返回结果,将此选项设置为 True。

请注意,从 API 微版本 2.69 中,部署中可能存在没有特定记录的临时条件,对于包含这些记录的某些请求,结果可能是部分。在这些情况下,将忽略这个选项。如需更多信息,请参阅 Compute API 指南中的"处理关闭 Cells"部分 (https://docs.openstack.org/api-guide/compute/down_cells.html)。

local_metadata_per_cell = False

布尔值

表示 nova-metadata API 服务已按原样部署,以便在多cell 部署中拥有更好的性能和数据隔离。根据 neutron 的设置方式,用户应考虑使用此配置。如果您有网络范围单元,您可能需要全局运行 nova-metadata API 服务。如果您的网络分段在单元格内,您可以按单元运行 nova-metadata API 服务。当每个单元运行 nova-metadata API 服务时,您还应配置每个 Neutron metadata-agent 以指向对应的 nova-metadata API 服务。

max_limit = 1000

整数值

因为查询可能会返回许多数千个项目,您可以通过设置这个选项来限制单个响应中的最大项目数量。

metadata_cache_expiration = 15

整数值

这个选项是缓存元数据的时间(以秒为单位)。当设置为 0 时,元数据缓存完全禁用;这通常不建议用于性能。增加此设置应该在负载过重时提高元数据 API 的响应时间。数值越高,可以增加内存用量,并导致主机元数据更改的更长时间生效。

neutron_default_tenant_id = default

字符串值

用于从 Neutron API 获取默认网络的租户 ID (也称为 项目 ID)供使用。

相关选项:

  • use_neutron_default_nets

use_forwarded_for = False

布尔值

为 True 时,X-Forwarded-For 标头将被视为规范远程地址。False (默认值)时,会使用 remote_address 标头。

只有在有 HTML 清理代理时,才应启用此设置。

弃用自: 26.0.0

*reason:* this feature are duplicate of the HTTPProxyToWSGI Middleware in oslo.middleware

use_neutron_default_nets = False

布尔值

为 True 时,TenantNetworkController 将查询 Neutron API 以获取要使用的默认网络。

相关选项:

  • neutron_default_tenant_id

vendordata_dynamic_connect_timeout = 5

整数值

外部 REST 服务连接的最大等待时间。

可能的值:

  • 任何值大于 3 的整数 (TCP 数据包重新传输超时)。请注意,实例启动可能会在等待时间内被阻止,因此这个值应该会保持小。

相关选项:

  • vendordata_providers
  • vendordata_dynamic_targets
  • vendordata_dynamic_ssl_certfile
  • vendordata_dynamic_read_timeout
  • vendordata_dynamic_failure_fatal

vendordata_dynamic_failure_fatal = False

布尔值

获取动态厂商数据失败对于实例启动而言是致命的?

相关选项:

  • vendordata_providers
  • vendordata_dynamic_targets
  • vendordata_dynamic_ssl_certfile
  • vendordata_dynamic_connect_timeout
  • vendordata_dynamic_read_timeout

vendordata_dynamic_read_timeout = 5

整数值

外部 REST 服务连接后返回数据的等待时间上限。

可能的值:

  • 任何整数。请注意,实例启动在此等待期间被阻止,因此该值应保持小。

相关选项:

  • vendordata_providers
  • vendordata_dynamic_targets
  • vendordata_dynamic_ssl_certfile
  • vendordata_dynamic_connect_timeout
  • vendordata_dynamic_failure_fatal

`vendordata_dynamic_ssl_certfile = `

字符串值

可选证书文件或 CA 捆绑包的路径,以验证动态 vendordata REST 服务 ssl 证书。

可能的值:

  • 空字符串或有效证书文件的路径

相关选项:

  • vendordata_providers
  • vendordata_dynamic_targets
  • vendordata_dynamic_connect_timeout
  • vendordata_dynamic_read_timeout
  • vendordata_dynamic_failure_fatal

vendordata_dynamic_targets = []

列出值

动态 vendordata 提供程序的目标列表。这些目标格式为 < name>@<url>

动态 vendordata 供应商通过联系外部 REST 服务并查询它们以获取有关实例的信息来收集元数据。此行为记录在 nova 开发人员参考中的 vendordata.rst 文件中。

vendordata_jsonfile_path = None

字符串值

云供应商可以将自定义数据存储在厂商数据文件中,随后可通过元数据服务提供给实例,以及配置驱动器的渲染。此 JsonFileVendorData 的默认类从 JSON 文件加载此信息,该文件路径由此选项配置。如果没有这个选项设置的路径,则类会返回一个空的字典。

请注意,当使用此选项为配置驱动器提供静态厂商数据时,必须使用此选项配置 nova-compute 服务,且该文件必须可从 nova-compute 主机访问。

可能的值:

  • 代表数据文件的路径或空字符串(默认)的字符串。

vendordata_providers = ['StaticJSON']

列出值

vendordata 供应商列表。

vendordata 供应商如何通过特定于其部署的 configdrive 和 metadata 提供元数据。

有关实施 vendordata 动态端点的要求的更多信息,请参阅 nova 开发人员参考中的 vendordata.rst 文件。

相关选项:

  • vendordata_dynamic_targets
  • vendordata_dynamic_ssl_certfile
  • vendordata_dynamic_connect_timeout
  • vendordata_dynamic_read_timeout
  • vendordata_dynamic_failure_fatal

9.1.3. api_database

下表概述了 /etc/nova/nova.conf 文件中的 [api_database] 组下可用的选项。

表 9.2. api_database
配置选项 = 默认值类型Description

backend = sqlalchemy

字符串值

用于数据库的后端。

connection = None

字符串值

用于连接到数据库的 SQLAlchemy 连接字符串。

connection_debug = 0

整数值

SQL 调试信息的详细程度:0=None, 100=Everything。

`connection_parameters = `

字符串值

在连接时附加到连接 URL 上的可选 URL 参数 ; 指定为 param1=value1&param2=value2&…​

connection_recycle_time = 3600

整数值

连接池中存在的连接的时间超过这个秒数,将在下次从池中签出时被替换为新的秒数。

connection_trace = False

布尔值

将 Python 堆栈跟踪作为注释字符串添加到 SQL 中。

db_inc_retry_interval = True

布尔值

如果为 True,将数据库操作重试间隔增加到 db_max_retry_interval。

db_max_retries = 20

整数值

在引发错误前,连接错误或死锁错误时的最大重试次数。设置为 -1 以指定无限重试计数。

db_max_retry_interval = 10

整数值

如果设置了 db_inc_retry_interval,则数据库操作重试之间的最大秒数。

db_retry_interval = 1

整数值

数据库事务重试之间的秒数。

max_overflow = 50

整数值

如果设置,请对带有 SQLAlchemy 的 max_overflow 使用这个值。

max_pool_size = 5

整数值

池中保持打开的最大 SQL 连接数。设置 0 表示没有限制。

max_retries = 10

整数值

在启动过程中重试数据库连接的最大数量。设置为 -1 以指定无限重试计数。

mysql_enable_ndb = False

布尔值

如果为 True,则透明地启用对处理 MySQL 集群(NDB)的支持。弃用自: 12.1.0

适用于 MySQL NDB 集群存储引擎的reason:*Support 已弃用,并将在以后的版本中删除。

mysql_sql_mode = TRADITIONAL

字符串值

用于 MySQL 会话的 SQL 模式。此选项包括默认设置,可覆盖任何 server-set SQL 模式。要使用服务器配置设置的任何 SQL 模式,请将其设置为 no 值。示例:mysql_sql_mode=

mysql_wsrep_sync_wait = None

整数值

对于 Galera,对新连接配置 wsrep_sync_wait 导致性检查。默认为 None,表示不配置任何设置。

pool_timeout = None

整数值

如果设置,请对带有 SQLAlchemy 的 pool_timeout 使用这个值。

retry_interval = 10

整数值

打开 SQL 连接之间的间隔。

slave_connection = None

字符串值

用于连接到从属数据库的 SQLAlchemy 连接字符串。

sqlite_synchronous = True

布尔值

如果为 True,则 SQLite 使用同步模式。

9.1.4. barbican

下表概述了 /etc/nova/nova.conf 文件中的 [barbican] 组下可用的选项。

表 9.3. barbican
配置选项 = 默认值类型Description

auth_endpoint = http://localhost/identity/v3

字符串值

使用此端点连接到 Keystone

barbican_api_version = None

字符串值

Barbican API 的版本,例如:"v1"

barbican_endpoint = None

字符串值

使用此端点连接到 Barbican,例如:"http://localhost:9311/"

barbican_endpoint_type = public

字符串值

指定端点的类型。允许的值有:public、private 和 admin

barbican_region_name = None

字符串值

指定所选端点的区域。

number_of_retries = 60

整数值

重试轮询创建密钥完成的次数

retry_delay = 1

整数值

重试轮询创建密钥完成前等待的秒数

send_service_user_token = False

布尔值

为 True 时,如果向 REST API 发送用户令牌,也会发送服务令牌。

Nova 通常重复使用提供给 nova-api 的用户令牌,以与其他 REST API 通信,如 Cinder、Glance 和 Neutron。当用户令牌在向 Nova 发出请求时有效时,令牌可能会在到达其他服务之前过期。为避免出现任何故障,并且使其清除为 Nova 代表用户调用服务,我们会包括服务令牌以及用户令牌。如果用户的令牌已过期,则有效的服务令牌可确保 keystone 中间件仍接受 REST API 请求。

verify_ssl = True

布尔值

指定是否不安全的 TLS (https)请求。如果为 False,则不会验证服务器证书(如果 True),我们可以同时设置 verify_ssl_path 配置。

verify_ssl_path = None

字符串值

要针对的捆绑包或 CA 证书检查的路径,或 None 用于尝试查找并使用 verify_ssh 为 True 的证书。如果 verify_ssl 是 False,这会被忽略。

9.1.5. barbican_service_user

下表概述了 /etc/nova/nova.conf 文件中的 [barbican_service_user] 组下可用的选项。

表 9.4. barbican_service_user
配置选项 = 默认值类型Description

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

split-loggers = False

布尔值

记录对多个日志记录器的请求。

timeout = None

整数值

http 请求的超时值

9.1.6. 缓存

下表概述了 /etc/nova/nova.conf 文件中的 [cache] 组下可用的选项。

表 9.5. 缓存
配置选项 = 默认值类型Description

backend = dogpile.cache.null

字符串值

缓存后端模块.对于基于事件线程服务器的或环境,建议使用带有池的 Memcache (oslo_cache.memcache_pool)。对于小于 100 个线程服务器的环境,建议使用 Memcached (dogpile.cache.memcached)或 Redis (dogpile.cache.redis)。带有单一服务器实例测试环境可以使用 dogpile.cache.memory 后端。

backend_argument = []

多值

提供给 backend 模块的参数。指定每个参数一次这个选项,以传递给 dogpile.cache 后端。示例格式:"<argname>:<value>"。

config_prefix = cache.oslo

字符串值

为缓存区域构建配置字典的前缀。除非存在具有相同配置名称的另一个 dogpile.cache 区域,否则不需要更改此设置。

dead_timeout = 60

浮点值

尝试将节点重新添加到 HashClient 内部机制中的池前的时间(以秒为单位)。

debug_cache_backend = False

布尔值

从缓存后端(缓存密钥、get/set/delete/etc 调用)进行额外的调试。只有在您需要使用键/值查看特定的 cache-backend get/set/delete 调用时,这才有用。通常,这应该设为 false。

enable_retry_client = False

布尔值

启用重试客户端机制来处理失败。这些机制可用于嵌套所有的 pymemcache 客户端。打包程序允许您定义在 attemots 之间等待多少次尝试和等待的时间。

enable_socket_keepalive = False

布尔值

dogpile 的 pymemcache backend 的 socket keepalive 的全局切换

enabled = False

布尔值

缓存的全局切换。

expiration_time = 600

整数值

dogpile.cache 区域中的任何缓存项目的默认 TTL (以秒为单位)。这适用于没有为其定义显式缓存过期时间的任何缓存方法。

hashclient_retry_attempts = 2

整数值

在客户端被标记为死状态并从 HashClient 内部机制中的池中移除客户端的次数。

hashclient_retry_delay = 1

浮点值

在 HashClient 内部机制中应在重试尝试之间传递的时间(以秒为单位)。

memcache_dead_retry = 300

整数值

在再次尝试前 memcached 服务器被视为死的秒数。(dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。

`memcache_password = `

字符串值

启用 SASL 的 memcached 密码

memcache_pool_connection_get_timeout = 10

整数值

操作将等待进入 memcache 客户端连接的秒数。

memcache_pool_flush_on_reconnect = False

布尔值

如果 memcache 将在重新连接时清空,则全局切换。(仅限oslo_cache.memcache_pool 后端)。

memcache_pool_maxsize = 10

整数值

每个 memcached 服务器的最大打开连接数。(仅限oslo_cache.memcache_pool 后端)。

memcache_pool_unused_timeout = 60

整数值

在关闭之前,与 memcached 的连接在池中保持未使用的秒数。(仅限oslo_cache.memcache_pool 后端)。

memcache_sasl_enabled = False

布尔值

如果 SASL_enable 为 true,则启用 SASL (Simple Authentication and SecurityLayer),否则禁用。

memcache_servers = ['localhost:11211']

列出值

memcache 服务器的格式是 "host:port"。这由依赖 Memcached 的后端使用。如果 dogpile.cache.memcachedoslo_cache.memcache_pool 已使用,并且给定主机引用 IPv6 或给定域引用 IPv6,那么您应该为给定地址加上地址系列(inet6)添加前缀(inet6) (e.g inet6[::1]:11211,inet6:[fd12:3456:789a:1::1]:11211,inet6 [controller-0] 211:11211)使用。如果未指定地址系列,则这些后端将使用与 IPv4 对应的默认 inet 地址系列

memcache_socket_timeout = 1.0

浮点值

对每个对服务器调用的超时时间(dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。

`memcache_username = `

字符串值

启用 SASL 的 memcached 的用户名

proxies = []

列出值

用于导入的代理类将影响 dogpile.cache 后端功能的方式。参阅 dogpile.cache 文档中有关 changing-backend-behavior 的文档。

retry_attempts = 2

整数值

失败前尝试操作的次数。

retry_delay = 0

浮点值

每次尝试之间休眠的秒数。

socket_keepalive_count = 1

整数值

丢弃连接前应发送的最大 keepalive 探测 TCP 数。应该是一个大于零的正整数。

socket_keepalive_idle = 1

整数值

在 TCP 开始发送 keepalive 探测前,连接需要保持闲置的时间(以秒为单位)。应该是一个大于零的正整数。

socket_keepalive_interval = 1

整数值

单个 keepalive 探测之间的时间(以秒为单位)。应该是一个大于零的正整数。

tls_allowed_ciphers = None

字符串值

为使用 TLS 上下文创建的套接字设置可用密码。它应该是 OpenSSL 密码列表格式的字符串。如果没有指定,则所有启用的 OpenSSL 密码都将可用。

tls_cafile = None

字符串值

以 PEM 格式串联的 CA 证书文件的路径,以建立缓存服务器的真实性。如果 tls_enabled 是 False,则忽略这个选项。

tls_certfile = None

字符串值

PEM 格式的单个文件的路径,其中包含客户端证书以及建立证书真实性所需的任意数量的 CA 证书。仅当需要客户端身份验证时,才需要此文件。如果 tls_enabled 是 False,则忽略这个选项。

tls_enabled = False

布尔值

与缓存服务器捆绑时,用于 TLS 使用的全局切换。

tls_keyfile = None

字符串值

到包含客户端私钥的单个文件的路径。否则,私钥将从 tls_certfile 中指定的文件中获取。如果 tls_enabled 是 False,则忽略这个选项。

9.1.7. cinder

下表概述了 /etc/nova/nova.conf 文件中的 [cinder] 组下可用的选项。

表 9.6. cinder
配置选项 = 默认值类型Description

auth-url = None

字符串值

身份验证 URL

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

catalog_info = volumev3::publicURL

字符串值

在服务目录中查找 cinder 时要匹配 info。

& lt;service_name > 是可选的,并默认省略,因为大多数部署中不应该需要它。

可能的值:

  • 格式是以 <service_type>:<service_name>:<endpoint_type> 的形式分隔的值。

注意: 自 Nova Nova 17.0.0 Queens 版本,将不再支持 Cinder v2 API。

相关选项:

  • endpoint_template - 设置此选项将覆盖 catalog_info

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

cross_az_attach = True

布尔值

允许在不同可用区中的 instance 和 volume 之间连接。

如果 False,附加到实例的卷必须在 Cinder 中与 Nova 中的实例可用性区域相同。

这也意味着,在从不是"卷"的卷引导实例时应小心谨慎,因为 Nova 将尝试使用与分配给实例相同的可用区创建卷。

如果该 AZ 不在 Cinder 中(或在 cinder.conf 中允许_availability_zone_fallback=False ),则卷创建请求将失败,实例将失败。

默认情况下,卷附加没有可用区限制。

相关选项:

  • [DEFAULT]/default_schedule_zone

debug = False

布尔值

独立于其余 Nova,使用 cinderclient 和 os_brick 启用 DEBUG 日志记录。

default-domain-id = None

字符串值

与 v3 和 v2 参数一起使用的可选域 ID。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

default-domain-name = None

字符串值

与 v3 API 和 v2 参数一起使用的可选域名。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

domain-id = None

字符串值

域 ID 范围

domain-name = None

字符串值

域名范围为

endpoint_template = None

字符串值

如果设置了这个选项,它将使用 cinder 端点的此模板覆盖服务目录查找

可能的值:

注意: 自 Nova Nova 17.0.0 Queens 版本,将不再支持 Cinder v2 API。

相关选项:

  • catalog_info - 如果没有设置 endpoint_template,则使用 catalog_info。

http_retries = 3

整数值

cinderclient 应该在任何失败的 http 调用上重试的次数。0 表示只尝试连接一次。把它设置为任何正整数意味着,在失败连接时会重试,例如,将多次设置为 3,表示连接的总尝试为 4。

可能的值:

  • 任何整数值。0 表示只尝试连接一次

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

os_region_name = None

字符串值

此节点的地区名称。这在选择服务目录中的 URL 时使用。

可能的值:

  • 代表区域名称的任何字符串

password = None

字符串值

用户密码

project-domain-id = None

字符串值

包含项目的域 ID

project-domain-name = None

字符串值

包含项目的域名

project-id = None

字符串值

项目 ID 到范围

project-name = None

字符串值

项目名称到范围

split-loggers = False

布尔值

记录对多个日志记录器的请求。

system-scope = None

字符串值

系统操作范围

tenant-id = None

字符串值

租户 ID

tenant-name = None

字符串值

租户名称

timeout = None

整数值

http 请求的超时值

trust-id = None

字符串值

用作信任者使用的信任 ID

user-domain-id = None

字符串值

用户的域 ID

user-domain-name = None

字符串值

用户的域名

user-id = None

字符串值

用户 ID

username = None

字符串值

用户名

9.1.8. Compute

下表概述了 /etc/nova/nova.conf 文件中的 [compute] 组下可用的选项。

表 9.7. Compute
配置选项 = 默认值类型Description

consecutive_build_service_disable_threshold = 10

整数值

启用向调度程序报告构建失败。

任何非零值都会启用向调度程序发送构建失败统计信息,供 BuildFailureWeigher 使用。

可能的值:

  • 任何正整数都会导致报告构建失败。
  • 零来禁用报告构建失败。

相关选项:

  • [filter_scheduler]/build_failure_weight_multiplier

cpu_dedicated_set = None

字符串值

可用于 PCPU 资源的主机 CPU 掩码。

此选项的行为会影响已弃用的 vcpu_pin_set 选项的行为。

  • 如果定义了这个选项,定义 vcpu_pin_set 会导致错误。
  • 如果没有定义此选项,则使用 vcpu_pin_set 来确定 VCPU 资源的清单,并限制固定和未固定实例可调度到的主机 CPU。

当删除 vcpu_pin_set 时,将在以后的发行版本中简化此行为。

可能的值:

  • 可以从中分配实例 VCPU 的物理 CPU 编号的逗号分隔列表。每个元素应该是单个 CPU 编号、CPU 编号范围或一个 caret,后跟一个要从其中排除的 CPU 号。

    之前的范围.例如:
    cpu_dedicated_set = "4-12,^8,15"

相关选项:

  • [compute] cpu_shared_set: 这是用于定义应从中分配 VCPU 资源的位置对应的选项。
  • vcpu_pin_set: 此选项部分替换的传统选项。

cpu_shared_set = None

字符串值

可用于 VCPU 资源和卸载仿真程序线程的主机 CPU 掩码。

此选项的行为取决于已弃用的 vcpu_pin_set 选项的定义。

  • 如果没有定义 vcpu_pin_set,则将使用 [compute] cpu_shared_set 来提供 VCPU 清单,并确定未固定实例可调度到的主机 CPU。它还将用于确定应当为使用共享仿真器线程策略(hw:emulator_threads_policy= share )配置的实例仿真程序线程卸载主机 CPUS。
  • 如果定义了 vcpu_pin_set,则 [compute] cpu_shared_set 将只用于决定主机 CPU,仿真程序线程应该被卸载到使用 share 仿真程序线程策略(hw:emulator_threads_policy=share)的实例。vcpu_pin_set 将用于提供 VCPU 清单,并确定固定和未固定实例可调度到的主机 CPU。

当删除 vcpu_pin_set 时,将在以后的发行版本中简化此行为。

可能的值:

  • 可以从中分配实例 VCPU 的物理 CPU 编号的逗号分隔列表。每个元素应该是单个 CPU 编号、CPU 编号范围或一个 caret,后跟一个要从其中排除的 CPU 号。

    之前的范围.例如:
    cpu_shared_set = "4-12,^8,15"

相关选项:

  • [compute] cpu_dedicated_set :这是定义要从中分配 PCPU 资源的对应选项。
  • vcpu_pin_set: 一个传统选项,其定义可能会更改这个选项的行为。

image_type_exclude_list = []

列出值

此计算节点不支持的镜像格式列表。

在某些情况下,可能需要让计算节点拒绝支持昂贵的或复杂的镜像格式。这因素是调度程序有关使用给定镜像引导时要选择哪些计算节点所做出的决定因素。

可能的值:

  • 任何 glance 镜像 disk_format 名称(即 rawqcow2 等)

相关选项:

  • [scheduler]query_placement_for_image_type_support - 启用根据支持的镜像类型过滤计算,需要启用它才能使它生效。

live_migration_wait_for_vif_plug = True

布尔值

在启动客户机的实际传输之前,确定源计算主机是否应该等待来自(neutron)网络服务 的网络-vif-plugged 事件到目标计算主机。

请注意,此选项会在实时迁移的目标主机上读取。如果您在所有计算主机上设置此选项相同,如果您完全使用相同的网络后端,则不必担心它。

在开始传输客户机前,一些设置会在目标计算主机上进行,包括插入虚拟接口。根据目标主机上的网络后端,可能会触发 network-vif-plugged 事件,然后在源计算主机接收,源计算可以等待该事件确保在目标主机上设置网络,然后再启动客户机传输。

  1. note::

    The compute service cannot reliably determine which types of virtual
    interfaces (`port.binding:vif_type`) will send `network-vif-plugged`
    events without an accompanying port `binding:host_id` change.
    Open vSwitch and linuxbridge should be OK, but OpenDaylight is at least
    one known backend that will not currently work in this case, see bug
    https://launchpad.net/bugs/1755890 for more details.

可能的值:

  • true :在启动客户机传输前等待 network-vif-plugged 事件
  • false :在启动客户机传输前不要等待 network-vif-plugged 事件(这是传统行为)

相关选项:

  • [DEFAULT]/vif_plugging_is _fatal: 如果 live_migration_wait_for _vif_plug 为 True 且 vif_plugging_timeout 大于 0,则实时迁移过程将失败,并显示错误,但客户机传输将没有启动到目标主机
  • [DEFAULT]/vif_plugging_timeout:如果 live_migration_wait_for_vif_plug 为 True,则控制在超时前等待的时间,如果 vif_plugging_is_fatal 为 True,或者只是继续实时迁移

max_concurrent_disk_ops = 0

整数值

我们并行执行的并发磁盘密集型操作(glance 镜像下载、镜像格式转换等)。如果此设置过高,则响应时间会受到影响。默认值为 0 表示没有限制。

max_disk_devices_to_attach = -1

整数值

允许附加到单个服务器的最大磁盘设备数。请注意,服务器支持的磁盘数量取决于使用的总线。例如,ide 磁盘总线限制为 4 个附加的设备。配置的最大值在服务器创建、重建、撤离、未缩小、实时迁移和附加卷期间强制执行。

通常,磁盘总线由设备类型或磁盘设备以及虚拟化类型自动决定。但是,也可以通过块设备映射或镜像属性指定磁盘总线。有关块设备映射中指定磁盘总线的更多信息,请参阅 :doc:/user/block-device-mapping 中的 disk_bus 字段,以及 https://docs.openstack.org/glance/latest/admin/useful-image-properties.html 以了解有关 hw_disk_bus 镜像属性的更多信息。

更改托管服务器的计算服务上的 [compute]/max_disk_devices_to_attach 的 Operator 应该知道它可能会导致重建失败,如果最大值低于已附加到服务器的设备数量。例如,如果服务器 A 附加了 26 个设备,并且运算符将 [compute]/max_disk_devices_to_attach 更改为 20,则重建服务器 A 的请求将失败,并进入 ERROR 状态,因为 26 个设备已经附加并超过新配置 20。

operator 设置 [compute]/max_disk_devices_to_attach 也应该注意,在冷迁移过程中,配置的最大值只强制执行,在移动前不会检查目的地。这意味着,如果运维人员在计算主机 A 上设置了最多 26 个,在计算主机 B 上设置了最多 20 个,则从计算主机 A 中的一个附加了 26 个设备的主机冷迁移到计算主机 B 将成功。然后,当服务器在计算主机 B 上后,重建服务器的后续请求将失败并进入 ERROR 状态,因为已经附加了 26 个设备,并超过计算主机 B 上配置的最大 20 个。

在 shelved 卸载服务器上不强制配置的最大值,因为它们没有计算主机。

  1. warning:: 如果此选项设为 0,则 nova-compute 服务将无法启动,因为 0 磁盘设备是无效的配置,阻止实例启动。

可能的值:

  • -1 表示无限
  • 任何整数 >= 1 代表允许的最大值。值 0 将导致 nova-compute 服务无法启动,因为 0 磁盘设备是无效的配置,阻止实例启动。

packing_host_numa_cells_allocation_strategy = False

布尔值

此选项控制用于选择主机上的 NUMA 单元的分配策略,以放置虚拟机的 NUMA 单元(用于带有定义的 numa 拓扑的虚拟机)。默认情况下,会选择具有更多资源消耗的 NUMA 单元来放置尝试。当 packing_host_numa_cells_allocation_strategy 变量设为 False 时,将使用具有更多资源的主机的 NUMA 单元。当设置为 True 单元时,使用一些用法的单元将与虚拟机的单元进行打包,直到使用新的空闲主机的单元前。

可能的值:

  • true :在大多数使用的主机 NUMA 单元上打包虚拟机的 NUMA 单元。
  • 错误 : 在主机的 NUMA 单元上显示虚拟机的 NUMA 单元具有更多可用资源。

provider_config_location = /etc/nova/provider_config/

字符串值

包含资源供应商配置数据的 YAML 文件的位置。

这些文件允许操作员指定额外的自定义清单和特征,以分配给一个或多个资源提供程序。

其他文档位于:

https://docs.openstack.org/nova/latest/admin/managing-resource-providers.html

resource_provider_association_refresh = 300

整数值

更新计算节点的资源提供程序清单、聚合和特征的 nova-compute-side 缓存的时间间隔。

此选项指定尝试更新提供程序的清单、聚合和特征在计算节点的本地缓存中的秒数。

值为零可完全禁用缓存刷新。

可以随时通过向计算进程发送 SIGHUP 来手动清除缓存,从而导致它在下次访问数据时重新填充。

可能的值:

  • 任何正整数(以秒为单位)或零个来禁用刷新。

shutdown_retry_interval = 10

整数值

在将 ACPI 关闭信号重新发送到实例前等待的时间(以秒为单位)。

shutdown_timeout 设置的等待总时间。

可能的值:

  • 任何大于 0 的整数(以秒为单位)

相关选项:

  • shutdown_timeout

vmdk_allowed_types = ['streamOptimized', 'monolithicSparse']

列出值

描述允许的 VMDK "create-type" 子格式的字符串列表。建议您只包含 single-file-with-sparse-header 变体,以避免因为处理命名范围而导致潜在的主机文件暴露。如果此列表为空,则不允许 VMDK 镜像形式。

9.1.9. conductor

下表概述了 /etc/nova/nova.conf 文件中的 [conductor] 组下可用的选项。

表 9.8. conductor
配置选项 = 默认值类型Description

Worker = None

整数值

OpenStack Conductor 服务的 worker 数量。默认值为可用的 CPU 数量。

9.1.10. 控制台

下表概述了 /etc/nova/nova.conf 文件中的 [console] 组下可用的选项。

表 9.9. 控制台
配置选项 = 默认值类型Description

allowed_origins = []

列出值

将允许的源列表添加到控制台 websocket 代理,以允许来自其他原始主机名的连接。websocket 代理将主机标头与 origin 标头匹配,以防止跨站点请求。此列表指定原始标头中是否允许 host 以外的任何值。

可能的值:

  • 一个列表,每个元素都是允许的原始主机名,其他是一个空列表

ssl_ciphers = None

字符串值

OpenSSL 密码首选项字符串,用于指定允许客户端 TLS 连接的密码。例如:

ssl_ciphers = "kEECDH+aECDSA+AES:kEECDH+AES+aRSA:kEDH+aRSA+AES"

有关 密码 首选项字符串格式和允许的值的详情,请查看 OpenSSL 密码命令的手册页:

https://www.openssl.org/docs/man1.1.0/man1/ciphers.html

相关选项:

  • [DEFAULT] 证书
  • [DEFAULT] 密钥

ssl_minimum_version = default

字符串值

允许的 SSL/TLS 协议版本。

相关选项:

  • [DEFAULT] 证书
  • [DEFAULT] 密钥

9.1.11. consoleauth

下表概述了 /etc/nova/nova.conf 文件中的 [consoleauth] 组下可用的选项。

表 9.10. consoleauth
配置选项 = 默认值类型Description

token_ttl = 600

整数值

控制台身份验证令牌的生命周期(以秒为单位)。

控制台身份验证令牌用于授权用户的控制台访问权限。当身份验证令牌时间过后,令牌将被视为过期。然后,已过期的令牌会被删除。

9.1.12. CORS

下表概述了 /etc/nova/nova.conf 文件中的 [cors] 组下可用的选项。

表 9.11. CORS
配置选项 = 默认值类型Description

allow_credentials = True

布尔值

指明实际请求可以包含用户凭证

allow_headers = ['X-Auth-Token', 'X-Openstack-Request-Id', 'X-Identity-Status', 'X-Roles', 'X-Service-Catalog', 'X-User-Id', 'X-Tenant-Id', 'X-OpenStack-Nova-API-Version', 'OpenStack-API-Version']

列出值

指定在实际请求过程中可以使用哪些标头字段名称。

allow_methods = ['GET', 'PUT', 'POST', 'DELETE', 'PATCH']

列出值

指明哪些方法可以在实际请求期间使用。

allowed_origin = None

列出值

指明此资源是否可以与请求"origin"标头中收到的域共享。格式:"<protocol>://<host>[:<port>]",没有结尾的斜杠。示例 :https://horizon.example.com

expose_headers = ['X-Auth-Token', 'X-Openstack-Request-Id', 'X-Subject-Token', 'X-Service-Token', 'X-OpenStack-Nova-API-Version', 'OpenStack-API-Version']

列出值

指明向 API 公开哪些标头是安全的。默认为 HTTP Simple Headers。

max_age = 3600

整数值

CORS preflight 请求的最大缓存期限。

9.1.13. cyborg

下表概述了 /etc/nova/nova.conf 文件中的 [cyborg] 组下可用的选项。

表 9.12. cyborg
配置选项 = 默认值类型Description

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

connect-retries = None

整数值

应该尝试连接错误的最大重试次数。

connect-retry-delay = None

浮点值

连接错误两次重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

endpoint-override = None

字符串值

始终使用此端点 URL 用于此客户端的请求。注意:应在此处指定未版本化的端点;若要请求特定的 API 版本,使用 version, min-version, 和/或 max-version 选项。

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

region-name = None

字符串值

端点 URL 发现的默认 region_name。

service-name = None

字符串值

用于端点 URL 发现的默认 service_name。

service-type = accelerator

字符串值

端点 URL 发现的默认 service_type。

split-loggers = False

布尔值

记录对多个日志记录器的请求。

status-code-retries = None

整数值

应该为可重试 HTTP 状态代码尝试的最大重试次数。

status-code-retry-delay = None

浮点值

可重试状态代码的两个重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

timeout = None

整数值

http 请求的超时值

valid-interfaces = ['internal', 'public']

列出值

用于端点 URL 的接口列表(按首选顺序排列)。

9.1.14. database

下表概述了 /etc/nova/nova.conf 文件中的 [database] 组下可用的选项。

表 9.13. database
配置选项 = 默认值类型Description

backend = sqlalchemy

字符串值

用于数据库的后端。

connection = None

字符串值

用于连接到数据库的 SQLAlchemy 连接字符串。

connection_debug = 0

整数值

SQL 调试信息的详细程度:0=None, 100=Everything。

`connection_parameters = `

字符串值

在连接时附加到连接 URL 上的可选 URL 参数 ; 指定为 param1=value1&param2=value2&…​

connection_recycle_time = 3600

整数值

连接池中存在的连接的时间超过这个秒数,将在下次从池中签出时被替换为新的秒数。

connection_trace = False

布尔值

将 Python 堆栈跟踪作为注释字符串添加到 SQL 中。

db_inc_retry_interval = True

布尔值

如果为 True,将数据库操作重试间隔增加到 db_max_retry_interval。

db_max_retries = 20

整数值

在引发错误前,连接错误或死锁错误时的最大重试次数。设置为 -1 以指定无限重试计数。

db_max_retry_interval = 10

整数值

如果设置了 db_inc_retry_interval,则数据库操作重试之间的最大秒数。

db_retry_interval = 1

整数值

数据库事务重试之间的秒数。

max_overflow = 50

整数值

如果设置,请对带有 SQLAlchemy 的 max_overflow 使用这个值。

max_pool_size = 5

整数值

池中保持打开的最大 SQL 连接数。设置 0 表示没有限制。

max_retries = 10

整数值

在启动过程中重试数据库连接的最大数量。设置为 -1 以指定无限重试计数。

mysql_enable_ndb = False

布尔值

如果为 True,则透明地启用对处理 MySQL 集群(NDB)的支持。弃用自: 12.1.0

适用于 MySQL NDB 集群存储引擎的reason:*Support 已弃用,并将在以后的版本中删除。

mysql_sql_mode = TRADITIONAL

字符串值

用于 MySQL 会话的 SQL 模式。此选项包括默认设置,可覆盖任何 server-set SQL 模式。要使用服务器配置设置的任何 SQL 模式,请将其设置为 no 值。示例:mysql_sql_mode=

mysql_wsrep_sync_wait = None

整数值

对于 Galera,对新连接配置 wsrep_sync_wait 导致性检查。默认为 None,表示不配置任何设置。

pool_timeout = None

整数值

如果设置,请对带有 SQLAlchemy 的 pool_timeout 使用这个值。

retry_interval = 10

整数值

打开 SQL 连接之间的间隔。

slave_connection = None

字符串值

用于连接到从属数据库的 SQLAlchemy 连接字符串。

sqlite_synchronous = True

布尔值

如果为 True,则 SQLite 使用同步模式。

use_db_reconnect = False

布尔值

在连接丢失时启用数据库重新连接的实验性使用。

use_tpool = False

布尔值

对所有 DB API 调用启用实验性使用,因为已弃用: 10.0.0

*reason:* 此功能永远不会从实验性状态升级,现在因为缺少维护和测试覆盖而被删除。

9.1.15. devices

下表概述了 /etc/nova/nova.conf 文件中的 [devices] 组下可用的选项。

表 9.14. devices
配置选项 = 默认值类型描述

enabled_mdev_types = []

列出值

计算节点中启用的 mdev 类型。

有些硬件(如 NVIDIA GRID K1)支持不同的 mdev 类型。用户可以使用此选项指定可分配给客户机实例的启用 mdev 类型列表。

如果提供了多个 mdev 类型,则必须将每个 mdev 类型 添加一个额外部分 [mdev_$(MDEV_TYPE)]。然后,每个部分 都必须 配置一个单独的配置选项 device_addresses,它应该是与物理 GPU 或支持 mdev 支持的硬件对应的 PCI 地址列表。

如果缺少一个或多个部分(请注意,对于一个物理设备,或者未提供设备地址),则 Nova 将仅使用 [devices]/enabled_mdev_types 提供的第一个类型。

如果为两种不同类型的提供了同样的 PCI 地址,nova-compute 会在重启时返回一个 InvalidLibvirtMdevConfig 异常。

作为模拟周期,将接受名为 [vgpu_$(MDEV_TYPE)] 的旧配置组。然后,有效的配置可以是:

[devices]
enabled_mdev_types = nvidia-35, nvidia-36
[mdev_nvidia-35]
device_addresses = 0000:84:00.0,0000:85:00.0
[vgpu_nvidia-36]
device_addresses = 0000:86:00.0

9.1.16. ephemeral_storage_encryption

下表概述了 /etc/nova/nova.conf 文件中的 [ephemeral_storage_encryption] 组下可用的选项。

表 9.15. ephemeral_storage_encryption
配置选项 = 默认值类型Description

cipher = aes-xts-plain64

字符串值

要使用的 cipher-mode 字符串。

用于加密临时存储的密码和模式。可用的加密模式组合集合取决于内核支持。根据 dm-crypt 文档,密码应该采用以下格式:"<cipher>-<chainmode>-<ivmode>"。

可能的值:

  • 任何在 /proc/crypto 中列出的加密选项。

enabled = False

布尔值

启用/禁用 LVM 临时存储加密。

key_size = 512

整数值

加密密钥长度(以位为单位)。

用于加密临时存储的加密密钥的位长度。在 XTS 模式中,只有一半的位用于加密密钥。

9.1.17. filter_scheduler

下表概述了 /etc/nova/nova.conf 文件中的 [filter_scheduler] 组下可用的选项。

表 9.16. filter_scheduler
配置选项 = 默认值类型Description

aggregate_image_properties_isolation_namespace = None

字符串值

主机聚合中使用的镜像属性命名空间。

可以配置镜像和主机,以便某些镜像只能调度到特定聚合中的主机。这可以通过在主机聚合上设置的元数据值完成,这些值以此选项的值开头。如果主机是带有此类元数据键的聚合的一部分,则 request spec 中的镜像必须具有该元数据的值,以便调度程序将主机视为可接受的主机。

请注意,此设置仅在启用了 AggregateImagePropertiesIsolation 过滤器时影响调度。

可能的值:

  • 字符串,其中字符串对应于镜像属性命名空间

相关选项:

  • [filter_scheduler] aggregate_image_properties_isolation_separator

aggregate_image_properties_isolation_separator = .

字符串值

镜像属性命名空间和名称的分隔符字符。

使用 aggregate_image_properties_isolation 过滤器时,相关的元数据键使用 aggregate_image_properties_isolation_namespace 配置选项中定义的命名空间作为前缀。此选项定义要使用的分隔符。

请注意,此设置仅在启用了 AggregateImagePropertiesIsolation 过滤器时影响调度。

可能的值:

  • 字符串,其中字符串对应于镜像属性命名空间分隔符字符

相关选项:

  • [filter_scheduler] aggregate_image_properties_isolation_namespace

available_filters = ['nova.scheduler.filters.all_filters']

多值

调度程序可以使用的过滤器。

nova 调度程序可能应用的过滤器类的未排序列表。仅使用 [filter_scheduler] enabled_filters 选项中指定的过滤器,但出现在该选项中的任何过滤器还必须包含在此列表中。

默认情况下,设置为 nova 中包含的所有过滤器。

可能的值:

  • 零个或更多字符串的列表,其中每个字符串都对应于可用于选择主机的过滤器名称

相关选项:

  • [filter_scheduler] enabled_filters

build_failure_weight_multiplier = 1000000.0

浮点值

用于权衡具有最新构建故障的主机倍数。

此选项决定了在具有最新构建故障的计算节点上放置了多少权重。构建失败可能表示失败、配置错误或以其他方式处理计算节点,并避免在调度期间出现帮助。权重与计算节点已经历的最新构建失败数量成比例。由于可用资源,这个值应设置为一些高的值,以偏移由其他启用的 weighers 给出的权重。要禁用按最近的故障数权重计算主机,请将其设置为零。

请注意,此设置仅在启用了 BuildFailureWeigher weigher 时才会影响调度。

可能的值:

  • 整数或浮点值,其中值对应于此 weigher 的倍数比率。

相关选项:

  • [compute] consecutive_build_service_disable_threshold - Must 为计算报告此 weigher 所考虑的数据的非零。
  • [filter_scheduler] weight_classes

cpu_weight_multiplier = 1.0

浮点值

CPU 权重倍数比率。

用于加权空闲 vCPU 的倍数。负数表示堆栈而不是分布。

请注意,此设置仅在启用了 CPUWeigher weigher 时影响调度。

可能的值:

  • 整数或浮点值,其中值对应于此 weigher 的多元比率。

相关选项:

  • [filter_scheduler] weight_classes

cross_cell_move_weight_multiplier = 1000000.0

浮点值

在跨单元迁移期间用于权衡主机的倍数。

这个选项决定在主机上放置多少权重,它在移动服务器时在同一源单元中,例如在跨单元调整大小过程中。默认情况下,当移动实例时,调度程序将首选同一单元格中的主机,因为跨单元迁移的复杂性质可能会较慢且风险更高。

请注意,此设置仅在启用了 CrossCellWeigher weigher 时才会影响调度。如果您的云没有配置为支持跨单元迁移,则这个选项无效。

此配置选项的值可以通过设置相同名称的聚合元数据键(cross_cell_move_weight_multiplier)来覆盖。

可能的值:

  • 整数或浮点值,其中值对应于此 weigher 的倍数比率。正数值表示,weigher 将首选运行该实例的同一单元格中的主机。负值意味着 weigher 将优先选择运行该实例 的其他 单元格中的主机。

相关选项:

  • [filter_scheduler] weight_classes

disk_weight_multiplier = 1.0

浮点值

磁盘权重多率。

用于权衡可用磁盘空间的倍数。负数意味着堆栈与分散。

请注意,此设置仅在启用了 DiskWeigher weigher 时才会影响调度。

可能的值:

  • 整数或浮点值,其中值对应于此 weigher 的多元比率。

enabled_filters = ['ComputeFilter', 'ComputeCapabilitiesFilter', 'ImagePropertiesFilter', 'ServerGroupAntiAffinityFilter', 'ServerGroupAffinityFilter']

列出值

调度程序将使用的过滤器。

用于过滤主机的过滤类名称列表。这些过滤器将按照列出的顺序应用,以便首先将限制性最强的过滤器设置为更高的过滤过程。

此选项中的所有过滤器 都必须 出现在 [scheduler_filter] available_filter 选项中,或者会引发 SchedulerHostFilterNotFound 异常。

可能的值:

  • 零个或更多字符串的列表,其中每个字符串都对应于用于选择主机的过滤器名称

相关选项:

  • [filter_scheduler] available_filters

host_subset_size = 1

整数值

调度程序选择的最佳主机子集的大小。

新实例将调度到从 N best 主机的子集随机选择的主机上,其中 N 是此选项所设置的值。

把它设置为大于 1 的值可降低多个调度程序进程处理类似请求的几率将选择同一主机,从而造成潜在的竞争条件。通过从最适合请求的 N 主机中随机选择主机,会减少冲突的可能性。但是,您设置这个值越高,所选主机可能是给定请求的最佳选择。

可能的值:

  • 整数,整数对应于主机子集的大小。

hypervisor_version_weight_multiplier = 1.0

浮点值

管理程序版本权重倍数比率。

倍数用于根据报告的虚拟机监控程序版本对主机进行权重。负数字表示首选旧的主机,默认值是首选使用较新的主机来协助升级。

可能的值:

  • 整数或浮点值,其中值对应于此 weigher 的倍数比率。

Example:

  • 强烈建议您旧的主机

    1. code-block:: ini

      [filter_scheduler]
      hypervisor_version_weight_multiplier=-1000
  • 中等地首选新主机

    1. code-block:: ini

      [filter_scheduler]
      hypervisor_version_weight_multiplier=2.5
  • 禁用 weigher 影响

    1. code-block:: ini

      [filter_scheduler]
      hypervisor_version_weight_multiplier=0

相关选项:

  • [filter_scheduler] weight_classes

image_properties_default_architecture = None

字符串值

使用镜像属性过滤器时要使用的默认架构。

使用 ImagePropertiesFilter 时,您可以定义一个默认的架构,以便用户体验变得更加简单,并避免类似 x86_64 镜像登录 AARCH64 计算节点上,因为用户没有在 Glance 中指定 hw_architecture 属性。

可能的值:

  • CPU 架构,如 x86_64, aarch64, s390x。

io_ops_weight_multiplier = -1.0

浮点值

IO 操作权重多r比率。

这个选项决定了具有不同工作负载的主机是如何权衡的。负值(如默认值)将导致调度程序首选主机具有更轻的工作负载的主机,而正值则优先选择具有繁重工作负载的主机。查看它的另一个方法是,此选项的正值通常会将实例调度到已经忙碌的主机上,而负值则往往在更多主机之间分发工作负载。绝对值(无论是正还是负)控制 io_ops weigher 相对于其他 Weighers 的强度量。

请注意,此设置仅在启用了 IoOpsWeigher weigher 时才会影响调度。

可能的值:

  • 整数或浮点值,其中值对应于此 weigher 的多元比率。

相关选项:

  • [filter_scheduler] weight_classes

isolated_hosts = []

列出值

只能运行某些镜像的主机列表。

如果需要将某些镜像限制为仅在指定主机上运行,请在此处列出这些主机名。

请注意,此设置仅在启用了 IsolatedHostsFilter 过滤器时影响调度。

可能的值:

  • 字符串列表,其中每个字符串都对应于一个主机的名称

相关选项:

  • [filter_scheduler] isolated_images
  • [filter_scheduler] restrict_isolated_hosts_to_isolated_images

isolated_images = []

列出值

只能在某些主机上运行的镜像的 UUID 列表。

如果需要将某些镜像限制为仅在指定主机上运行,请在此处列出这些镜像 UUID。

请注意,此设置仅在启用了 IsolatedHostsFilter 过滤器时影响调度。

可能的值:

  • UUID 字符串列表,其中每个字符串都对应于镜像的 UUID

相关选项:

  • [filter_scheduler] isolated_hosts
  • [filter_scheduler] restrict_isolated_hosts_to_isolated_images

max_instances_per_host = 50

整数值

主机上可以存在的最大实例数。

如果您需要限制任何给定主机上的实例数量,请将此选项设置为您要允许的最大实例数。NumInstancesFilter 和 AggregateNumInstancesFilter 将拒绝任何至少有相同实例的主机作为此选项的值。

请注意,此设置仅在启用了 NumInstancesFilterAggregateNumInstancesFilter 过滤器时影响调度。

可能的值:

  • 一个整数,整数对应于可调度到主机上的 max 实例。

相关选项:

  • [filter_scheduler] enabled_filters

max_io_ops_per_host = 8

整数值

可以在主机上主动执行 IO 的实例数量。

执行 IO 的实例包括以下状态:build, resize, snapshot, migrate, rescue, unshelve。

请注意,此设置仅在启用了 IoOpsFilter 过滤器时影响调度。

可能的值:

  • 整数,其中整数对应于可在任何给定主机上执行 IO 的最大实例数。

相关选项:

  • [filter_scheduler] enabled_filters

pci_in_placement = False

布尔值

在放置中启用调度和声明 PCI 设备。

这可在所有计算主机上启用 [pci]report_in_placement

启用后,调度程序会查询 PCI 设备可用性的放置,以便为带有 PCI 请求的服务器选择目的地。调度程序还会在放置中分配所选 PCI 设备。请注意,这个逻辑不会替换 PCIPassthroughFilter,但会扩展它。

  • [pci] report_in_placement
  • [PCI] 别名
  • [pci] device_spec

pci_weight_multiplier = 1.0

浮点值

PCI 设备关联性权重倍数.

PCI 设备关联性权重器根据主机上的 PCI 设备数量以及实例请求的 PCI 设备数量来计算权重。

请注意,此设置只有在启用了 PCIWeigher weigher 和 NUMATopologyFilter 过滤器时才会影响调度。

可能的值:

  • 一个正整数或浮点值,其中值对应于此 weigher 的倍数比率。

相关选项:

  • [filter_scheduler] weight_classes

ram_weight_multiplier = 1.0

浮点值

RAM 权重多率。

此选项决定了如何权衡具有更多或更少的可用 RAM 的主机。正值将导致调度程序优先选择具有更多可用 RAM 的主机,负数将导致调度程序优先选择可用 RAM 的主机。另一种查看的是此选项的正值将往往分散在多个主机中,而负值则往往尽可能填满(stack)主机,然后再调度到更易用的主机。绝对值(无论是正还是负)控制 RAM weigher 相对于其他 Weighers 的强度量。

请注意,此设置仅在启用了 RAMWeigher weigher 时影响调度。

可能的值:

  • 整数或浮点值,其中值对应于此 weigher 的多元比率。

相关选项:

  • [filter_scheduler] weight_classes

restrict_isolated_hosts_to_isolated_images = True

布尔值

防止在隔离的主机上构建非隔离镜像。

请注意,此设置仅在启用了 IsolatedHostsFilter 过滤器时影响调度。即使如此,这个选项不会影响隔离镜像的请求的行为,这将 始终 限制为隔离的主机。

相关选项:

  • [filter_scheduler] isolated_images
  • [filter_scheduler] isolated_hosts

shuffle_best_same_weighed_hosts = False

布尔值

启用在具有相同最佳权重的主机之间分散实例。

[filter_scheduler] host_subset_size 为 1 (默认),但有大量具有相同最大权重的主机时,启用它很有用。在 Ironic 部署中,这个情况很常见,其中通常有许多裸机节点返回给调度程序。在这种情况下,启用此选项将减少争用和重新调度事件的机会。同时,它将使实例打包(甚至在未衡量的情况下)减少密度。

soft_affinity_weight_multiplier = 1.0

浮点值

用于权衡主机用于组 soft-affinity 的倍数。

请注意,此设置仅在启用了 ServerGroupSoftAffinityWeigher weigher 时才会影响调度。

可能的值:

  • 非负整数或浮点值,其中值对应于具有组 soft affinity 主机的权重倍数。

相关选项:

  • [filter_scheduler] weight_classes

soft_anti_affinity_weight_multiplier = 1.0

浮点值

用于权衡主机用于组 soft-anti-affinity 的倍数。

请注意,此设置仅在启用了 ServerGroupSoftAntiAffinityWeigher weigher 时才会影响调度。

可能的值:

  • 非负整数或浮点值,其中值对应于具有组软反关联性的主机的权重倍数。

相关选项:

  • [filter_scheduler] weight_classes

track_instance_changes = True

布尔值

启用查询单个主机以获取实例信息。

调度程序可能需要主机上实例的信息,以评估其过滤器和权重。此信息的最常见需求是(anti-) affinity 过滤器,该过滤器需要根据主机上已在运行的实例选择主机。

如果配置的过滤器和 weighers 不需要此信息,则禁用这个选项将提高性能。当跟踪开销证明过重时,可能会禁用它,虽然这会导致需要主机使用数据的类在每个请求上查询数据库。

  1. note::

    In a multi-cell (v2) setup where the cell MQ is separated from the
    top-level, computes cannot directly communicate with the scheduler. Thus,
    this option cannot be enabled in that scenario. See also the
    `[workarounds] disable_group_policy_check_upcall` option.

相关选项:

  • [filter_scheduler] enabled_filters
  • [workarounds] disable_group_policy_check_upcall

weight_classes = ['nova.scheduler.weights.all_weighers']

列出值

调度程序要使用的权衡。

只有通过过滤器的主机才会权衡。任何主机的权重从 0 开始,且 weighers 通过添加到或从之前的 weigher 分配的权重中减去这些主机。权重可能会变得负数。一个实例将调度到 N 个最加权的主机之一,其中 N 是 [filter_scheduler] host_subset_size

默认情况下,设置为 Nova 中包含的所有权重。

可能的值:

  • 零个或更多字符串的列表,其中每个字符串都对应于用于选择主机的 weigher 的名称

9.1.18. Glance

下表概述了 /etc/nova/nova.conf 文件中的 [glance] 组下可用的选项。

表 9.17. Glance
配置选项 = 默认值类型描述

api_servers = None

列出值

nova 可用的 glance api 服务器端点列表。

HTTPS 用于基于 ssl 的 glance api 服务器。

注意

端点发现的首选机制是通过 keystoneauth1 加载选项。只有在需要多个端点且无法出于某种原因使用负载均衡器时,才使用 api_servers。

可能的值:

  • "scheme://hostname:port[/path]" (i.e. "http://10.0.1.0:9292" 或 "https://my.glance.server/image")的任何完全限定 URL 的列表。

弃用自: 21.0.0

reason: 通过标准 keystoneauth1 Adapter 选项支持镜像服务配置,在 17.0.0 Queens 发行版本中添加了。api_servers 选项被临时保留,以便消费者时间切入实际的负载平衡解决方案。

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

connect-retries = None

整数值

应该尝试连接错误的最大重试次数。

connect-retry-delay = None

浮点值

连接错误两次重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

debug = False

布尔值

使用 glanceclient 启用或禁用调试日志记录。

default_trusted_certificate_ids = []

列出值

应该信任的证书 ID 列表。

可用作证书验证的默认可信证书 ID 列表。如果用户提供了带有实例 API 请求的可信证书 ID 列表,则此选项的值将被忽略。如果启用了签名验证和证书验证,并且如果用户未提供替代列表,则此选项的值将保留给实例数据。如果启用了证书验证时,如果用户必须提供可信证书 ID 列表,否则证书验证将失败。

相关选项:

  • 如果启用了 verify_glance_signatures 和 enable_certificate_validation,则可以使用此选项的值。

enable_certificate_validation = False

布尔值

启用用于镜像签名验证的证书验证。

在镜像签名验证 nova 期间,首先将使用与实例关联的可信证书集合来验证镜像的签名证书的有效性。如果证书验证失败,则不会执行签名验证,实例将放入错误状态。这为最终用户提供了更强的保证,确保镜像数据未经修改且可信。如果禁用,镜像签名验证仍然可以发生,但最终用户不会保证用于生成镜像签名的签名证书仍然是可信的。

相关选项:

  • 只有在启用了 verify_glance_signatures 时,此选项才会生效。
  • 启用此选项时,可以使用 default_trusted_certificate_ids 的值。

弃用自:16.0.0

原因: 此选项旨在简化利用镜像签名验证的部署转换。预期的状态长期用于签名验证和证书验证,以始终一起发生。

enable_rbd_download = False

布尔值

启用 Glance 镜像直接通过 RBD 下载。

允许使用本地存储的非 rbd 计算通过 rbd 而不是 Glance API 从 Ceph 下载和缓存镜像。

  1. 注意:仅当计算本身没有将 Ceph 用作后备存储时,才应启用此选项。例如,对于 libvirt 驱动程序,它只有在 :oslo.config:option:libvirt.images_type 没有设置为 rbd 时才应启用。

相关选项:

  • :oslo.config:option:glance.rbd_user
  • :oslo.config:option:glance.rbd_connect_timeout
  • :oslo.config:option:glance.rbd_pool
  • :oslo.config:option:glance.rbd_ceph_conf
  • :oslo.config:option:libvirt.images_type

endpoint-override = None

字符串值

始终使用此端点 URL 用于此客户端的请求。注意:应在此处指定未版本化的端点;若要请求特定的 API 版本,使用 version, min-version, 和/或 max-version 选项。

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

num_retries = 3

整数值

启用 glance 操作重试。

指定在将 / 下载镜像到 glance 时的重试次数。0 表示没有重试。

`rbd_ceph_conf = `

字符串值

要使用的 ceph 配置文件的路径。

相关选项:

  • 只有在 :oslo.config:option:glance.enable_rbd_download 设置为 True 时才使用这个选项。

rbd_connect_timeout = 5

整数值

在最初连接到集群时,RADOS 客户端超时(以秒为单位)。

相关选项:

  • 只有在 :oslo.config:option:glance.enable_rbd_download 设置为 True 时才使用这个选项。

`rbd_pool = `

字符串值

Glance 镜像存储为 rbd 卷的 RADOS 池。

相关选项:

  • 只有在 :oslo.config:option:glance.enable_rbd_download 设置为 True 时才使用这个选项。

`rbd_user = `

字符串值

用于访问存储为 rbd 卷的 Glance 镜像的 RADOS 客户端名称。

相关选项:

  • 只有在 :oslo.config:option:glance.enable_rbd_download 设置为 True 时才使用这个选项。

region-name = None

字符串值

端点 URL 发现的默认 region_name。

service-name = None

字符串值

用于端点 URL 发现的默认 service_name。

service-type = image

字符串值

端点 URL 发现的默认 service_type。

split-loggers = False

布尔值

记录对多个日志记录器的请求。

status-code-retries = None

整数值

应该为可重试 HTTP 状态代码尝试的最大重试次数。

status-code-retry-delay = None

浮点值

可重试状态代码的两个重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

timeout = None

整数值

http 请求的超时值

valid-interfaces = ['internal', 'public']

列出值

用于端点 URL 的接口列表(按首选顺序排列)。

verify_glance_signatures = False

布尔值

启用镜像签名验证。

Nova 使用来自 glance 的镜像签名元数据,并在下载该镜像时验证签名。如果无法验证镜像签名,或者镜像签名元数据不完整或不可用,则 nova 将无法引导镜像,而是将实例置于错误状态。这为最终用户提供了对用于创建服务器的镜像数据的完整性的更强的保证。

相关选项:

  • key_manager 组中的选项,因为 key_manager 用于签名验证。
  • 以下的 enable_certificate_validation 和 default_trusted_certificate_ids 依赖于启用此选项。

9.1.19. guestfs

下表概述了 /etc/nova/nova.conf 文件中的 [guestfs] 组下可用的选项。

表 9.18. guestfs
配置选项 = 默认值类型Description

debug = False

布尔值

启用/禁用 guestfs 日志记录。

这会将 guestfs 配置为调试消息并将其推送到 OpenStack 日志记录系统。当设置为 True 时,它会跟踪 libguestfs API 调用并启用详细调试信息。要使用上述功能,必须安装"libguestfs"软件包。

相关选项:

由于 libguestfs 访问和修改由 libvirt 管理的虚拟机,应设置以下选项以授予这些虚拟机的访问权限。

  • libvirt.inject_key
  • libvirt.inject_partition
  • libvirt.inject_password

9.1.20. healthcheck

下表概述了 /etc/nova/nova.conf 文件中的 [healthcheck] 组下可用的选项。

表 9.19. healthcheck
配置选项 = 默认值类型Description

backends = []

列出值

可以执行健康检查的额外后端,并报告信息作为请求的一部分。

detailed = False

布尔值

作为响应的一部分,显示更详细的信息。安全备注:启用此选项可能会公开有关被监控服务的敏感详情。务必验证它是否不会违反您的安全策略。

disable_by_file_path = None

字符串值

检查是否存在文件,以确定应用程序是否在端口上运行。由 DisableByFileHealthcheck 插件使用。

disable_by_file_paths = []

列出值

根据端口检查是否存在文件,以确定应用程序是否在端口上运行。需要一个字符串的 "port:path" 列表。由 DisableByFilesPortsHealthcheck 插件使用。

path = /healthcheck

字符串值

响应 healtcheck 请求的路径。

9.1.21. hyperv

下表概述了 /etc/nova/nova.conf 文件中的 [hyperv] 组下可用的选项。

表 9.20. hyperv
配置选项 = 默认值类型Description

config_drive_cdrom = False

布尔值

将配置驱动器挂载为 CD 驱动器。

OpenStack 可以配置为将实例元数据写入配置驱动器,然后附加到实例启动前。配置驱动器可以作为磁盘驱动器(默认)或 CD 驱动器附加。

相关选项:

  • 这个选项有意义,将 force_config_drive 选项设置为 True,或者当创建实例的 REST API 调用时,将具有 --config-drive=True 标志。
  • config_drive_format 选项必须设置为 iso9660,才能将 CD 驱动器用作配置驱动器镜像。
  • 要将配置驱动器与 Hyper-V 一起使用,您必须将 mkisofs_cmd 值设置为 mkisofs.exe 安装的完整路径。另外,您必须将 qemu_img_cmd 值设置为 qemu-img 命令安装的完整路径。
  • 您可以通过将 force_config_drive 选项设置为 True,将 Compute 服务配置为始终创建配置驱动器。

config_drive_inject_password = False

布尔值

将密码注入配置驱动器。

启用后,可从配置驱动器镜像中提供管理员密码。

相关选项:

  • 这个选项与启用 Hyper-V 的其他选项一起使用时有意义,如 force_config_drive

dynamic_memory_ratio = 1.0

浮点值

动态内存比率

当设置为大于 1 的值时,启用动态内存分配(ballooning)。该值表示分配给实例的 RAM 总量及其启动 RAM 大小之间的比率。例如,1024MB RAM 的实例的 2.0 比例表示在启动时分配的 512MB RAM。

可能的值:

  • 1.0 :禁用动态内存分配(默认)。
  • 大于 1.0 的浮点值:启用分配总表示的 RAM 的分配,以便启动这个值。

enable_instance_metrics_collection = False

布尔值

启用实例指标集合

使用 Hyper-V 的指标 API 为实例启用指标集合。收集的数据可以由其他应用和服务检索,例如:Ceilometer。

enable_remotefx = False

布尔值

启用 RemoteFX 功能

这至少需要启用 Windows / Hyper-V Server 2012 R2 或更新版本和 RDS-Virtualization 功能的一个直接X 11 功能图形适配器。

带有 RemoteFX 的实例可使用以下类型额外规格请求:

OS:分辨率.客户机虚拟机屏幕分辨率大小.可接受值
1024x768, 1280x1024, 1600x1200, 1920x1200, 2560x1600, 3840x2160

3840x2160 仅适用于 Windows / Hyper-V Server 2016。

OS:监控.客户机虚拟机监控器数。可接受值
[1, 4] - Windows / Hyper-V Server 2012 R2 [1, 8] - Windows / Hyper-V Server 2016

os:vram.虚拟机虚拟机 VRAM 数量.仅在 Windows / Hyper-V Server 2016 上提供。可接受值:

64, 128, 256, 512, 1024

`instances_path_share = `

字符串值

实例路径共享

映射到 "instances_path" dir 的 Windows 共享的名称,由调整大小的功能用于将文件复制到目标主机。如果留空,则使用管理共享(隐藏网络共享),查找在本地使用相同的"instances_path"。

可能的值:

  • "":将使用管理共享(默认)。
  • Windows 共享的名称。

相关选项:

  • "instances_path": 此处这个选项为空时将使用的目录。

iscsi_initiator_list = []

列出值

用于建立 iSCSI 会话的 iSCSI 启动器列表。

如果未指定,Microsoft iSCSI 启动器服务将选择启动器。

limit_cpu_features = False

布尔值

限制 CPU 功能

需要此标志来支持实时迁移到具有不同 CPU 功能的主机,并在实例创建过程中检查,以限制实例使用的 CPU 功能。

mounted_disk_query_retry_count = 10

整数值

挂载的磁盘查询重试计数

重试检查挂载磁盘的次数。查询运行,直到找到设备或达到重试计数为止。

可能的值:

  • 正整数值。建议大于 1 的值(默认值:10)。

相关选项:

  • 使用 "mounted_disk_query_retry_interval" 选项声明磁盘挂载重试之间的时间间隔。

mounted_disk_query_retry_interval = 5

整数值

挂载的磁盘查询重试间隔

检查挂载的磁盘之间的间隔(以秒为单位)。

可能的值:

  • 时间(以秒为单位:5)。

相关选项:

  • 当 mount_disk_query_retry_count 大于 1 时,这个选项是有意义的。
  • 重试循环使用 mount_disk_query_retry_count 和 mounted_disk_query_retry_interval 配置选项运行。

power_state_check_timeframe = 60

整数值

电源状态检查时间线

要检查实例电源状态的时间线会改变。这个选项用于通过指定时间线中的 WMI 接口从 Hyper-V 获取实例状态。

可能的值:

  • 以秒为单位的时间线(默认值:60)。

power_state_event_polling_interval = 2

整数值

电源状态事件轮询间隔

实例电源状态更改事件轮询频率。将电源状态事件的监听程序间隔设置为给定值。这个选项增强了重启自身实例的内部生命周期通知。Operator 不太可能更改这个值。

可能的值:

  • 时间(以秒为单位):2。

qemu_img_cmd = qemu-img.exe

字符串值

qemu-img 命令

一些镜像相关操作需要 QEMU-img,如在不同镜像类型间转换。您可以从 http://qemu.weilnetz.de/ 获得它,或安装 Cloudbase OpenStack Hyper-V Compute Driver (https://cloudbase.it/openstack-hyperv-driver/),这会自动为这个设置选项设置正确的路径。您可以提供 qemu-img.exe 的完整路径,或者在 PATH 环境变量中设置其路径,并将此选项保留为默认值。

可能的值:

  • qemu-img 可执行文件的名称,如果它与 nova-compute 服务或者其路径位于同一个目录中,则其路径位于 PATH 环境变量(Default)中。
  • qemu-img 命令的路径(DRIVELETTER:\PATH\TO\QEMU-IMG\COMMAND)。

相关选项:

  • 如果 config_drive_cdrom 选项为 False,则 qemu-img 将用于将 ISO 转换为 VHD,否则配置驱动器将保留 ISO。要将配置驱动器与 Hyper-V 一起使用,您必须将 mkisofs_cmd 值设置为 mkisofs.exe 安装的完整路径。

use_multipath_io = False

布尔值

在附加 iSCSI 或 FC 磁盘时使用多路径连接。

这要求启用多路径 IO Windows 功能。MPIO 必须配置为声明此类设备。

volume_attach_retry_count = 10

整数值

卷附加重试计数

重试附加卷的次数。卷附加会被重试,直到达到成功或给定的重试计数为止。

可能的值:

  • 正整数值(默认值:10)。

相关选项:

  • 使用 volume_attach_retry_interval 选项声明附加尝试之间的时间间隔。

volume_attach_retry_interval = 5

整数值

卷附加重试间隔

卷附加尝试间隔(以秒为单位)。

可能的值:

  • 时间(以秒为单位:5)。

相关选项:

  • 当 volume_attach_retry_count 大于 1 时,这个选项是有意义的。
  • 重试循环使用 volume_attach_retry_count 和 volume_attach_retry_interval 配置选项运行。

vswitch_name = None

字符串值

外部虚拟交换机名称

Hyper-V 虚拟交换机是基于软件的层-2 以太网网络交换机,可在安装 Hyper-V 服务器角色时获得。交换机包括以编程方式管理和可扩展的功能,将虚拟机连接至虚拟网络和物理网络。另外,Hyper-V 虚拟交换机为安全、隔离和服务级别提供了策略强制。此配置选项所代表的 vSwitch 必须是外部(而非内部或专用)。

可能的值:

  • 如果没有提供,则使用可用 vswitches 列表的第一个。此列表使用 WQL 进行查询。
  • 虚拟交换机名称。

wait_soft_reboot_seconds = 60

整数值

等待软重启秒数

软重启请求后等待实例关闭的秒数。如果实例没有在此窗口中关闭,我们会回退到硬重启。

可能的值:

  • 时间(以秒为单位:60)。

9.1.22. image_cache

下表概述了 /etc/nova/nova.conf 文件中的 [image_cache] 组下可用的选项。

表 9.21. image_cache
配置选项 = 默认值类型描述

manager_interval = 2400

整数值

镜像缓存管理器运行之间等待的秒数。

请注意,在多个 nova-compute 服务中将共享存储用于 [DEFAULT]/instances_path 配置选项时,这个定期可能会处理大量实例。同样,使用管理集群(如 vmwareapi.VMwareVCDriver)的计算驱动程序可能会导致处理大量实例。因此,您可能需要调整预期负载的时间间隔,或者仅在共享存储聚合中的一个 nova-compute 服务中运行。其他备注,每次 image_cache_manager 运行 [DEFAULT]/instances_path 中镜像的时间戳时。

可能的值:

  • 0 :以默认间隔运行 60 秒(不推荐)
  • -1: disable
  • 任何其它值

相关选项:

  • [DEFAULT]/compute_driver
  • [DEFAULT]/instances_path

precache_concurrency = 1

整数值

并行触发镜像预缓存的最大计算主机数量。

发出镜像预缓存请求时,将联系计算节点以启动下载。这个数字限制了并行发生的那些数量。数值越高会导致更多计算并行工作,并可能导致时间缩短完成操作,但也可能会导致镜像服务的 DDoS。较低数字会导致更多顺序操作,镜像服务负载较低,但可能会完成较长的运行时。

remove_unused_base_images = True

布尔值

是否应该删除未使用的基础镜像?

当从此基础镜像创建或链接到的虚拟机监控程序中没有剩余的实例时,基础镜像被视为未使用。

remove_unused_original_minimum_age_seconds = 86400

整数值

未使用的未调整基础镜像比不会删除的未调整基础镜像。

remove_unused_resized_minimum_age_seconds = 3600

整数值

未使用的调整了大小不长的基础镜像,不会被删除。

subdirectory_name = _base

字符串值

缓存镜像的位置。

这不是完整路径 - 只是相对于 $instances_path 的文件夹名称。对于 per-compute-host 缓存的镜像,设置为 base$my_ip

9.1.23. ironic

下表概述了 /etc/nova/nova.conf 文件中的 [ironic] 组下可用的选项。

表 9.22. ironic
配置选项 = 默认值类型Description

api_max_retries = 60

整数值

请求冲突时要重试的次数。如果设置为 0,则只尝试一次,则不会重试。

相关选项:

  • api_retry_interval

api_retry_interval = 2

整数值

重试请求前等待的秒数。

相关选项:

  • api_max_retries

auth-url = None

字符串值

身份验证 URL

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

connect-retries = None

整数值

应该尝试连接错误的最大重试次数。

connect-retry-delay = None

浮点值

连接错误两次重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

domain-id = None

字符串值

域 ID 范围

domain-name = None

字符串值

域名范围为

endpoint-override = None

字符串值

始终使用此端点 URL 用于此客户端的请求。注意:应在此处指定未版本化的端点;若要请求特定的 API 版本,使用 version, min-version, 和/或 max-version 选项。

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

partition_key = None

字符串值

不区分大小写的键,将可由此服务管理的节点集合限制为 Ironic 中的一组节点,其具有匹配的 conductor_group 属性。如果未设置,则所有可用节点将有资格由此服务管理。请注意,将其设置为空字符串("")将匹配默认的编排器组,并且与保留选项未设置不同。

password = None

字符串值

用户密码

peer_list = []

列出值

使用这个 partition_key 配置值的所有 nova-compute 服务(包括此主机)的主机名列表。与 partition_key 值匹配的节点将在此处指定的所有服务之间分发。如果未设置 partition_key,则忽略这个选项。

project-domain-id = None

字符串值

包含项目的域 ID

project-domain-name = None

字符串值

包含项目的域名

project-id = None

字符串值

项目 ID 到范围

project-name = None

字符串值

项目名称到范围

region-name = None

字符串值

端点 URL 发现的默认 region_name。

serial_console_state_timeout = 10

整数值

等待节点串口控制台状态更改的超时(秒)。设置为 0 以禁用超时。

service-name = None

字符串值

用于端点 URL 发现的默认 service_name。

service-type = baremetal

字符串值

端点 URL 发现的默认 service_type。

split-loggers = False

布尔值

记录对多个日志记录器的请求。

status-code-retries = None

整数值

应该为可重试 HTTP 状态代码尝试的最大重试次数。

status-code-retry-delay = None

浮点值

可重试状态代码的两个重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

system-scope = None

字符串值

系统操作范围

timeout = None

整数值

http 请求的超时值

trust-id = None

字符串值

用作信任者使用的信任 ID

user-domain-id = None

字符串值

用户的域 ID

user-domain-name = None

字符串值

用户的域名

user-id = None

字符串值

用户 ID

username = None

字符串值

用户名

valid-interfaces = ['internal', 'public']

列出值

用于端点 URL 的接口列表(按首选顺序排列)。

9.1.24. key_manager

下表概述了 /etc/nova/nova.conf 文件中的 [key_manager] 组下可用的选项。

表 9.23. key_manager
配置选项 = 默认值类型Description

auth_type = None

字符串值

要创建的身份验证凭证类型。可能的值有 token密码keystone_tokenkeystone_password。如果没有将上下文传递给凭证工厂,则需要此项。

auth_url = None

字符串值

使用此端点连接到 Keystone。

backend = barbican

字符串值

指定密钥管理器实现。选项为 "barbican" 和 "vault"。默认为 "barbican"。将支持之前使用 [key_manager]/api_class 设置的值。

domain_id = None

字符串值

域范围的域 ID。keystone_tokenkeystone_password auth_type 的可选选项。

domain_name = None

字符串值

域范围的域名。keystone_tokenkeystone_password auth_type 的可选选项。

fixed_key = None

字符串值

修复了密钥管理器返回的密钥,在 hex 中指定。

可能的值:

  • 空字符串或十六进制值中的键

password = None

字符串值

用于身份验证的密码。passwordkeystone_password auth_type 是必需的。

project_domain_id = None

字符串值

项目的域 ID。keystone_tokenkeystone_password auth_type 的可选选项。

project_domain_name = None

字符串值

项目的域名。keystone_tokenkeystone_password auth_type 的可选选项。

project_id = None

字符串值

项目范围的项目 ID。keystone_tokenkeystone_password auth_type 的可选选项。

project_name = None

字符串值

项目范围的项目名称。keystone_tokenkeystone_password auth_type 的可选选项。

reauthenticate = True

布尔值

如果当前令牌即将过期,允许获取新令牌。keystone_tokenkeystone_password auth_type 的可选选项。

token = None

字符串值

用于身份验证的令牌。如果没有将上下文传递给凭证工厂,tokenkeystone_token auth_type 需要。

trust_id = None

字符串值

信任范围的信任 ID。keystone_tokenkeystone_password auth_type 的可选选项。

user_domain_id = None

字符串值

用于身份验证的用户域 ID。keystone_tokenkeystone_password auth_type 的可选选项。

user_domain_name = None

字符串值

用于身份验证的用户域名。keystone_tokenkeystone_password auth_type 的可选选项。

user_id = None

字符串值

用于身份验证的用户 ID。keystone_tokenkeystone_password auth_type 的可选选项。

username = None

字符串值

用于身份验证的用户名。密码 auth_type 是必需的。keystone_password auth_type 的可选选项。

9.1.25. keystone

下表概述了 /etc/nova/nova.conf 文件中的 [keystone] 组下可用的选项。

表 9.24. keystone
配置选项 = 默认值类型Description

auth-url = None

字符串值

身份验证 URL

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

connect-retries = None

整数值

应该尝试连接错误的最大重试次数。

connect-retry-delay = None

浮点值

连接错误两次重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

default-domain-id = None

字符串值

与 v3 和 v2 参数一起使用的可选域 ID。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

default-domain-name = None

字符串值

与 v3 API 和 v2 参数一起使用的可选域名。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

domain-id = None

字符串值

域 ID 范围

domain-name = None

字符串值

域名范围为

endpoint-override = None

字符串值

始终使用此端点 URL 用于此客户端的请求。注意:应在此处指定未版本化的端点;若要请求特定的 API 版本,使用 version, min-version, 和/或 max-version 选项。

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

password = None

字符串值

用户密码

project-domain-id = None

字符串值

包含项目的域 ID

project-domain-name = None

字符串值

包含项目的域名

project-id = None

字符串值

项目 ID 到范围

project-name = None

字符串值

项目名称到范围

region-name = None

字符串值

端点 URL 发现的默认 region_name。

service-name = None

字符串值

用于端点 URL 发现的默认 service_name。

service-type = identity

字符串值

端点 URL 发现的默认 service_type。

split-loggers = False

布尔值

记录对多个日志记录器的请求。

status-code-retries = None

整数值

应该为可重试 HTTP 状态代码尝试的最大重试次数。

status-code-retry-delay = None

浮点值

可重试状态代码的两个重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

system-scope = None

字符串值

系统操作范围

tenant-id = None

字符串值

租户 ID

tenant-name = None

字符串值

租户名称

timeout = None

整数值

http 请求的超时值

trust-id = None

字符串值

用作信任者使用的信任 ID

user-domain-id = None

字符串值

用户的域 ID

user-domain-name = None

字符串值

用户的域名

user-id = None

字符串值

用户 ID

username = None

字符串值

用户名

valid-interfaces = ['internal', 'public']

列出值

用于端点 URL 的接口列表(按首选顺序排列)。

9.1.26. keystone_authtoken

下表概述了 /etc/nova/nova.conf 文件中的 [keystone_authtoken] 组下可用的选项。

表 9.25. keystone_authtoken
配置选项 = 默认值类型Description

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

auth_uri = None

字符串值

完成"公共"身份 API 端点。此端点不应是一个 "admin" 端点,因为它应该可以被所有最终用户访问。未经身份验证的客户端重定向到此端点以进行身份验证。虽然此端点应该是未指定版本的,但通配符中的客户端支持会有所不同。如果您在此处使用版本化的 v2 端点,则不 应该与服务用户用来验证令牌的端点相同,因为普通的最终用户可能无法到达该端点。这个选项已弃用,使用 www_authenticate_uri,并将在 S 发行版本中删除。弃用自: Queens

*reason:* auth_uri 选项已弃用,使用 www_authenticate_uri,并将在 S 发行版本中删除。

auth_version = None

字符串值

Identity API 端点的 API 版本。

cache = None

字符串值

请求存储 Swift 缓存对象的环境密钥。当使用 Swift 缓存部署 auth_token 中间件时,请使用此选项使中间件与 swift 共享缓存后端。否则,改为使用 memcached_servers 选项。

cafile = None

字符串值

在验证 HTTP 连接时使用 PEM 编码的证书颁发机构。默认为系统 CA。

certfile = None

字符串值

如果身份服务器需要客户端证书,则需要此项

delay_auth_decision = False

布尔值

不要处理中间件中的授权请求,但将授权决定委派给下游 WSGI 组件。

enforce_token_bind = permissive

字符串值

用于控制令牌绑定的使用和类型。可以设置为:"disabled"不检查令牌绑定。如果绑定类型是针对服务器已知的形式,则"permissive" (默认)无法验证绑定信息,如果不是,则忽略它。如"permissive",但如果绑定类型未知,令牌将被拒绝。"必需"格式的任何令牌绑定格式是允许的。最后,令牌中必须存在的绑定方法的名称。

http_connect_timeout = None

整数值

请求超时值与 Identity API 服务器通信。

http_request_max_retries = 3

整数值

与身份 API 服务器通信时,我们尝试重新连接的次数。

include_service_catalog = True

布尔值

(可选)指示是否设置 X-Service-Catalog 标头。如果 False,中间件将不会要求在令牌验证时请求服务目录,也不会设置 X-Service-Catalog 标头。

insecure = False

布尔值

验证 HTTPS 连接。

interface = internal

字符串值

用于 Identity API 端点的接口。有效值为 "public", "internal" (默认)或 "admin"。

keyfile = None

字符串值

如果身份服务器需要客户端证书,则需要此项

memcache_pool_conn_get_timeout = 10

整数值

(可选)操作等待从池中获取 memcached 客户端连接的秒数。

memcache_pool_dead_retry = 300

整数值

(可选)在 memcached 服务器再次尝试前,memcached 服务器被视为死服务器的秒数。

memcache_pool_maxsize = 10

整数值

(可选)到每个 memcached 服务器的最大打开连接总数。

memcache_pool_socket_timeout = 3

整数值

(可选)与 memcached 服务器通信的套接字超时(以秒为单位)。

memcache_pool_unused_timeout = 60

整数值

(可选)在关闭到 memcached 前,与 memcached 的连接数的秒数。

memcache_secret_key = None

字符串值

(可选,如果定义了 memcache_security_strategy,则此字符串用于密钥派生。

memcache_security_strategy = None

字符串值

(可选)如果定义,指定令牌数据是否应该经过身份验证或经过身份验证并加密。如果 MAC,令牌数据在缓存中进行身份验证(使用 HMAC)。如果 ENCRYPT,令牌数据将在缓存中加密和验证。如果该值不是这些选项之一或为空,则 auth_token 会在初始化时引发异常。

memcache_use_advanced_pool = True

布尔值

(可选)使用 advanced (eventlet 安全) memcached 客户端池。

memcached_servers = None

列出值

(可选)指定要用于缓存的 memcached 服务器列表。如果未定义,令牌将会被缓存在进程中。

region_name = None

字符串值

找到身份服务器的区域。

service_token_roles = ['service']

列出值

需要出现在服务令牌中的角色。允许服务令牌请求可以使用已过期的令牌,因此此检查应严格控制仅应发送此令牌的实际服务。此处的角色被应用为 ANY 检查,因此此列表中的任何角色都必须存在。出于向后兼容的原因,目前仅影响 allow_expired 检查。

service_token_roles_required = False

布尔值

出于向后兼容的原因,我们必须使有效的服务令牌传递没有将 service_token_roles 检查传递给有效。在以后的发行版本中,设置此 true 将成为默认设置,并应启用。

service_type = None

字符串值

服务的名称或类型出现在服务目录中。这用于验证具有受限访问规则的令牌。

token_cache_time = 300

整数值

为了防止过度工作量验证令牌,中间件缓存之前在可配置的持续时间内(以秒为单位)中是以前的令牌。设置为 -1 以完全禁用缓存。

www_authenticate_uri = None

字符串值

完成"公共"身份 API 端点。此端点不应是一个 "admin" 端点,因为它应该可以被所有最终用户访问。未经身份验证的客户端重定向到此端点以进行身份验证。虽然此端点应该是未指定版本的,但通配符中的客户端支持会有所不同。如果您在此处使用版本化的 v2 端点,则不 应该与服务用户用来验证令牌的端点相同,因为普通的最终用户可能无法到达该端点。

9.1.27. libvirt

下表概述了 /etc/nova/nova.conf 文件中的 [libvirt] 组下可用的选项。

表 9.26. libvirt
配置选项 = 默认值类型Description

`connection_uri = `

字符串值

覆盖所选虚拟化类型的默认 libvirt URI。

如果设置,Nova 将使用此 URI 连接到 libvirt。

可能的值:

  • qemu:///system 等 URI。

    This is only necessary if the URI differs to the commonly known URIs
    for the chosen virtualization type.

相关选项:

  • virt_type :影响将什么用作默认值。

cpu_mode = None

字符串值

用于设置实例应具有的 CPU 模式。

如果 virt_type="kvm&verbar;qemu",则默认为 host-model,否则它将默认为 none

相关选项:

  • cpu_models :当 cpu_mode 设置为 custom 时,应只在设置。否则,会导致错误,实例启动将失败。

cpu_model_extra_flags = []

列出值

启用或禁用客户机 CPU 标记。

要显式启用或禁用 CPU 标记,请使用 +flag-flag - + 为客户及启用 CPU 标记,而 - 会禁用它。如果未指定 + 和,则会启用 标志,这是默认行为。例如,如果您指定以下内容(假设主机硬件和软件支持 CPU 模型和功能):

[libvirt]
cpu_mode = custom
cpu_models = Cascadelake-Server
cpu_model_extra_flags = -hle, -rtm, +ssbd, mtrr

Nova 将禁用 guest 的 hlertm 标志;它将启用 ssbdmttr (因为它使用 + 和前缀指定)。

CPU 标志不区分大小写。在以下示例中,客户机将禁用 pdpe1gb 标志;vmxpcid 标志将启用:

[libvirt]
cpu_mode = custom
cpu_models = Haswell-noTSX-IBRS
cpu_model_extra_flags = -PDPE1GB, +VMX, pcid

指定额外的 CPU 标志与 cpu_mode config 属性的所有三个可能值相结合: custom (这还要求通过 cpu_models config 属性指定显式 CPU 模型)、host-modelhost-passthrough

在某些情况下,您可能需要为 主机传递 CPU 模式配置额外的 CPU 标志,因为有时 QEMU 可能会禁用某些 CPU 功能。其中一个例子是 Intel 的"invtsc" (Invariable Time Stamp Counter) CPU 标记的 CPU 标记时,您需要将这个标志公开给 Nova 实例,您需要明确启用它。

cpu_model_extra_flags 的可能值取决于使用的 CPU 型号。对于给定 CPU 模型的可能 CPU 功能标记,请参阅 /usr/share/libvirt/cpu_map configured.xml

特定 CPU 标记的特殊备注: pc id (一个 Intel 处理器功能,因为应用 Meltdown CVE 修复而降低客户机性能下降)。使用自定义 CPU 模式配置此标志时,并非所有 CPU 型号(由 QEMU 和 libvirt 定义)需要它:

  • 包括 pcid 功能的唯一虚拟 CPU 型号是 Intel "Haswell"、"Broadwell" 和 "Skylake" 变体。
  • libvirt / QEMU CPU 型号 "Nehalem", "Westmere", "SandyBridge", 和 "IvyBridge" 默认不 会公开 pcid 功能,即使主机 CPU 相同名称包括它。i.e.在使用上述虚拟 CPU 模型时,需要明确指定 PCID

libvirt 驱动程序的默认 CPU 模式 host-model 将执行正确的操作,以处理客户机的 PCID CPU 标志,假设您正在运行更新的处理器 microcode、主机和客户机内核、libvirt 和 QEMU。 另一个模式 host-passthrough 检查硬件中是否有 PCID,如果将其直接传递给 Nova 客户机。因此,在使用 PCID 模式(host-modelhost-passthrough)的情况下,不需要使用 cpu_model_extra_flags

相关选项:

  • cpu_mode
  • cpu_models

cpu_models = []

列出值

主机支持的 CPU 模型列表。

预期列表是排序的,之前列出了更常见和不太高级 CPU 模型。下面是一个示例:SandyBridge ,IvyBridge,Haswell,Broad well,后者的 CPU 模型的功能更丰富的。

可能的值:

  • 可以通过 virsh cpu-models ARCH 找到命名的 CPU 型号,其中 ARCH 是您的主机架构。

相关选项:

  • cpu_mode :这只在您要配置(通过 cpu_models)特定命名 CPU 模型时设置为 custom。否则,会导致错误,实例启动将失败。
  • virt_type :只有虚拟化类型 kvmqemu 使用它。

    1. 注意:请小心,只指定可在硬件中完全支持的型号。

cpu_power_governor_high = performance

字符串值

使用 governor 来获得最佳 CPU 性能

cpu_power_governor_low = powersave

字符串值

使用 governor 减少 CPU 功耗

cpu_power_management = False

布尔值

使用 libvirt 管理 CPU 内核性能。

cpu_power_management_strategy = cpu_state

字符串值

调优策略,以便在未使用时减少 CPU 功耗

device_detach_attempts = 8

整数值

驱动程序尝试在 libvirt 中分离设备的最大尝试次数。

相关选项:

  • :oslo.config:option:libvirt.device_detach_timeout

device_detach_timeout = 20

整数值

在重新触发 detach 前,驱动程序等待成功或 libvirt 中的失败事件的最大秒数。

相关选项:

  • :oslo.config:option:libvirt.device_detach_attempts

disk_cachemodes = []

列出值

用于不同磁盘类型的特定缓存模式。

例如: file=directsync,block=none,network=writeback

对于本地或远程附加存储,建议您使用 writethrough (默认)模式,因为它确保了在客户机中运行的应用程序具有可接受的 I/O 性能,特别是对于读操作。但是,建议在远程 NFS 存储中使用缓存模式 none,因为直接 I/O 操作(O_DIRECT)性能优于同步 I/O 操作(使用 O_SYNC)。缓存模式 none 有效地将所有客户机 I/O 操作转换为主机上的直接 I/O 操作,这是此环境中的 NFS 客户端。

可能的缓存模式:

  • 默认:"取决具体情况" — 对于 Nova 管理的磁盘,none,如果主机文件系统符合 Linux 的 O_DIRECT 规格;否则为 writeback。对于卷驱动程序,默认决定于具体的驱动程序:除了 SMBFS 和 Virtuzzo (使用 writeback)外,都为 none
  • none :当缓存模式设置为 none 时,主机页面缓存被禁用,但客户机启用了磁盘写入缓存。在这个模式中,客户机中的写入性能是最佳,因为写入操作会绕过主机页面缓存,并直接进入磁盘写入缓存。如果磁盘写入缓存有电池支持,或者如果客户机传输数据中的应用程序或存储堆栈正确传输数据(通过 fsync 操作或文件系统障碍),则可以确保数据完整性。但是,由于主机页面缓存被禁用,客户机中的读取性能与启用了主机页面缓存的模式不同,如 writethrough 模式。可共享磁盘设备(如用于多附加块存储卷)将将其缓存模式设置为 none,而无论配置是什么。
  • Writethrough :当缓存设置为 writethrough 模式时,主机页面缓存会被启用,但客户机禁用了磁盘写入缓存。因此,这个缓存模式可确保数据完整性,即使客户机中的应用程序和存储堆栈无法正确将数据传送到持久性存储(通过 fsync 操作或文件系统障碍)。由于在这个模式下启用了主机页面缓存,因此在客户机中运行的应用程序的读取性能通常更好。但是,写入性能可能会降低,因为磁盘写入缓存被禁用。
  • writeback :当缓存设置为 writeback 模式时,会为客户机启用主机页面缓存和磁盘写入缓存。因此,在客户机中运行的应用程序的 I/O 性能良好,但数据在电源失败时不受保护。因此,只建议这个缓存模式用于潜在的数据丢失的临时数据。注意:Certain backend disk 机制可以提供安全回写缓存语义。专门用于绕过主机页面缓存,如 QEMU 的集成式 RBD 驱动程序。Ceph 文档建议将其设置为回写以获得最大性能,同时保持数据安全。
  • directsync: 与 "writethrough" 类似,但它绕过主机页面缓存。
  • insecure :不安全缓存模式完全忽略缓存传输操作。顾名思义,此缓存模式应仅用于数据丢失的临时数据。这个模式可用于加快客户机安装,但您应该在生产环境中切换到另一个缓存模式。

disk_prefix = None

字符串值

覆盖附加到实例的设备的默认磁盘前缀。

如果设置,这用于识别总线的可用磁盘空间名称。

可能的值:

  • 任何会导致有效的磁盘设备名称(如 sdahda )的前缀。只有设备名称与虚拟化类型的常用设备名称前缀不同时才需要,如 sd、xvd、uvd、uvd、vd。

相关选项:

  • virt_type :使用哪个设备类型,这决定了默认磁盘前缀。

enabled_perf_events = []

列出值

监控并收集统计信息的性能事件。

这将允许您指定事件列表来监控客户机的低级别性能,并通过 libvirt 驱动程序收集相关统计信息,后者使用 Linux 内核的 perf 基础架构。设置此 config 属性后,Nova 将生成 libvirt guest XML 以监控指定的事件。

例如,要监控 CPU 周期计数(total/elapsed)和缓存未命中计数,请按如下所示启用它们:

[libvirt]
enabled_perf_events = cpu_clock, cache_misses

可能的值:字符串列表。支持的事件列表可以找到 这里'__。请注意,Intel CMT 事件 - 'cmt, mbmbtmbml - 被最新的 Linux 内核版本(4.14+)不支持,nova 会忽略它。

__ https://libvirt.org/formatdomain.html#elementsPerf.

file_backed_memory = 0

整数值

可用容量(以 MiB 为单位)用于文件支持的内存。

设置为 0 以禁用文件支持的内存。

启用后,实例将在 /etc/libvirt/qemu.confmemory_backing_dir 选项中指定的目录中创建内存文件。默认位置为 /var/lib/libvirt/qemu/ram

启用后,为此选项定义的值将报告为节点内存容量。通过内核的 pagecache 机制,计算节点系统内存将用作文件支持内存的缓存。

  1. 备注:此功能与巨页不兼容。
  2. 注: 此功能与内存过量使用不兼容。

相关选项:

  • virt_type 必须设置为 kvmqemu
  • ram_allocation_ratio 必须设置为 1.0。

gid_maps = []

列出值

guid 目标和范围列表。Syntax 是 guest-gid:host-gid:count。允许最多 5 个。

hw_disk_discard = None

字符串值

nova 管理磁盘丢弃选项。

Requires:

  • Libvirt >= 1.0.6
  • QEMU >= 1.5 (原始格式)
  • QEMU >= 1.6 (qcow2 格式)

hw_machine_type = None

列出值

对于 qemu 或 KVM 客户机,将此选项设置为为每个主机架构指定默认机器类型。您可以通过检查 :command:virsh capabilities 命令的输出来查找环境中支持的机器类型列表。此配置选项的值格式为 host-arch=machine-type。例如: x86_64=machinetype1,armv7l=machinetype2

`images_rbd_ceph_conf = `

字符串值

要使用的 ceph 配置文件的路径

images_rbd_glance_copy_poll_interval = 15

整数值

要求 Glance 在要求将镜像复制到本地 rbd 存储后轮询 Glance 的时间间隔(以秒为单位)。这会影响到 Glance 报告复制完成的频率,因此应该非常短,我们应该很快发现,但并没有对 Glance 服务器产生不必要的负载。

相关选项:

  • images_type - 必须设置为 rbd
  • images_rbd_glance_store_name - 必须设置为存储名称

images_rbd_glance_copy_timeout = 600

整数值

我们等待 Glance 完成镜像复制到本地 rbd 存储的总最长时间。这应该足够长,允许将大型镜像复制到本地存储之间的网络链路上,以及镜像通常驻留的位置。设置这太长的缺点只是为了捕获镜像副本停止或继续进行太慢的情况。Glance 将报告实际错误,并根据轮询间隔进行通知。

相关选项:

  • images_type - 必须设置为 rbd
  • images_rbd_glance_store_name - 必须设置为存储名称
  • images_rbd_glance_copy_poll_interval - 控制失败时间

`images_rbd_glance_store_name = `

字符串值

代表此节点使用的 rbd 集群的 Glance 存储的名称。如果设置,这将允许 Nova 请求 Glance 将现有非本地存储中的镜像复制到此选项命名的镜像,以便维护适当的写时复制行为。

相关选项:

  • images_type - 必须设置为 rbd
  • images_rbd_glance_copy_poll_interval - 控制状态轮询频率
  • images_rbd_glance_copy_timeout - 控制整个复制超时

images_rbd_pool = rbd

字符串值

存储 rbd 卷的 RADOS 池

images_type = default

字符串值

VM 镜像格式.

如果指定了 default,则使用 use_cow_images 标志,而不是这个标志。

相关选项:

  • compute.use_cow_images
  • images_volume_group
  • [workarounds]/ensure_libvirt_rbd_instance_dir_cleanup
  • compute.force_raw_images

images_volume_group = None

字符串值

当指定 images_type=lvm 时,用于虚拟机镜像的 LVM 卷组

相关选项:

  • images_type

inject_key = False

布尔值

允许在引导时注入 SSH 密钥。

镜像中没有代理来执行此操作。如果主机上有 libguestfs,它将被使用。否则会使用 nbd。镜像的文件系统将被挂载和 SSH 密钥,在 REST API 调用中提供,作为 root 用户的 SSH 密钥注入,并附加到该用户的 authorized_keys。如有必要,将设置 SELinux 上下文。请注意,当实例从卷启动时,无法进行 注入。

此配置选项将启用直接修改实例磁盘,不会影响 cloud-init 可使用 config_drive 选项或元数据服务中的数据。

Linux 发行版客户机。

相关选项:

  • inject_partition :该选项将决定文件系统的发现和使用。它还可以完全禁用注入。

inject_partition = -2

整数值

决定如何选择文件系统来将数据注入到其中。

libguestfs 用于注入数据。如果 libguestfs 无法确定 root 分区(因为存在多个根分区,或者无法挂载文件系统),则会导致错误,实例无法引导。

可能的值:

  • -2 TOKEN 禁用数据注入。
  • -1 swig 找到使用 libguestfs 挂载的文件系统的根分区
  • 0 swig 镜像没有分区
  • >0 327 用于注入的分区数

Linux 发行版客户机。

相关选项:

  • inject_key :如果此选项允许注入 SSH 密钥,它依赖于值大于或等于 -1 用于 inject_partition
  • inject_password :如果此选项允许注入 admin 密码,它依赖于值大于或等于 -1 用于 inject_partition
  • [guestfs]/debug 您可以使用此配置选项启用 debug 日志级别 libguestfs。更详细的输出有助于调试问题。
  • virt_type :如果您使用 lxc 作为 virt_type,它将被视为单个分区镜像

inject_password = False

布尔值

仅允许在创建和重建过程中为实例注入管理员密码。

镜像中没有代理来执行此操作。如果主机上有 libguestfs,它将被使用。否则会使用 nbd。镜像的文件系统将被挂载,并且 admin 密码(在 REST API 调用中提供)将作为 root 用户的密码注入。如果没有 root 用户可用,则不会启动实例,并抛出错误。请注意,当实例从卷启动时,无法进行 注入。

Linux 发行版客户机。

可能的值:

  • true :允许注入。
  • false :不允许注入。任何通过 REST API 提供的管理员密码都将被静默忽略。

相关选项:

  • inject_partition :该选项将决定文件系统的发现和使用。它还可以完全禁用注入。

iscsi_iface = None

字符串值

需要用于连接到目标的 iSCSI 传输 iface,以防需要卸载支持。

默认格式为 < transport_name>.<hwaddress& gt;,其中 & lt;transport_name& gt; 是 (be2iscsi,bnx2i,cxgb3i,cxgb4i, cxgb4i ,qla4xxx,ocs,tcp)之一,其中 < hwaddress > 是接口的 MAC 地址,并可通过 iscsiadm -m iface 命令生成。不要将 iscsi_iface 参数与实际传输名称一起提供。

iser_use_multipath = False

布尔值

使用 iSER 卷的多路径连接。

iSER 卷可以作为多路径设备连接。这将提供高可用性和容错功能。

live_migration_bandwidth = 0

整数值

迁移期间要使用的最大带宽(以 MiB/s)。

如果设置为 0,则虚拟机监控程序将选择合适的默认值。有些 hypervisor 不支持此功能,如果带宽不是 0,将返回错误。详情请查看 libvirt 文档。

live_migration_completion_timeout = 800

整数值

迁移在中止操作前成功传输数据的时间(以秒为单位)。

值是要传输的每个 GiB 客户机 RAM + 磁盘,其绑定最少为 2 GiB。通常应大于停机时间延迟,以等待停机步骤。设置为 0 以禁用超时。

相关选项:

  • live_migration_downtime
  • live_migration_downtime_steps
  • live_migration_downtime_delay

live_migration_downtime = 500

整数值

Nova 将尝试在内存副本的最后一部分内暂停实例 (以毫秒为单位 )。

将向上舍入为最小 100ms。如果要允许实时迁移更快地完成,或者避免实时迁移超时错误,可以增加这个值。在实时迁移切换过程中,您可以增加这个值。如果在虚拟机暂停后传输速率出现任何减少,则可能会超过这个值。

相关选项:

  • live_migration_completion_timeout

live_migration_downtime_delay = 75

整数值

迁移停机时间的每个步骤之间等待的时间(以秒为单位)。

最小延迟为 3 秒。值是要传输的每个 GiB 客户机 RAM + 磁盘,每个设备至少为 2 GiB。

live_migration_downtime_steps = 10

整数值

达到最大停机时间值的增量步骤数。

将向上舍入为至少 3 个步骤。

live_migration_inbound_addr = None

主机域值

用作此主机的实时迁移地址的 IP 地址。

这个选项表示在迁移到此 hypervisor 时应用作实时迁移流量的目标的 IP 地址。然后,实时迁移流量的源使用此元数据来构建迁移 URI。

如果此选项设置为 None,则将使用迁移目标计算节点的主机名。

这个选项对于在实时迁移流量可能会显著影响 network plane 的环境中非常有用。实时迁移流量的一个单独的网络可以使用此配置选项,并避免对管理网络的影响。

live_migration_permit_auto_converge = False

布尔值

此选项允许 nova 使用自动聚合启动实时迁移。

如果正在进行实时迁移缓慢,则自动聚合 CPU 节流。只有在此标志被设置为 True 且因为正在使用的 libvirt 和 QEMU 版本不可用时,才会使用 autoverge。

相关选项:

  • live_migration_permit_post_copy

live_migration_permit_post_copy = False

布尔值

此选项允许 nova 将实时迁移切换到复制后模式,即,在迁移完成前将活动虚拟机切换到目标节点上的一个虚拟机,从而确保需要传输的内存上的上限。后复制需要 libvirt>=1.3.3 和 QEMU>=2.5.0。

允许后,如果达到 live_migration_completion_timeout 定义的超时,且 ,则 live_migration_timeout_action 设置为 force_complete,则 post-copy 模式将自动激活。请注意,如果您没有超时,或者选择使用 abort,即 live_migration_completion_timeout = 0, 则没有自动切换到 post-copy。

实时迁移强制完成 API 在允许后使用 post-copy。如果复制后模式不可用,则强制完成回退到暂停虚拟机,以确保实时迁移操作完成。

使用 post-copy 模式时,如果源和目标主机丢失网络连接,则需要重启实时迁移的虚拟机。如需了解更多详细信息,请参阅管理指南。

相关选项:

  • live_migration_permit_auto_converge
  • live_migration_timeout_action

live_migration_scheme = None

字符串值

实时迁移由实时迁移流量源使用的 URI 方案。

覆盖默认的 libvirt 实时迁移方案(这依赖于 virt_type)。如果此选项设置为 None,则 nova 将自动根据虚拟机监控程序选择适合的默认默认值。不建议您修改,除非您非常确定 hypervisor 支持特定方案。

相关选项:

  • virt_type :此选项仅在将 virt_type 设置为 kvmqemu 时才有意义。
  • live_migration_uri: 如果 live_migration_uri 值不是 None,则用于从 live_migration_uri 中进行实时迁移的方案。

live_migration_timeout_action = abort

字符串值

这个选项将用于确定在 live_migration_completion_timeout 过期后针对虚拟机执行的操作。默认情况下,实时迁移操作将在完成超时后中止。如果设置为 force_complete,则计算服务将暂停虚拟机或触发 Post-copy,具体取决于启用后复制(live_migration_permit_post_copy 被设为 True)。

相关选项:

  • live_migration_completion_timeout
  • live_migration_permit_post_copy

live_migration_tunnelled = False

布尔值

启用隧道迁移。

这个选项启用隧道迁移功能,其中迁移数据通过 libvirtd 连接传输。如果启用,我们使用 VIR_MIGRATE_TUNNELLED 迁移标志,以避免配置网络以允许直接管理程序到虚拟机监控程序通信。如果为 False,请使用原生传输。如果没有设置,Nova 将根据虚拟机监控程序中的原生加密支持来选择可行的默认默认值。启用此选项将一定会影响性能。

请注意,这个选项与块迁移的使用不兼容。

弃用自: 23.0.0

原因 :"隧道实时迁移"有两个固有的限制:它无法处理非共享存储设置中的磁盘实时迁移;并且其性能具有巨大的性能成本。这两个问题都由 ''live_migration_with_native_tls''(需要预先配置的 TLS 环境)解决,这是保护所有实时迁移流的建议方法。

live_migration_uri = None

字符串值

实时迁移目标 URI,供实时迁移流量的来源使用。

覆盖默认的 libvirt 实时迁移目标 URI (依赖于 virt_type)。任何包括的 "%s" 被替换为迁移目标主机名,如果设置了,则替换 live_migration_inbound_addr

如果此选项被设置为 None (默认值),Nova 将根据以下列表中的 4 支持的 virt_type 自动生成 live_migration_uri 值:

  • kvm: qemu+tcp://%s/system
  • qemu: qemu+tcp://%s/system
  • parallels: parallels+tcp://%s/system

相关选项:

  • live_migration_inbound_addr: 如果 live_migration_inbound_addr 值不是 None,并且 live_migration_tunnelled 为 False,将使用目标计算节点的 ip/hostname 地址而不是 live_migration_uri 作为作实时迁移的 uri。
  • live_migration_scheme :如果没有设置 live_migration_uri,则用于从 live_migration_scheme 进行实时迁移的方案。

弃用自:15.0.0

reason: live_migration_uri 已弃用,用于分别更改实时迁移方案和目标 URI: ''live_migration_scheme' 和 ''live_migration_inbound_addr' 的其他选项。

live_migration_with_native_tls = False

布尔值

在实时迁移时使用 QEMU 原生 TLS 加密。

此选项允许通过原生 TLS 传输迁移流(guest RAM 设备状态)和磁盘流,例如在 QEMU 中内置的 TLS 支持。

先决条件:在所有相关 Compute 节点上正确配置 TLS 环境。这意味着,证书颁发机构(CA)、服务器、客户端证书、其对应密钥及其文件权限已就位,并验证。

备注:

  • 要使迁移流和磁盘流加密(也称为"块迁移"),live_migration_with_native_tls 是首选的配置属性,而不是 live_migration_tunnelled
  • 因为两个主要原因,live_migration_tunnelled 将被弃用:(a)它会产生巨大的性能损失;(b)它与块迁移不兼容。因此,如果您的计算节点至少具有 libvirt 4.4.0 和 QEMU 2.11.0,则强烈建议您使用 live_migration_with_native_tls
  • live_migration_tunnelledlive_migration_with_native_tls 不应同时使用。
  • live_migration_tunnelled 不同,live_migration_with_native_tls 与块迁移兼容。也就是说,使用此选项 NBD 流,通过哪个磁盘迁移到目标主机。

相关选项:

live_migration_tunnelled :此通过 libvirtd 传输迁移流(而不是磁盘流)。

max_queues = None

整数值

创建多队列客户端时可启用的最大 virtio 队列对数。分配的 virtio 队列数量将减少客户机所请求的 CPU 以及定义的最大值。默认情况下,这个值被设置为 none,这意味着会根据报告的内核主版本使用旧的限制。

mem_stats_period_seconds = 10

整数值

内存用量统计周期的秒数。零或负值意味着禁用内存用量统计。

nfs_mount_options = None

字符串值

传递给 NFS 客户端的挂载选项。详情请查看 nfs man page 的 部分。

挂载选项控制挂载文件系统的方式,以及访问此挂载点上的文件时 NFS 客户端的行为方式。

可能的值:

  • 代表以逗号分开的挂载选项的任何字符串。
  • 示例字符串: vers=3,lookupcache=pos

nfs_mount_point_base = $state_path/mnt

字符串值

将 NFS 卷挂载到计算节点上的目录。默认为安装 nova 的 Python 模块的位置的 mnt 目录。

NFS 为 OpenStack 块存储服务提供共享存储。

可能的值:

  • 代表挂载点的绝对路径的字符串。

num_aoe_discover_tries = 3

整数值

重新发现 AoE 目标来查找卷的次数。

Nova 支持通过 AOE (以太网上的ATA)附加到主机。这个选项允许用户指定可用于发现 AoE 设备的最大重试尝试次数。

num_iser_scan_tries = 5

整数值

扫描 iSER 目标来查找卷的次数。

iSER 是一个服务器网络协议,扩展 iSCSI 协议以使用远程直接内存访问(RDMA)。这个选项允许用户指定查找 iSER 卷的最大扫描尝试次数。

num_memory_encrypted_guests = None

整数值

具有加密内存的最大客户机数量,可在此计算主机上运行。

现在,这只与支持 SEV (安全加密虚拟化)的 AMD 机器相关。此类机器在其内存控制器中具有有限数量的插槽来存储加密密钥。每个运行带有加密内存的客户机都将消耗其中一个插槽。

未来可能会将选项用于其他同等技术。如果计算机不支持内存加密,则忽略 选项,并且清单将设置为 0。

如果机器确实支持内存加密,则现在为 None 表示有效的无限制清单,即 Nova 不会对可启动的 SEV 客户机数量实施任何限制,即使底层硬件将强制实施自己的限制。但是,预计将来会从硬件中自动检测清单,此时 None 将导致自动检测自动实施正确的限制。

  1. note::

    It is recommended to read :ref:`the deployment documentation's
    section on this option <num_memory_encrypted_guests>` before
    deciding whether to configure this setting or leave it at the
    default.

相关选项:

  • :oslo.config:option:libvirt.virt_type 必须设置为 kvm
  • 建议您在 :oslo.config:option:libvirt.hw_machine_type; :ref: deploy-sev-enabled-infrastructure 中包含 x86_64=q35

num_nvme_discover_tries = 5

整数值

重新发现 NVMe 目标以查找卷的次数

Nova 支持通过 NVMe 附加到主机(Non-Volatile Memory Express)。这个选项允许用户指定可用于发现 NVMe 设备的最大重试尝试次数。

num_pcie_ports = 0

整数值

实例将获取的 PCIe 端口数量。

libvirt 允许一个目标实例的自定义 PCIe 端口(pcie-root-port 控制器)。其中一些将默认使用,其余则可用于热插拔。

默认情况下,我们只有 1-2 个可用端口来限制热插拔。

更多信息: https://github.com/qemu/qemu/blob/master/docs/pcie.txt

由于 aarch64/virt 最大值的 QEMU 限制设置为 28

默认值 0 将计算端口数量移到 libvirt。

num_volume_scan_tries = 5

整数值

扫描给定存储协议来查找卷的次数。

pmem_namespaces = []

列出值

配置持久内存(pmem)命名空间。

这些命名空间必须已在主机上创建。此配置选项采用以下格式:

"$LABEL:$NSNAME[&verbar;$NSNAME][,$LABEL:$NSNAME[&verbar;$NSNAME]]"
  • $NSNAME 是 pmem 命名空间的名称。
  • $LABEL 代表一个资源类,它用于生成资源类名称,作为 CUSTOM_PMEM_NAMESPACE_$LABEL

    例如:
    [libvirt] pmem_namespaces=128G:ns0|ns1|ns2|ns3,262144MB:ns4|ns5,MEDIUM:ns6|ns7

quobyte_client_cfg = None

字符串值

到 Quobyte 客户端配置文件的路径。

quobyte_mount_point_base = $state_path/mnt

字符串值

计算节点上挂载 Quobyte 卷的目录。

Nova 支持 Quobyte 卷驱动程序,它允许在 Quobyte 存储后端上存储块存储服务卷。此 Option 指定挂载 Quobyte 卷的目录的路径。

可能的值:

  • 代表挂载点的绝对路径的字符串。

rbd_connect_timeout = 5

整数值

在最初连接到集群时,RADOS 客户端超时(以秒为单位)。

rbd_destroy_volume_retries = 12

整数值

销毁 RBD 卷的重试次数。

相关选项:

  • [libvirt]/images_type = rbd

rbd_destroy_volume_retry_interval = 5

整数值

每次连续重试之间等待的秒数,以销毁 RBD 卷。

相关选项:

  • [libvirt]/images_type = rbd

rbd_secret_uuid = None

字符串值

rbd_user 卷的机密的 libvirt UUID。

rbd_user = None

字符串值

用于访问 rbd (RADOS 块设备)卷的 RADOS 客户端名称。

在连接并使用 Ceph RBD 服务器进行身份验证时,libvirt 将引用此用户。

realtime_scheduler_priority = 1

整数值

在客户机的实时主机上下文 vCPU 中,将在该调度优先级中运行。优先级取决于主机内核(通常为 1-99)

remote_filesystem_transport = ssh

字符串值

libvirt 远程文件操作的传输方法。

因为 libvirt 无法使用 RPC 通过网络将文件复制到其他计算节点,所以必须使用其他方法:

  • 在远程主机上创建目录
  • 在远程主机上创建文件
  • 从远程主机中删除文件
  • 将文件复制到远程主机

rescue_image_id = None

字符串值

从中引导的镜像的 ID,以便从损坏的实例救援数据。

如果 rescue REST API 操作不提供要使用的镜像的 ID,则会使用此 ID 引用的镜像。如果没有设置这个选项,则使用实例中的镜像。

可能的值:

  • 镜像 ID 或无任何内容。如果它指向 Amazon Machine Image (AMI),请考虑设置配置选项 rescue_kernel_idrescue_ramdisk_id。如果没有设置任何设置,则使用实例的镜像。

相关选项:

  • rescue_kernel_id :如果所选的救援镜像允许单独定义其内核磁盘,则使用此选项的值(如果指定)。当 Amazon 的 AMI/AKI/ARI 镜像格式用于救援镜像时,会出现这种情况。
  • rescue_ramdisk_id :如果所选的救援镜像允许单独定义其 RAM 磁盘,则使用此选项的值(如果指定)。当 Amazon 的 AMI/AKI/ARI 镜像格式用于救援镜像时,会出现这种情况。

rescue_kernel_id = None

字符串值

与救援镜像一起使用的内核(AKI)镜像的 ID。

如果所选的救援镜像允许独立定义其内核磁盘,则使用这个选项的值(如果指定)。当 Amazon 的 AMI/AKI/ARI 镜像格式用于救援镜像时,会出现这种情况。

可能的值:

  • 内核镜像的 ID 或无任何内容。如果未指定任何内容,则使用实例的内核磁盘(如果其启动)。

相关选项:

  • rescue_image_id :如果该选项指向 Amazon 的 AMI/AKI/ARI 镜像格式中的镜像,则使用 rescue_kernel_id 也很有用。

rescue_ramdisk_id = None

字符串值

用于救援镜像的 RAM 磁盘(ARI)镜像的 ID。

如果所选的救援镜像允许单独定义其 RAM 磁盘,则使用此选项的值(如果指定)。当 Amazon 的 AMI/AKI/ARI 镜像格式用于救援镜像时,会出现这种情况。

可能的值:

  • RAM 磁盘镜像或无任何内容的 ID。如果未指定任何内容,则使用实例的 RAM 磁盘(如果实例启动)。

相关选项:

  • rescue_image_id :如果该选项指向 Amazon 的 AMI/AKI/ARI 镜像格式中的镜像,则使用 rescue_ramdisk_id 也很有用。

rng_dev_path = /dev/urandom

字符串值

用作主机上熵源的 RNG (随机数字生成器)设备的路径。从 libvirt 1.3.4 开始,所有路径(在读取时返回随机数字)都被接受。推荐的熵源是 /dev/urandom HEKETI-wagonit 是非阻止的,因此相对快,并避免了 /dev/random 的限制,它是一个旧的接口。如需了解更多详细信息(以及不同 RNG 源之间的比较),请参阅 Linux 内核 API 文档中的"用法"部分 [u]random:http://man7.org/linux/man-pages/man4/urandom.4.htmlhttp://man7.org/linux/man-pages/man7/random.7.html

rx_queue_size = None

整数值

配置 virtio rx 队列大小。

这个选项仅适用于带有 vhost 和 vhost-user 后端的 virtio-net 设备。仅适用于 QEMU/KVM。需要 libvirt v2.3 QEMU v2.7。

`smbfs_mount_options = `

字符串值

传递给 SMBFS 客户端的挂载选项。

提供 SMBFS 选项作为包含所有参数的单个字符串。详情请查看 mount.cifs man page。请注意,必须指定 libvirt-qemu uidgid

smbfs_mount_point_base = $state_path/mnt

字符串值

将 SMBFS 共享挂载到计算节点上的目录。

snapshot_compression = False

布尔值

qcow2 镜像启用快照压缩。

注意:您可以将 snapshot_image_format 设置为 qcow2,以强制所有快照采用 qcow2 格式,独立于其原始镜像类型。

相关选项:

  • snapshot_image_format

snapshot_image_format = None

字符串值

确定发送到镜像服务时的快照镜像格式。

如果设置,这决定了将快照发送到镜像服务时使用的格式。如果没有设置,则默认为与源镜像相同的类型。

snapshots_directory = $instances_path/snapshots

字符串值

将快照上传到镜像服务前,libvirt 驱动程序将存储快照的位置

sparse_logical_volumes = False

布尔值

如果此标志设为 True,则创建稀疏逻辑卷(带有 virtualsize)。

弃用自:18.0.0

reason: 稀疏逻辑卷是一个没有测试的功能,因此不支持。默认情况下,LVM 逻辑卷是预分配的。如果要精简配置,请使用 Cinder 精简配置的卷。

swtpm_enabled = False

布尔值

在客户机中启用模拟 TPM (受信任的平台模块)。

swtpm_group = tss

字符串值

运行 swtpm 二进制文件的组。

使用模拟 TPM 时,swt pm 二进制文件将运行来模拟 TPM 设备。此二进制运行的用户取决于 libvirt 配置,而 tss 为默认值。

为了支持冷迁移和调整大小,nova 需要知道运行 swtpm 二进制文件的组,以确保文件在节点间移动后获得正确的所有权。

相关选项:

  • 还必须设置 swtpm_user

swtpm_user = tss

字符串值

运行 swtpm 二进制文件的用户。

使用模拟 TPM 时,swt pm 二进制文件将运行来模拟 TPM 设备。此二进制运行的用户取决于 libvirt 配置,而 tss 为默认值。

为了支持冷迁移和调整大小,nova 需要知道哪个用户正在运行 swtpm 二进制文件,以确保文件在节点间移动后获得正确的所有权。

相关选项:

  • 还必须设置 swtpm_group

sysinfo_serial = unique

字符串值

用于填充虚拟 BIOS 中客户机的主机"serial" UUID 的数据源。除 唯一 外的所有选择都将在将实例迁移到另一个主机时更改串行。更改此选项的选择还将影响此主机上的现有实例,一旦停止并重新启动。建议使用默认选择(唯一),因为迁移实例时不会改变。但是,除了按实例序列号外,如果您还需要对每个主机的序列号进行,请考虑通过主机聚合限制类别。

tx_queue_size = None

整数值

配置 virtio tx 队列大小。

这个选项仅适用于带有 vhost-user 后端的 virtio-net 设备。仅适用于 QEMU/KVM。需要 libvirt v3.7 QEMU v2.10。

uid_maps = []

列出值

uid 目标和范围列表。Syntax 是 guest-uid:host-uid:count。允许最多 5 个。

use_virtio_for_bridges = True

布尔值

使用 virtio 进行带有 KVM/QEMU 的网桥接口

virt_type = kvm

字符串值

描述应使用虚拟化类型(或称为域类型)libvirt。

此类型的选择必须与您为该主机选择的底层虚拟化策略匹配。

相关选项:

  • connection_uri: 取决于这一点
  • disk_prefix :取决于这个
  • cpu_mode: 取决于这一点
  • cpu_models: 取决于这一点

volume_clear = zero

字符串值

用于在删除临时磁盘时擦除临时磁盘的方法。只有在 LVM 被设置为后备存储时,才会生效。

相关选项:

  • images_type - must be set to lvm
  • volume_clear_size

volume_clear_size = 0

整数值

MiB 中的区域大小(从分配的卷的开头计算)将使用 volume_clear 选项中设置的方法清除。

可能的值:

  • 0 - 清除整个卷
  • >0 - 清除指定数量的 MiB

相关选项:

  • images_type - must be set to lvm
  • volume_clear - 必须设置,值不是 none 时才能使此选项产生实际影响

volume_use_multipath = False

布尔值

使用 iSCSI 或 FC 卷的多路径连接

卷可以在 LibVirt 中作为多路径设备连接。这将提供高可用性和容错功能。

vzstorage_cache_path = None

字符串值

SSD 缓存文件的路径。

您可以将 SSD 驱动器附加到客户端,并将驱动器配置为存储常用数据的本地缓存。通过在客户端的 SSD 驱动器上具有本地缓存,您可以在最多 10 次内增加集群性能。警告!有许多 SSD 模型不是服务器评级,并可给电源丢失而松散的数据集。此类 SSD 不应在 Vstorage 中使用,且处于危险状态,因为可能会导致数据崩溃和不一致。请参考哪些 SSD 模型的手动可以安全地保护,或使用 vstorage-hwflush-check (1)工具进行验证。

此选项定义应包含 "%(cluster_name) " 模板的路径,以将缓存与多个共享分开。

相关选项:

  • vzstorage_mount_opts 可能包含更详细的缓存选项。

vzstorage_log_path = /var/log/vstorage/%(cluster_name)s/nova.log.gz

字符串值

vzstorage 客户端日志的路径。

此选项定义集群操作的日志,它应包含 "%(cluster_name) " 模板来将日志与多个共享分开。

相关选项:

  • vzstorage_mount_opts 可能包含更详细的日志记录选项。

vzstorage_mount_group = qemu

字符串值

挂载所有者组名称。

此选项定义 Vzstorage 集群挂载点的所有者组。

相关选项:

  • vzstorage_mount 大参数组

vzstorage_mount_opts = []

列出值

pstorage-mount 的额外挂载选项

有关它们的完整描述,请参阅 https://static.openvz.org/vz-man/man1/pstorage-mount.1.gz.html 格式是参数列表的 python 字符串表示,例如:"[-v,-R,500]" Shouldn't include -c, -l, -C, -u, -g, -m as those有显式 vzstoragewhitelist 选项。

相关选项:

  • 所有其他 vzstorage vmcore 选项

vzstorage_mount_perms = 0770

字符串值

挂载访问模式。

此选项定义 Vzstorage 集群挂载点的访问位,其格式类似于 chmod (1)实用程序之一,如下所示:0770。它由一到四个数字组成,范围从 0 到 7,如果缺少前面的位则代表这些位为 0。

相关选项:

  • vzstorage_mount 大参数组

vzstorage_mount_point_base = $state_path/mnt

字符串值

在计算节点上挂载 Virtuozzo Storage 集群的目录。

此选项为 Vzstorage 集群定义非标准挂载点。

相关选项:

  • vzstorage_mount 大参数组

vzstorage_mount_user = stack

字符串值

挂载所有者用户名。

此选项定义 Vzstorage 集群挂载点的所有者用户。

相关选项:

  • vzstorage_mount 大参数组

wait_soft_reboot_seconds = 120

整数值

软重启请求后等待实例关闭的秒数。如果实例没有在此窗口中关闭,我们会回退到硬重启。

9.1.28. metrics

下表概述了 /etc/nova/nova.conf 文件中的 [metrics] 组下可用的选项。

表 9.27. metrics
配置选项 = 默认值类型Description

必需 = True

布尔值

是否需要指标。

此设置决定了如何处理任何不可用的指标。如果此选项设为 True,则指标不可用的任何主机都会引发异常,因此建议您使用 MetricFilter 在 weighing 前过滤那些主机。

可能的值:

  • 布尔值,其中 False 可确保主机不可用的任何指标都将主机权重设置为 [metrics] weight_of_unavailable

相关选项:

  • [metrics] weight_of_unavailable

weight_multiplier = 1.0

浮点值

基于报告的指标权衡主机的倍数。

当使用指标来加权主机的适用性时,您可以使用此选项更改计算的权重如何影响分配给主机的权重,如下所示:

  • >1.0: 增加指标对整个权重的影响
  • 1.0 :不更改计算的权重
  • >0.0,<1.0: 减少指标对整个权重的影响
  • 0.0: 指标值将被忽略,并返回 [metrics] weight_of_unavailable 选项的值
  • >-1.0,<0.0: effect is reduced and reversed
  • -1.0: effect is reversed
  • <-1.0: 效果会按比例增大并相反

可能的值:

  • 整数或浮点值,其中值对应于此 weigher 的倍数比率。

相关选项:

  • [filter_scheduler] weight_classes
  • [metrics] weight_of_unavailable

weight_of_unavailable = -10000.0

浮点值

不可用指标的默认权重。

当满足以下条件时,将使用这个值来代替任何实际指标值:

  • 主机无法使用 [metrics] weight_setting 中命名的指标,并且 所需的值False
  • [metrics] weight_setting 中为指标指定的比率为 0。
  • [metrics] weight_multiplier 选项设为 0。

可能的值:

  • 整数或浮点值,其中值对应于此 weigher 的倍数比率。

相关选项:

  • [metrics] weight_setting
  • [metrics] 必需
  • [metrics] weight_multiplier

weight_setting = []

列出值

指标映射到权重修饰符。

此设置指定要权衡的指标以及每个指标的相对比例。这应该是一个字符串值,由由由一个或多个 name=ratio 对组成的序列组成,用逗号分开,其中 name 是要 weighed 的指标名称,而 ratio 是该指标的相对权重。

请注意,如果比率设定为 0,则指标值将被忽略,而 weight 将设置为 [metrics] weight_of_unavailable 选项的值。

例如,让我们考虑将此选项设置为以下情况:

`name1=1.0, name2=-1.3`

最终的权重为:

`(name1.value * 1.0) + (name2.value * -1.3)`

可能的值:

  • 零个或更多键/值对列表,用逗号分开,其中键是代表指标名称的字符串,值是该指标的数字权重。如果值为 0,则忽略该值,权重将设置为 [metrics] weight_of_unavailable 选项的值。

相关选项:

  • [metrics] weight_of_unavailable

9.1.29. mks

下表概述了 /etc/nova/nova.conf 文件中的 [mks] 组下可用的选项。

表 9.28. mks
配置选项 = 默认值类型Description

enabled = False

布尔值

为虚拟机启用图形控制台访问。

mksproxy_base_url = http://127.0.0.1:6090/

URI 值

MKS Web 控制台代理的位置

响应中的 URL 指向一个 WebMKS 代理,该代理在客户端和实例运行的对应 vCenter 服务器之间启动代理。要使用基于 Web 的控制台访问,应该安装并配置 WebMKS 代理

可能的值:

  • 必须是表单的有效 URL:http://host:port/https://host:port/

9.1.30. neutron

下表概述了 /etc/nova/nova.conf 文件中的 [neutron] 组下可用的选项。

表 9.29. neutron
配置选项 = 默认值类型Description

auth-url = None

字符串值

身份验证 URL

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

connect-retries = None

整数值

应该尝试连接错误的最大重试次数。

connect-retry-delay = None

浮点值

连接错误两次重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

default-domain-id = None

字符串值

与 v3 和 v2 参数一起使用的可选域 ID。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

default-domain-name = None

字符串值

与 v3 API 和 v2 参数一起使用的可选域名。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

default_floating_pool = nova

字符串值

浮动 IP 池的默认名称。

指定用于分配浮动 IP 的浮动 IP 池的名称。只有在 Neutron 没有在端口绑定响应中指定浮动 IP 池名称时,才使用这个选项。

domain-id = None

字符串值

域 ID 范围

domain-name = None

字符串值

域名范围为

endpoint-override = None

字符串值

始终使用此端点 URL 用于此客户端的请求。注意:应在此处指定未版本化的端点;若要请求特定的 API 版本,使用 version, min-version, 和/或 max-version 选项。

extension_sync_interval = 600

整数值

整数值,代表在查询 Neutron 进行扩展前要等待的秒数。下一次 Nova 需要在 Neutron 中创建资源时的秒数,它将重新查询 Neutron 以获取已加载的扩展。将值设为 0 将刷新没有等待的扩展。

http_retries = 3

整数值

neutronclient 应该在任何失败的 http 调用上重试的次数。

0 表示只尝试连接一次。把它设置为任何正整数意味着,在失败连接时会重试,例如,将多次设置为 3,表示连接的总尝试为 4。

可能的值:

  • 任何整数值。0 表示只尝试连接一次

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

`metadata_proxy_shared_secret = `

字符串值

此选项包含用于验证对 Neutron 元数据请求的代理请求的共享机密字符串。要使用,必须在请求中提供 X-Metadata-Provider-Signature 标头。

相关选项:

  • service_metadata_proxy

ovs_bridge = br-int

字符串值

Open vSwitch 集成网桥的默认名称。

指定 OpenvSwitch 使用的集成网桥接口的名称。只有在 Neutron 没有在端口绑定响应中指定 OVS 网桥名称时才使用这个选项。

password = None

字符串值

用户密码

physnets = []

列出值

此主机上存在的 physnets 列表。

对于列出的每个 physnet,另一个部分 [neutron_physnet_$PHYSNET] 将添加到配置文件中。每个部分都必须配置单个配置选项 numa_nodes,它应该是与这个 physnet 相关联的所有 NUMA 节点的节点 ID 列表。例如:

[neutron]
physnets = foo, bar
[neutron_physnet_foo]
numa_nodes = 0
[neutron_physnet_bar]
numa_nodes = 0,1

任何没有使用此选项列出的 physnet 都被视为没有特定的 NUMA 节点关联性。

Tunnelled 网络(VXLAN, GRE, …​)无法以这种方式考虑,而是使用 [neutron_tunnel] 组进行配置。例如:

[neutron_tunnel]
numa_nodes = 1

相关选项:

  • [neutron_tunnel] numa_nodes 可用于为所有隧道网络配置 NUMA 关联性
  • [neutron_physnet_$PHYSNET] numa_nodes 需要为由这个选项指定的每个 $PHYSNET 值进度设置

project-domain-id = None

字符串值

包含项目的域 ID

project-domain-name = None

字符串值

包含项目的域名

project-id = None

字符串值

项目 ID 到范围

project-name = None

字符串值

项目名称到范围

region-name = None

字符串值

端点 URL 发现的默认 region_name。

service-name = None

字符串值

用于端点 URL 发现的默认 service_name。

service-type = network

字符串值

端点 URL 发现的默认 service_type。

service_metadata_proxy = False

布尔值

当设置为 True 时,此选项表示 Neutron 将用于代理元数据请求并解析实例 ID。否则,实例 ID 必须传递给 X-Instance-ID 标头中的元数据请求。

相关选项:

  • metadata_proxy_shared_secret

split-loggers = False

布尔值

记录对多个日志记录器的请求。

status-code-retries = None

整数值

应该为可重试 HTTP 状态代码尝试的最大重试次数。

status-code-retry-delay = None

浮点值

可重试状态代码的两个重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

system-scope = None

字符串值

系统操作范围

tenant-id = None

字符串值

租户 ID

tenant-name = None

字符串值

租户名称

timeout = None

整数值

http 请求的超时值

trust-id = None

字符串值

用作信任者使用的信任 ID

user-domain-id = None

字符串值

用户的域 ID

user-domain-name = None

字符串值

用户的域名

user-id = None

字符串值

用户 ID

username = None

字符串值

用户名

valid-interfaces = ['internal', 'public']

列出值

用于端点 URL 的接口列表(按首选顺序排列)。

9.1.31. notifications

下表概述了 /etc/nova/nova.conf 文件中的 [notifications] 组下可用的选项。

表 9.30. notifications
配置选项 = 默认值类型Description

bdms_in_notifications = False

布尔值

如果启用,请在版本的通知有效负载中包含块设备信息。默认情况下,发送块设备信息会被默认禁用,因为信息可能会发生系统的一些开销,因为这些信息可能需要从数据库加载。

default_level = INFO

字符串值

传出通知的默认通知级别。

notification_format = unversioned

字符串值

指定 nova 应发出哪些通知格式。

版本化的通知接口是带有旧接口的功能奇偶校验,且版本化的界面被积极开发,因此新的用户应使用版本化的接口。

但是,ceilometer 和其他成熟的 OpenStack 组件会大量使用旧接口,使其保持默认设置。

请注意,可以通过在 [oslo_messaging_notifications] 组中设置 driver=noop 来完全禁用通知。

版本通知列表在 https://docs.openstack.org/nova/latest/reference/notifications.html中可见

notify_on_state_change = None

字符串值

如果设置,在实例状态上发送 compute.instance.update 通知。

有关通知的详情,请参考 https://docs.openstack.org/nova/latest/reference/notifications.html

versioned_notifications_topics = ['versioned_notifications']

列出值

指定 nova 发布的版本化通知的主题。

对于大多数部署来说,默认值是正常的,很少需要更改。但是,如果您有一个使用版本通知的第三方服务,这可能值得获得该服务的主题。Nova 将向此列表中的每个主题队列发送包含版本通知有效负载的消息。

版本通知列表在 https://docs.openstack.org/nova/latest/reference/notifications.html中可见

9.1.32. oslo_concurrency

下表概述了 /etc/nova/nova.conf 文件中的 [oslo_concurrency] 组下可用的选项。

表 9.31. oslo_concurrency
配置选项 = 默认值类型Description

disable_process_locking = False

布尔值

启用或禁用进程间的锁定。

lock_path = None

字符串值

用于锁定文件的目录。为安全起见,指定的目录应该只对运行需要锁定的进程的用户写入。默认为环境变量 OSLO_LOCK_PATH。如果使用外部锁定,则必须设置锁定路径。

9.1.33. oslo_messaging_amqp

下表概述了 /etc/nova/nova.conf 文件中的 [oslo_messaging_amqp] 组下可用的选项。

表 9.32. oslo_messaging_amqp
配置选项 = 默认值类型Description

addressing_mode = dynamic

字符串值

表示驱动程序使用的寻址模式。允许的值: legacy - 使用旧的不可路由寻址;routable - 使用可路由地址;dynamic - 如果消息总线不支持路由,使用 legacy,如果支持,使用 routable。

anycast_address = anycast

字符串值

在发送到一组消费者时,附加到地址前缀中。由消息总线使用来识别应以轮循方式传送的消息。

broadcast_prefix = broadcast

字符串值

广播到所有服务器时使用的地址前缀

connection_retry_backoff = 2

整数值

在每次失败故障转移尝试失败后,增加 connection_retry_interval。

connection_retry_interval = 1

整数值

在尝试重新连接前需要暂停的秒数。

connection_retry_interval_max = 30

整数值

connection_retry_interval + connection_retry_backoff 的最大限制

container_name = None

字符串值

AMQP 容器的名称。必须全局唯一。默认为生成的 UUID

default_notification_exchange = None

字符串值

通知地址中使用的交换名称。Exchange name resolution priority: Target.exchange if set else default_notification_exchange if set else control_exchange if set else notify

default_notify_timeout = 30

整数值

发送通知消息发送的截止时间。仅在调用者不提供超时到期时使用。

default_reply_retry = 0

整数值

因可恢复错误而重新发送失败的回复消息的最大尝试次数。

default_reply_timeout = 30

整数值

rpc 回复消息发送的截止时间。

default_rpc_exchange = None

字符串值

RPC 地址中使用的交换名称。Exchange name resolution priority: Target.exchange if set else default_rpc_exchange if set else control_exchange if set else rpc

default_send_timeout = 30

整数值

rpc cast 或调用消息发送的截止时间。仅在调用者不提供超时到期时使用。

default_sender_link_timeout = 600

整数值

调度闲置发送方链接的清除持续时间。在到期后分离链接。

group_request_prefix = unicast

字符串值

发送到组中任何服务器的地址前缀

idle_timeout = 0

整数值

不活跃连接的超时时间(以秒为单位)

link_retry_delay = 10

整数值

重新连接因为可恢复的错误而失败的 AMQP 1.0 链接之间暂停的时间。

multicast_address = multicast

字符串值

在发送 fanout 消息时附加到地址前缀中。由消息总线用来识别 fanout 消息。

notify_address_prefix = openstack.org/om/notify

字符串值

所有生成的通知地址的地址前缀

notify_server_credit = 100

整数值

传入通知消息的窗口大小

pre_settled = ['rpc-cast', 'rpc-reply']

多值

发送此类类型的消息。预先修改的消息将不会接收来自对等点的确认。注意:如果发送失败,则预先修改的消息可能会静默丢弃。允许的值: rpc-call - send RPC Calls pre-settled rpc-reply- send RPC Replies pre-settled rpc-cast - Send RPC Casts pre-settled notify - Send Notifications pre-settled

pseudo_vhost = True

布尔值

为那些不支持原生支持虚拟主机(如 qpidd)的消息总线启用虚拟主机支持。当设置为 true 时,虚拟主机名将添加到所有消息总线地址中,从而有效地为每个虚拟主机 创建专用子网。如果消息总线使用 AMQP 1.0 Open performative 作为虚拟主机名称中的 hostname 字段,则设置为 False。

reply_link_credit = 200

整数值

传入 RPC Reply 消息的窗口大小。

rpc_address_prefix = openstack.org/om/rpc

字符串值

所有生成的 RPC 地址的地址前缀

rpc_server_credit = 100

整数值

传入 RPC 请求消息的窗口大小

`sasl_config_dir = `

字符串值

包含 SASL 配置的目录路径

`sasl_config_name = `

字符串值

配置文件的名称(不带 .conf 后缀)

`sasl_default_realm = `

字符串值

如果用户名中没有域,则将使用 SASL 域

`sasl_mechanisms = `

字符串值

可接受的 SASL 机制的空格分隔列表

server_request_prefix = exclusive

字符串值

发送到特定服务器时使用的地址前缀

ssl = False

布尔值

尝试通过 SSL 连接。如果没有指定其他与 ssl 相关的参数,它将使用系统的 CA-bundle 来验证服务器证书。

`ssl_ca_file = `

字符串值

用于验证服务器证书的 CA 证书 PEM 文件

`ssl_cert_file = `

字符串值

自我识别用于客户端身份验证的证书 PEM 文件

`ssl_key_file = `

字符串值

用于为 ssl_cert_file 证书签名的私钥 PEM 文件(可选)

ssl_key_password = None

字符串值

用于解密 ssl_key_file 的密码(如果加密)

ssl_verify_vhost = False

布尔值

默认情况下,SSL 检查服务器证书中的名称是否与 transport_url 中的主机名匹配。在某些配置中,可能最好使用虚拟主机名,例如,如果服务器使用 Server Name Indication TLS 扩展(rfc6066)为每个虚拟主机提供证书。如果服务器的 SSL 证书使用虚拟主机名称而不是 DNS 名称,则将 ssl_verify_vhost 设置为 True。

trace = False

布尔值

debug:将 AMQP 帧转储到 stdout

unicast_address = unicast

字符串值

在发送到特定的 RPC/Notification 服务器时,附加到地址前缀中。由消息总线用来识别发送到单个目的地的消息。

9.1.34. oslo_messaging_kafka

下表概述了 /etc/nova/nova.conf 文件中的 [oslo_messaging_kafka] 组下可用的选项。

表 9.33. oslo_messaging_kafka
配置选项 = 默认值类型Description

compression_codec = none

字符串值

生成者生成的所有数据的压缩码c。如果没有设置,则不会使用压缩。请注意,这允许的值取决于 kafka 版本

conn_pool_min_size = 2

整数值

连接过期策略的池大小限制

conn_pool_ttl = 1200

整数值

池中闲置连接的生存时间

consumer_group = oslo_messaging_consumer

字符串值

Kafka 消费者的组 ID。一个组中的消费者将协调消息消耗

enable_auto_commit = False

布尔值

启用异步消费者提交

kafka_consumer_timeout = 1.0

浮点值

Kafka 用户的默认超时

kafka_max_fetch_bytes = 1048576

整数值

Kafka 使用者的最大获取字节数

max_poll_records = 500

整数值

轮询调用中返回的最大记录数

pool_size = 10

整数值

Kafka Consumers 的池大小

producer_batch_size = 16384

整数值

producer async 发送的批处理大小

producer_batch_timeout = 0.0

浮点值

KafkaProducer batching 的延迟上限(以秒为单位)

sasl_mechanism = PLAIN

字符串值

安全协议是 SASL 的机制

security_protocol = PLAINTEXT

字符串值

用于与代理通信的协议

`ssl_cafile = `

字符串值

用于验证服务器证书的 CA 证书 PEM 文件

`ssl_client_cert_file = `

字符串值

用于身份验证的客户端证书 PEM 文件。

`ssl_client_key_file = `

字符串值

用于身份验证的客户端密钥 PEM 文件。

`ssl_client_key_password = `

字符串值

用于身份验证的客户端密钥密码文件。

9.1.35. oslo_messaging_notifications

下表概述了 /etc/nova/nova.conf 文件中的 [oslo_messaging_notifications] 组下可用的选项。

表 9.34. oslo_messaging_notifications
配置选项 = 默认值类型Description

driver = []

多值

处理发送通知的驱动程序。可能的值有 messaging, messagingv2, routing, log, test, noop

retry = -1

整数值

因可恢复的错误而发送失败的通知消息的最大尝试次数。0 - no retry, -1 - indefinite

topics = ['notifications']

列出值

用于 OpenStack 通知的 AMQP 主题。

transport_url = None

字符串值

代表用于通知的消息传递驱动程序的 URL。如果没有设置,我们回退到用于 RPC 的同一配置。

9.1.36. oslo_messaging_rabbit

下表概述了 /etc/nova/nova.conf 文件中的 [oslo_messaging_rabbit] 组下可用的选项。

表 9.35. oslo_messaging_rabbit
配置选项 = 默认值类型Description

amqp_auto_delete = False

布尔值

AMQP 中的自动删除队列。

amqp_durable_queues = False

布尔值

在 AMQP 中使用持久队列。如果启用了 rabbit_quorum_queue,则队列将具有持久性,并且此值将被忽略。

direct_mandatory_flag = True

布尔值

(DEPRECATED)为直接发送启用/禁用 RabbitMQ 强制标记。直接发送用作回复,因此当客户端队列不存在时,会引发 MessageUndeliverable 异常。MessageUndeliverable 异常将用于对超时进行循环,以便发送者有机会恢复该标志,且无法停用此功能。

enable_cancel_on_failover = False

布尔值

启用 x-cancel-on-ha-failover 标志,rabbitmq 服务器将取消和通知消费者何时队列停机

heartbeat_in_pthread = False

布尔值

默认情况下,通过原生 python 线程运行健康检查心跳线程。如果此选项等于 False,则健康检查心跳将从父进程继承执行模型。例如,如果父进程使用 eventlet/greenlet 对 stdlib 进行补丁,则 heartbeat 将通过绿色线程运行。这个选项应只针对 wsgi 服务设置为 True。

heartbeat_rate = 2

整数值

heartbeat_timeout_threshold 中检查心跳的频率。

heartbeat_timeout_threshold = 60

整数值

如果 heartbeat 的 keep-alive 失败(0 禁用心跳)失败,则 Rabbit 代理被视为 down 的秒数。

kombu_compression = None

字符串值

EXPERIMENTAL:可能的值为 gzip, bz2。如果没有设置压缩,则不会使用。这个选项可能在以后的版本中不可用。

kombu_failover_strategy = round-robin

字符串值

确定在当前连接到的 RabbitMQ 节点不可用时如何选择下一个 RabbitMQ 节点。只有在配置中提供了多个 RabbitMQ 节点时,才会生效。

kombu_missing_consumer_retry_timeout = 60

整数值

在放弃向其回复发送之前,等待缺少客户端的时间。这个值不应超过 rpc_response_timeout。

kombu_reconnect_delay = 1.0

浮点值

在响应 AMQP 消费者取消通知前等待(以秒为单位)等待(以秒为单位)。

rabbit_ha_queues = False

布尔值

尝试在 RabbitMQ 中使用 HA 队列(x-ha-policy: all)。如果更改这个选项,您必须擦除 RabbitMQ 数据库。在 RabbitMQ 3.0 中,在声明队列时,x-ha-policy 参数不再控制队列镜像。如果您只想确保所有队列(除自动生成的名称除外)都已镜像到所有节点,请运行:"rabbitmqctl set_policy HA ^(?!amq\.) commands {"ha-mode": "all"} "

rabbit_interval_max = 30

整数值

RabbitMQ 连接重试的最大间隔。默认值为 30 秒。

rabbit_login_method = AMQPLAIN

字符串值

RabbitMQ 登录方法。

rabbit_qos_prefetch_count = 0

整数值

指定要预先抓取的消息数量。将 设为零可允许无限消息。

rabbit_quorum_delivery_limit = 0

整数值

每次消息被重新设计为消费者时,计数器都会递增。当重新传送计数超过交付限制后,消息将被丢弃或死信(如果配置了 DLX 交换)仅在启用 rabbit_quorum_queue 时使用,默认 0 代表没有设置限制。

rabbit_quorum_max_memory_bytes = 0

整数值

默认情况下,如果仲裁队列增加,则所有消息都会在内存中维护,这会给集群造成内存压力。这个选项可以限制仲裁队列使用的内存字节数。仅在启用 rabbit_quorum_queue 时使用,默认 0 代表 dont 设置限制。

rabbit_quorum_max_memory_length = 0

整数值

默认情况下,如果仲裁队列增加,则所有消息都会在内存中维护,这会给集群造成内存压力。这个选项可以限制仲裁队列中的消息数量。仅在启用 rabbit_quorum_queue 时使用,默认 0 代表 dont 设置限制。

rabbit_quorum_queue = False

布尔值

在 RabbitMQ 中使用仲裁队列(x-queue-type: quorum)。仲裁队列是基于 Raft 共识算法的 RabbitMQ 实施持久复制 FIFO 队列的现代队列类型。它从 RabbitMQ 3.8.0 开始提供。如果设置此选项将与 HA 队列(rabbit_ha_queues) aka 镜像队列冲突,换句话说,应该禁用 HA 队列,因此启用此选项时会忽略 amqp_durable_queues opion。

rabbit_retry_backoff = 2

整数值

连接到 RabbitMQ 时,在重试之间会多长时间进行 backoff。

rabbit_retry_interval = 1

整数值

使用 RabbitMQ 重试连接的频率。

rabbit_transient_queues_ttl = 1800

整数值

正整数,代表队列 TTL (x-expires)的持续时间(以秒为单位)。TTL 期间未使用的队列将自动删除。参数仅影响回复和 fanout 队列。

ssl = False

布尔值

通过 SSL 连接。

`ssl_ca_file = `

字符串值

SSL 证书颁发机构文件(仅在启用 SSL 时才评估)。

`ssl_cert_file = `

字符串值

SSL 证书文件(仅在启用 SSL 时才评估)。

ssl_enforce_fips_mode = False

布尔值

强制 OpenSSL FIPS 模式的全局切换。此功能需要 Python 支持。这在所有环境中的 Python 3.9 中都可用,并可能已向后移植到所选环境中的旧的 Python 版本。如果使用的 Python 可执行文件不支持 OpenSSL FIPS 模式,则会引发异常。

`ssl_key_file = `

字符串值

SSL 密钥文件(仅在启用 SSL 时才评估)。

`ssl_version = `

字符串值

要使用的 SSL 版本(仅在启用 SSL 时验证)。有效值为 TLSv1 和 SSLv23。在某些发行版中可能会提供 SSLv2、SSLv3、TLSv1_1 和 TLSv1_2。

9.1.37. oslo_middleware

下表概述了 /etc/nova/nova.conf 文件中的 [oslo_middleware] 组下可用的选项。

表 9.36. oslo_middleware
配置选项 = 默认值类型Description

enable_proxy_headers_parsing = False

布尔值

应用程序是否位于代理后面。这决定了中间件是否应该解析标头。

http_basic_auth_user_file = /etc/htpasswd

字符串值

HTTP 基本身份验证密码文件。

max_request_body_size = 114688

整数值

每个请求的最大正文大小,以字节为单位。

secure_proxy_ssl_header = X-Forwarded-Proto

字符串值

用于确定原始请求协议方案的 HTTP 标头,即使它已被 SSL 终止代理隐藏。

9.1.38. oslo_policy

下表概述了 /etc/nova/nova.conf 文件中的 [oslo_policy] 组下可用的选项。

表 9.37. oslo_policy
配置选项 = 默认值类型描述

enforce_new_defaults = True

布尔值

这个选项控制在评估策略时是否使用旧的已弃用默认值。如果为 True,则不会评估旧的已弃用默认值。这意味着,如果旧默认值允许任何现有令牌,但不允许使用新默认值。建议启用此标志以及 enforce_scope 标志,以便您可以将新默认值和 scope_type 的好处结合在一起。如果为 False,弃用的策略检查字符串在逻辑上或带有新策略检查字符串,允许在带有新策略的发行版本间进行安全升级体验,这是默认行为。

enforce_scope = True

布尔值

此选项控制在评估策略时是否强制执行范围。如果为 True,则请求中使用的令牌范围将与强制执行的策略的 scope_types 进行比较。如果范围不匹配,则会引发 InvalidScope 异常。如果为 False,则会记录一条信息,告知操作员使用了不匹配的范围调用策略。

policy_default_rule = default

字符串值

默认规则。未找到请求的规则时强制执行。

policy_dirs = ['policy.d']

多值

存储策略配置文件的目录。它们可以相对于 config_dir 选项定义的搜索路径中的任何目录,也可以是绝对路径。必须存在由 policy_file 定义的文件,才能搜索这些目录。缺失或空目录将被忽略。

policy_file = policy.yaml

字符串值

文件相对或绝对路径,用于将角色映射到给定服务的权限。必须根据配置文件设置此选项指定相对路径。

remote_content_type = application/x-www-form-urlencoded

字符串值

用于发送和接收基于 REST 策略检查的数据的内容类型

remote_ssl_ca_crt_file = None

字符串值

基于 REST 的策略检查的 ca 证书文件的绝对路径

remote_ssl_client_crt_file = None

字符串值

基于 REST 的策略检查的客户端证书的绝对路径

remote_ssl_client_key_file = None

字符串值

绝对路径客户端密钥文件 REST 基于策略检查

remote_ssl_verify_server_crt = False

布尔值

基于 REST 策略检查的服务器身份验证

9.1.39. pci

下表概述了 /etc/nova/nova.conf 文件中的 [pci] 组下可用的选项。

表 9.38. pci
配置选项 = 默认值类型Description

alias = []

多值

PCI 透传设备要求的别名。

这允许用户在类别的额外 specs 中指定别名,而无需重复所有 PCI 属性要求。

这应该为 nova-api 服务配置,假设您想为每个 nova-compute 服务使用 move 操作。

可能的值:

  • 描述别名的 JSON 值的字典。例如:

    alias = {
      "name": "QuickAssist",
      "product_id": "0443",
      "vendor_id": "8086",
      "device_type": "type-PCI",
      "numa_policy": "required"
    }
    This defines an alias for the Intel QuickAssist card. (multi valued). Valid
    key values are :
    `name`
      Name of the PCI alias.
    `product_id`
      Product ID of the device in hexadecimal.
    `vendor_id`
      Vendor ID of the device in hexadecimal.
    `device_type`
      Type of PCI device. Valid values are: `type-PCI`, `type-PF` and
      `type-VF`. Note that `"device_type": "type-PF"` **must** be specified
      if you wish to passthrough a device that supports SR-IOV in its entirety.
    `numa_policy`
      Required NUMA affinity of device. Valid values are: `legacy`,
      `preferred` and `required`.
    `resource_class`
      The optional Placement resource class name that is used
      to track the requested PCI devices in Placement. It can be a standard
      resource class from the `os-resource-classes` lib. Or it can be an
      arbitrary string. If it is an non-standard resource class then Nova will
      normalize it to a proper Placement resource class by
      making it upper case, replacing any consecutive character outside of
      `[A-Z0-9_]` with a single '_', and prefixing the name with `CUSTOM_` if
      not yet prefixed. The maximum allowed length is 255 character including the
      prefix. If `resource_class` is not provided Nova will generate it from
      `vendor_id` and `product_id` values of the alias in the form of
      `CUSTOM_PCI_{vendor_id}_{product_id}`. The `resource_class` requested
      in the alias is matched against the `resource_class` defined in the
      `[pci]device_spec`. This field can only be used only if
      `[filter_scheduler]pci_in_placement` is enabled.
    `traits`
      An optional comma separated list of Placement trait names requested to be
      present on the resource provider that fulfills this alias. Each trait can
      be a standard trait from `os-traits` lib or it can be an arbitrary
      string. If it is a non-standard trait then Nova will normalize the
      trait name by making it upper case, replacing any consecutive character
      outside of  `[A-Z0-9_]` with a single '_', and  prefixing the name
      with `CUSTOM_` if not yet prefixed. The maximum allowed length of a
      trait name is 255 character including the prefix. Every trait in
      `traits` requested in the alias ensured to be in the list of traits
      provided in the `traits` field of the `[pci]device_spec` when
      scheduling the request. This field can only be used only if
      `[filter_scheduler]pci_in_placement` is enabled.
  • 通过重复 选项(而不是通过指定)支持多个别名

    一个列表值)
    alias = { "name": "QuickAssist-1", "product_id": "0443", "vendor_id": "8086", "device_type": "type-PCI", "numa_policy": "required" } alias = { "name": "QuickAssist-2", "product_id": "0444", "vendor_id": "8086", "device_type": "type-PCI", "numa_policy": "required" }

device_spec = []

多值

指定虚拟机可用的 PCI 设备。

可能的值:

  • 描述 PCI 设备的 JSON 字典。它应该需要

    以下格式

    ["vendor_id": "<id>",] ["product_id": "<id>",] ["address": "[[[[[<domain>]:]<bus>]:][<slot>][.[<function>]]" | "devname": "<name>",] {"<tag>": "<tag_value>",}

    Where `[` indicates zero or one occurrences, `{` indicates zero or
    multiple occurrences, and `&verbar;` mutually exclusive options. Note that any
    missing fields are automatically wildcarded.
    Valid key values are :
    `vendor_id`
      Vendor ID of the device in hexadecimal.
    `product_id`
      Product ID of the device in hexadecimal.
    `address`
      PCI address of the device. Both traditional glob style and regular
      expression syntax is supported. Please note that the address fields are
      restricted to the following maximum values:
  • 域 - 0xFFFF
  • bus - 0xFF
  • slot - 0x1F
  • 功能 - 0x7

    `devname`
      Device name of the device (for e.g. interface name). Not all PCI devices
      have a name.
    `<tag>`
      Additional `<tag>` and `<tag_value>` used for specifying PCI devices.
      Supported `<tag>` values are :
    • physical_network
    • trusted
    • remote_managed - VF 由非路径网络后端远程管理。可能具有与布尔值类似的字符串值 case-insensitive values: "true" 或 "false"。默认情况下,所有设备都假定为"false"。使用这个选项需要能够处理这些设备的网络服务后端。PCI 设备还需要具有带有卡序列号的 PCI VPD 功能(在其相应的 PF 上进行 VF 本身),否则它们将被忽略,且无法用于分配。
    • resource_class - 可选的放置资源类名称,用于在 [pci]device_spec 为 True 时跟踪放置中的匹配 PCI 设备。它可以是 os-resource-classes lib 中的标准资源类。可以是任意字符串。在这种情况下,Nova 会将它规范化为正确的放置资源类,方法是将其设置为大写,将 [A-Z0-9_] 以外的任何连续字符替换为单个 _,并使用前缀 CUSTOM_ 前缀。允许的最大长度为 255 个字符,包括前缀。如果没有提供 resource_class,Nova 将以 CUSTOM_PCI_{ vendor_id }_{product_id}_{ product_id } 的形式从 PCI 设备的 vendor_id 和 product_id 生成。resource_class 可以从 [pci]alias请求
    • 特征 - 可选的、以逗号分隔的放置特征名称列表,以报告代表匹配的 PCI 设备的资源提供程序。每个特征可以是来自 os-traits lib 的标准特征,也可以是任意字符串。如果这不是标准特征,则 Nova 将通过创建大写来规范特征名称,将 [A-Z0-9_] 以外的任何连续字符替换为单个 _,并将名称前缀为 CUSTOM_ (如果尚未作为前缀)。特征名称允许的最大长度为 255 个字符,包括前缀。特征中的任何 特征 可以从 [pci]alias 请求。

      有效示例包括
      device_spec = {"devname":"eth0", "physical_network":"physnet"} device_spec = {"address":":0a:00."} device_spec = {"address":":0a:00.", "physical_network":"physnet1"} device_spec = {"vendor_id":"1137", "product_id":"0071"} device_spec = {"vendor_id":"1137", "product_id":"0071", "address": "0000:0a:00.1", "physical_network":"physnet1"} device_spec = {"address":{"domain": ".", "bus": "02", "slot": "01", "function": "[2-7]"}, "physical_network":"physnet1"} device_spec = {"address":{"domain": ".". "bus": "02", "slot": "0[1-2]", "function": "xz"}, "physical_network":"physnet1"} device_spec = {"devname": "eth0", "physical_network":"physnet1", "trusted": "true"} device_spec = {"vendor_id":"a2d6", "product_id":"15b3", "remote_managed": "true"} device_spec = {"vendor_id":"a2d6", "product_id":"15b3", "address": "0000:82:00.0", "physical_network":"physnet1", "remote_managed": "true"} device_spec = {"vendor_id":"1002", "product_id":"6929", "address": "0000:82:00.0", "resource_class": "PGPU", "traits": "HW_GPU_API_VULKAN,my-awesome-gpu"}
      以下是无效的,因为它们指定了相互排斥的选项

      device_spec = {"devname":"eth0", "physical_network":"physnet", "address":":0a:00."}

      The following example is invalid because it specifies the `remote_managed`
      tag for a PF - it will result in an error during config validation at the
      Nova Compute 服务启动
      device_spec = {"address": "0000:82:00.0", "product_id": "a2d6", "vendor_id": "15b3", "physical_network": null, "remote_managed": "true"}
  • 与上述格式对应的 JSON 字典的 JSON 列表。对于

    示例
    device_spec = [{"product_id":"0001", "vendor_id":"8086"}, {"product_id":"0002", "vendor_id":"8086"}]

report_in_placement = False

布尔值

启用 PCI 资源清单报告到放置。如果启用了,则 nova-compute 服务将根据 [pci]device_spec 配置以及 hypervisor 报告的 PCI 设备将 PCI 资源清单报告为放置。启用后,它就无法再禁用。在以后的发行版本中,此配置的默认值将更改为 True。

相关选项:

  • [PCI]device_spec: 定义允许哪些 PCI 设备跟踪和分配给客户机。

9.1.40. placement

下表概述了 /etc/nova/nova.conf 文件中的 [placement] 组下可用的选项。

表 9.39. placement
配置选项 = 默认值类型Description

auth-url = None

字符串值

身份验证 URL

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

connect-retries = None

整数值

应该尝试连接错误的最大重试次数。

connect-retry-delay = None

浮点值

连接错误两次重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

default-domain-id = None

字符串值

与 v3 和 v2 参数一起使用的可选域 ID。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

default-domain-name = None

字符串值

与 v3 API 和 v2 参数一起使用的可选域名。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

domain-id = None

字符串值

域 ID 范围

domain-name = None

字符串值

域名范围为

endpoint-override = None

字符串值

始终使用此端点 URL 用于此客户端的请求。注意:应在此处指定未版本化的端点;若要请求特定的 API 版本,使用 version, min-version, 和/或 max-version 选项。

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

password = None

字符串值

用户密码

project-domain-id = None

字符串值

包含项目的域 ID

project-domain-name = None

字符串值

包含项目的域名

project-id = None

字符串值

项目 ID 到范围

project-name = None

字符串值

项目名称到范围

region-name = None

字符串值

端点 URL 发现的默认 region_name。

service-name = None

字符串值

用于端点 URL 发现的默认 service_name。

service-type = placement

字符串值

端点 URL 发现的默认 service_type。

split-loggers = False

布尔值

记录对多个日志记录器的请求。

status-code-retries = None

整数值

应该为可重试 HTTP 状态代码尝试的最大重试次数。

status-code-retry-delay = None

浮点值

可重试状态代码的两个重试之间的延迟(以秒为单位)。如果没有设置,则使用以 0.5 秒开始的指数重试,最多使用 60 秒。

system-scope = None

字符串值

系统操作范围

tenant-id = None

字符串值

租户 ID

tenant-name = None

字符串值

租户名称

timeout = None

整数值

http 请求的超时值

trust-id = None

字符串值

用作信任者使用的信任 ID

user-domain-id = None

字符串值

用户的域 ID

user-domain-name = None

字符串值

用户的域名

user-id = None

字符串值

用户 ID

username = None

字符串值

用户名

valid-interfaces = ['internal', 'public']

列出值

用于端点 URL 的接口列表(按首选顺序排列)。

9.1.41. privsep

下表概述了 /etc/nova/nova.conf 文件中的 [privsep] 组下可用的选项。

表 9.40. privsep
配置选项 = 默认值类型Description

capabilities = []

列出值

privsep 守护进程保留的 Linux 功能列表。

group = None

字符串值

privsep 守护进程应运行的组。

helper_command = None

字符串值

如果不使用"fork"方法,则调用用于启动 privsep 守护进程的命令。如果没有指定,则使用 "sudo privsep-helper" 和参数生成默认值,旨在重新创建当前配置。此命令必须接受合适的 --privsep_context 和 --privsep_sock_path 参数。

logger_name = oslo_privsep.daemon

字符串值

用于此 privsep 上下文的日志记录器名称。默认情况下,所有使用 oslo_privsep.daemon 的上下文日志。

thread_pool_size = <based on operating system>

整数值

可用于并发运行进程的线程数量。默认为系统中的 CPU 内核数。

user = None

字符串值

privsep 守护进程应以.

9.1.42. profiler

下表概述了 /etc/nova/nova.conf 文件中的 [profiler] 组下可用的选项。

表 9.41. profiler
配置选项 = 默认值类型Description

connection_string = messaging://

字符串值

通知程序后端的连接字符串。

默认值为 messaging://,它将通知程序设置为 oslo_messaging。

可能的值示例:

  • messaging:// - 使用 oslo_messaging 驱动程序来发送范围。
  • redis://127.0.0.1:6379 - 使用 redis 驱动程序来发送 span。
  • MongoDB://127.0.0.1:27017 - 使用 mongodb 驱动程序发送 span。
  • Elasticsearch://127.0.0.1:9200 - 使用 elasticsearch 驱动程序发送 span。
  • Jaeger://127.0.0.1:6831 - 使用 jaeger tracing 作为发送 span 的驱动程序。

enabled = False

布尔值

启用此节点上所有服务的性能分析。

默认值为 False (完全禁用性能分析功能)。

可能的值:

  • true :启用该功能
  • false :禁用该功能。该配置集无法通过此项目操作启动。如果分析由另一个项目触发,则此项目部分将为空。

es_doc_type = notification

字符串值

elasticsearch 中通知索引的文档类型。

es_scroll_size = 10000

整数值

Elasticsearch 批量分割大型请求。此参数定义每个批处理的最大大小(例如: es_scroll_size=10000)。

es_scroll_time = 2m

字符串值

此参数是一个时间值参数(例如: es_scroll_time=2m),指定参与搜索的节点将保持相关资源的时间长度,以便继续和支持它。

filter_error_trace = False

布尔值

启用包含 error/exception 到分开的位置的过滤器追踪。

默认值为 False。

可能的值:

  • true :启用包含 error/exception 的过滤器追踪。
  • false :禁用过滤器。

hmac_keys = SECRET_KEY

字符串值

用于加密性能分析上下文数据的 secret 密钥。

这个字符串值应该具有以下格式: <key1>[,<key2>,…​<keyn>],其中每个键是一些随机字符串。通过 REST API 触发性能分析的用户必须在 REST API 调用的标头中设置其中一个密钥,以包含此特定项目的此节点的性能分析结果。

"enabled"标志和"hmac_keys"配置选项都应设置为启用性能分析。此外,要在所有服务中生成正确的性能分析信息,至少需要在 OpenStack 项目之间保持一致。这样可确保可以从客户端使用它来生成 trace,其中包含来自所有可能的资源的信息。

sentinel_service_name = mymaster

字符串值

Redissentinel 使用服务名称来识别 master redis 服务。此参数定义名称(例如: send inal_service_name=mymaster)。

socket_timeout = 0.1

浮点值

Redissentinel 在连接上提供了一个 timeout 选项。此参数定义该超时(例如: socket_timeout=0.1)。

trace_sqlalchemy = False

布尔值

在服务中启用 SQL 请求性能分析。

默认值为 False (SQL 请求不会被追踪)。

可能的值:

  • true :启用 SQL 请求配置集。每个 SQL 查询都将是 trace 的一部分,可以通过花费多少时间进行分析。
  • false :禁用 SQL 请求配置集。花费的时间仅显示在更高级别的操作上。无法以这种方式分析单个 SQL 查询。

9.1.43. quota

下表概述了 /etc/nova/nova.conf 文件中的 [quota] 组下可用的选项。

表 9.42. quota
配置选项 = 默认值类型Description

cores = 20

整数值

每个项目允许的实例内核数或 vCPU 数量。

可能的值:

  • 正整数或 0。
  • -1 禁用配额。

count_usage_from_placement = False

布尔值

启用放置服务的配额使用量计数。

从 Train 开始,可以计算放置服务和来自 API 数据库的实例,而不是从单元数据库计算内核的配额使用量。

如果每个放置部署只有一个 Nova 部署,这可以正常工作。但是,如果操作器运行多个 Nova 部署共享放置部署,则不应将此选项设置为 True,因为当前放置服务无法为每个 Nova 部署对资源提供程序分区。当此选项保留为默认值或设置为 False 时,Nova 将使用传统计数方法计算其单元数据库中的实例、内核数和 ram 的配额使用量。

请注意,如果此选项设置为 True,与调整大小相关的配额使用行为会受到影响。在调整大小期间保留源上的分配时,在目标上声明放置资源分配,直到调整大小确认或恢复为止。在此期间,当服务器处于 VERIFY_RESIZE 状态时,配额使用量反映源和目标上的资源消耗。这很有用,因为它为 downsize 保留空间,但也意味着配额使用量在确认或恢复之前。

对于处于 ERROR 状态的未调度服务器的行为也有所不同。处于 ERROR 状态的服务器永远不会被调度到计算主机没有分配,因此它不会消耗内核和 ram 的配额使用量。

SHELVED_OFFLOADED 状态的服务器的行为会有所不同。SHELVED_OFFLOADED 状态的服务器没有放置分配,因此它不会消耗内核和 ram 的配额使用量。请注意,如果用户没有足够的配额来支持核心和框架,则有可能拒绝拒绝服务器的请求。

必须完成 populate_queued_for_deletepopulate_user_id 在线数据迁移,然后才能从放置计算使用量。在数据迁移完成前,系统会回退到来自单元数据库的传统配额使用量计数,具体取决于每个配额检查过程中 EXISTS 数据库查询的结果,如果此配置选项被设置为 True。希望避免在 EXISTS 查询中性能命中的 Operator 应等待将此配置选项设置为 True,直到它们通过 nova-manage db online_data_migrations 完成其在线数据迁移后。

driver = nova.quota.DbQuotaDriver

字符串值

提供配额检查的抽象。用户可以配置用于配额检查的特定驱动程序。

injected_file_content_bytes = 10240

整数值

每个注入的文件允许的字节数。

可能的值:

  • 正整数或 0。
  • -1 禁用配额。

injected_file_path_length = 255

整数值

允许的最大注入文件路径长度。

可能的值:

  • 正整数或 0。
  • -1 禁用配额。

injected_files = 5

整数值

允许注入的文件数量。

文件注入允许用户在引导时将数据注入到实例,从而自定义实例的个人性。只允许文本文件注入:不接受二进制或 ZIP 文件。在文件注入过程中,任何与指定文件匹配的现有文件都会重命名为包含 .bak 扩展,并带有一个时间戳。

可能的值:

  • 正整数或 0。
  • -1 禁用配额。

instances = 10

整数值

每个项目允许的实例数量。

可能的值

  • 正整数或 0。
  • -1 禁用配额。

key_pairs = 100

整数值

每个用户允许的最大密钥对数。

用户可以为每个项目创建至少一个密钥对,并将密钥对用于属于该项目的多个实例。

可能的值:

  • 正整数或 0。
  • -1 禁用配额。

metadata_items = 128

整数值

每个实例允许的元数据项目数量。

用户可以在实例创建过程中将元数据与实例相关联。此元数据采用键值对的形式。

可能的值:

  • 正整数或 0。
  • -1 禁用配额。

ram = 51200

整数值

每个项目允许的实例 RAM 数。

可能的值:

  • 正整数或 0。
  • -1 禁用配额。

recheck_quota = True

布尔值

在资源创建后重新检查配额以防止超过配额。

默认为 True (在资源创建后检查配额),但可以设置为 False,以避免因为考虑使用请求而超过配额而避免额外的负载。例如,如果用户进行高度并行的 REST API 请求来创建服务器,则他们有可能创建超过其在竞争期间允许的配额更多的服务器。如果其配额是 10 个服务器,它们可能会在突发期间创建 50 个。在突发后,他们将无法创建任何更多服务器,但只有 50 个服务器可以保持其 50 个服务器,直到它们删除为止。

初始配额检查会在创建资源前进行,因此如果多个并行请求同时到达,则所有可能会同时通过配额检查并创建资源,可能会超过配额。当 recheck_quota 为 True 时,会在创建资源后检查配额,如果资源超过配额,则会引发 OverQuota,通常会导致 REST API 用户的 403 响应。这使得用户无法超出其配额的配额,但请注意,如果 REST API 用户在接近达到其配额限制的情况下,使用 403 响应来拒绝其配额,即使用户有足够的配额可用。

server_group_members = 10

整数值

每个服务器组的最大服务器数量。

可能的值:

  • 正整数或 0。
  • -1 禁用配额。

server_groups = 10

整数值

每个项目的最大服务器组数。

服务器组可用于控制一组服务器或实例的关联性和反关联性调度策略。减少配额不会影响任何现有的组,但不允许在超过配额的组中使用新的服务器。

可能的值:

  • 正整数或 0。
  • -1 禁用配额。

9.1.44. rdp

下表概述了 /etc/nova/nova.conf 文件中的 [rdp] 组下可用的选项。

表 9.43. rdp
配置选项 = 默认值类型Description

enabled = False

布尔值

启用远程桌面协议(RDP)相关功能。

Hyper-V 与在 Nova 计算节点上使用的大多数虚拟机监控程序不同,使用 RDP 而不是 VNC 和 SPICE 作为桌面共享协议,以提供实例控制台访问。这个选项为 Hyper-V 创建的虚拟机启用 RDP 以进行图形控制台访问。

注: RDP 应该只在支持 Hyper-V 虚拟化平台的计算节点上启用。

相关选项:

  • compute_driver :必须是 hyperv。

html5_proxy_base_url = http://127.0.0.1:6083/

URI 值

最终用户用来连接到 RDP HTML5 控制台代理的 URL。控制台代理服务使用此 token-embedded URL 调用,并建立与正确实例的连接。

RDP HTML5 控制台代理服务需要配置为侦听此处配置的地址。通常,控制台代理服务将在控制器节点上运行。用作 default 的 localhost 地址只能在单一节点环境中工作,如 devstack。

RDP HTML5 代理允许用户使用 RDP 通过任何 Windows 服务器或工作站的文本或图形控制台访问。RDP HTML5 控制台代理服务包括 FreeRDP、wsgate。See https://github.com/FreeRDP/FreeRDP-WebConnect

可能的值:

  • <scheme>://<ip-address>:<port-number>/

    The scheme must be identical to the scheme configured for the RDP HTML5
    console proxy service. It is `http` or `https`.
    The IP address must be identical to the address on which the RDP HTML5
    console proxy service is listening.
    The port must be identical to the port on which the RDP HTML5 console proxy
    service is listening.

相关选项:

  • RDP.enabled :必须为 html5_proxy_base_url 设置为 True

9.1.45. remote_debug

下表概述了 /etc/nova/nova.conf 文件中的 [remote_debug] 组下可用的选项。

表 9.44. remote_debug
配置选项 = 默认值类型Description

host = None

主机地址值

要连接的调试主机(IP 或名称)。

当您要通过在不同主机上运行的 debugger 连接到 nova 服务时,可使用此命令行参数。

请注意,使用远程 debug 选项更改 nova 如何使用 eventlet 库来支持 async IO。这可能会导致在正常操作下不会发生失败。自行使用风险。

可能的值:

  • 远程主机的 IP 地址作为 nova 服务的命令行参数。

    例如:
    nova-compute --config-file /etc/nova/nova.conf --remote_debug-host <IP address of the debugger>

port = None

端口值

要连接的调试端口。

此命令行参数允许您指定用于通过不同主机上运行的 debugger 连接到 nova 服务的端口。

请注意,使用远程 debug 选项更改 nova 如何使用 eventlet 库来支持 async IO。这可能会导致在正常操作下不会发生失败。自行使用风险。

可能的值:

  • 您要用作 nova 服务的命令行参数的端口号。

    例如:
    nova-compute --config-file /etc/nova/nova.conf --remote_debug-host <IP address of the debugger> --remote_debug-port <port debugger is listening on>。

9.1.46. scheduler

下表概述了 /etc/nova/nova.conf 文件中的 [scheduler] 组下可用的选项。

表 9.45. scheduler
配置选项 = 默认值类型Description

discover_hosts_in_cells_interval = -1

整数值

定期任务间隔。

这个值控制调度程序应尝试发现添加到单元中的新主机的频率(以秒为单位)。如果为负(默认),则不会进行自动发现。

计算节点上线并经常存在的部署可能会启用此功能,而其他情况下可能会选择在添加时手动发现主机,以避免持续检查任何开销。如果启用,每次运行时,我们将在每次运行时从每个单元数据库中选择任何未映射的主机。

可能的值:

  • 一个整数,整数对应于定期的任务间隔(以秒为单位)。0 使用默认间隔(60 秒)。负值禁用定期任务。

enable_isolated_aggregate_filtering = False

布尔值

将聚合的使用限制为具有匹配元数据的实例。

此设置允许调度程序根据聚合元数据和实例 flavor/image 中匹配的所需特征来限制聚合中的主机。如果使用带有键特征的属性配置了聚合:trait:$TRAIT_NAME 和值 required,则实例类别 extra_specs 和/或镜像元数据还必须包含trait:$TRAIT_NAME=required 有资格调度到该聚合中的主机。更多技术细节,请访问 https://docs.openstack.org/nova/latest/reference/isolate-aggregates.html

可能的值:

  • 布尔值。

image_metadata_prefilter = False

布尔值

使用放置根据镜像元数据过滤主机。

此设置会导致调度程序将众所周知的镜像元数据属性转换为放置所需的特征,以根据镜像元数据过滤主机。此功能需要主机支持,且目前受以下计算驱动程序支持:

  • libvirt.LibvirtDriver (since Ussuri (21.0.0))

可能的值:

  • 布尔值。

相关选项:

  • [compute] compute_driver

limit_tenants_to_placement_aggregate = False

布尔值

将租户限制为特定的放置聚合。

此设置会导致调度程序使用将 filter_tenant_id 设置为传入请求的项目的元数据键查找主机聚合,并从放置请求请求结果限制为该聚合。通过将序列号附加到密钥,可以将多个租户添加到单个聚合中,如 filter_tenant_id:123。

匹配的聚合 UUID 必须在放置中镜像,才能正常工作。如果没有找到带有租户 id 的主机聚合,或者该聚合与放置中的一个不匹配,则结果与查找任何适合请求的主机不同。

可能的值:

  • 布尔值。

相关选项:

  • [scheduler] placement_aggregate_required_for_tenants

max_attempts = 3

整数值

最多调度尝试次数。

这是为给定实例构建/move 操作进行的最大尝试次数。它限制调度程序返回的备用主机数量。当主机列表耗尽时,会引发 MaxRetriesExceeded 异常,并将实例设置为错误状态。

可能的值:

  • 一个正整数,其中整数对应于构建或移动实例时可以进行的最大尝试数。

max_placement_results = 1000

整数值

要请求的最大放置结果数。

此设置决定了在调度操作过程中从放置服务接收的结果的最大限制。它有效限制了可能在调度与大量候选人匹配的请求的主机数量。

值 1 (最小值)将有效地将调度到放置服务,严格针对"更适合"的中心。数值越高,调度程序会在过滤和权衡过程中考虑的结果数上限。大型部署可能需要将其设置为可用的主机总数,以限制调度程序的内存消耗、网络流量等。

可能的值:

  • 整数,整数对应于要返回的放置结果数。

placement_aggregate_required_for_tenants = False

布尔值

需要所有租户的放置聚合关联。

当 limit_tenants_to_placement_aggregate=True 时,将控制是否允许没有聚合关联性的租户调度到任何可用节点。如果使用聚合来限制某些租户但并非所有,则这应为 False。如果所有租户都应通过聚合限制,则这应该为 True,以防止它们接收对任何可用节点的不受限制的调度。

可能的值:

  • 布尔值。

相关选项:

  • [scheduler] placement_aggregate_required_for_tenants

query_placement_for_availability_zone = True

布尔值

使用放置来确定可用性区域。

此设置会使调度程序使用设置为传入请求所提供的值的元数据键(availability_zone)查找主机聚合,并从放置请求请求结果限制为该聚合。

匹配的聚合 UUID 必须在放置中镜像,才能正常工作。如果没有找到带有 availability_zone 键的主机聚合,或者该聚合与放置中的一个不匹配,则结果与查找任何合适的主机不同。

请注意,如果禁用此标志,您必须在 调度程序中启用(无效率) AvailabilityZoneFilter,以便可用区正常工作。

可能的值:

  • 布尔值。

相关选项:

  • [filter_scheduler] enabled_filters

弃用自: 24.0.0

原因: 由于在 18.0.0 (Rocky)中引入放置 pre-filters (Rocky),我们支持的跟踪可用区可以在放置中原生或使用旧的 ''AvailabilityZoneFilter' 调度程序过滤器。在 24.0.0 (Xena)中,基于过滤器的方法已弃用,以移除使用基于放置的方法。因此,此配置选项也已弃用,并将在 ''AvailabilityZoneFilter' 过滤器被删除时删除。

query_placement_for_image_type_support = False

布尔值

使用放置来确定对实例镜像类型的主机支持。

此设置会导致调度程序只为支持请求中使用的镜像的 disk_format 的计算主机请求放置。

可能的值:

  • 布尔值。

query_placement_for_routed_network_aggregates = False

布尔值

启用调度程序来过滤计算主机与路由网络段聚合。

详情请查看 https://docs.openstack.org/neutron/latest/admin/config-routed-networks.html

Worker = None

整数值

nova-scheduler 服务的 worker 数量。

默认为可用的 CPU 数量。

可能的值:

  • 一个整数,整数对应于 worker 进程的数量。

9.1.47. serial_console

下表概述了 /etc/nova/nova.conf 文件中的 [serial_console] 组下可用的选项。

表 9.46. serial_console
配置选项 = 默认值类型Description

base_url = ws://127.0.0.1:6083/

URI 值

最终用户用来连接到 nova-serialproxy 服务的 URL。

nova-serialproxy 服务使用此令牌增强 URL 调用,并建立与正确实例的连接。

相关选项:

  • IP 地址必须与 nova-serialproxy 服务正在侦听的地址相同(请参见本节中的 serialproxy_host 选项)。
  • 端口必须与本节的 serialproxy_port 选项中的相同。
  • 如果您选择使用安全的 websocket 连接,请使用 ws:// 而不是未保护的 ws:// 启动此选项。必须为此在 [DEFAULT] 项中设置 certkey 选项。

enabled = False

布尔值

启用串行控制台功能。

要使用此功能,服务 nova-serialproxy 需要运行。此服务通常在控制器节点上执行。

port_range = 10000:20000

字符串值

客户端可用于其后端的一组 TCP 端口。

每个创建的实例都将使用这个范围内的一个端口。如果范围不足以为新实例提供另一个端口,则此实例将不会启动。

可能的值:

  • 每个传递 regex ^\d+:\d+$ 的字符串,如 10000:20000。确保第一个端口号小于第二个端口号,并且两者都范围为 0 到 65535。

proxyclient_address = 127.0.0.1

字符串值

代理客户端(如 nova-serialproxy)应连接到的 IP 地址,以获取实例的串行控制台。

这通常是 nova-compute 服务的主机的 IP 地址。

serialproxy_host = 0.0.0.0

字符串值

nova-serialproxy 服务用来侦听传入请求的 IP 地址。

nova-serialproxy 服务侦听此 IP 地址,以获取向公开串行控制台的实例发出的传入连接请求。

相关选项:

  • 确保这与本节的 base_url 选项中定义的 IP 地址相同,或使用 0.0.0.0 侦听所有地址。

serialproxy_port = 6083

端口值

nova-serialproxy 服务用来侦听传入请求的端口号。

nova-serialproxy 服务侦听此端口号,以获取向公开串行控制台的实例发出的传入连接请求。

相关选项:

  • 确保这与本节的 base_url 选项中定义的端口号相同。

9.1.48. service_user

下表概述了 /etc/nova/nova.conf 文件中的 [service_user] 组下可用的选项。

表 9.47. service_user
配置选项 = 默认值类型Description

auth-url = None

字符串值

身份验证 URL

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

default-domain-id = None

字符串值

与 v3 和 v2 参数一起使用的可选域 ID。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

default-domain-name = None

字符串值

与 v3 API 和 v2 参数一起使用的可选域名。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

domain-id = None

字符串值

域 ID 范围

domain-name = None

字符串值

域名范围为

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

password = None

字符串值

用户密码

project-domain-id = None

字符串值

包含项目的域 ID

project-domain-name = None

字符串值

包含项目的域名

project-id = None

字符串值

项目 ID 到范围

project-name = None

字符串值

项目名称到范围

send_service_user_token = False

布尔值

为 True 时,如果向 REST API 发送用户令牌,也会发送服务令牌。

Nova 通常重复使用提供给 nova-api 的用户令牌,以与其他 REST API 通信,如 Cinder、Glance 和 Neutron。当用户令牌在向 Nova 发出请求时有效时,令牌可能会在到达其他服务之前过期。为避免出现任何故障,并且使其清除为 Nova 代表用户调用服务,我们会包括服务令牌以及用户令牌。如果用户的令牌已过期,则有效的服务令牌可确保 keystone 中间件仍接受 REST API 请求。

split-loggers = False

布尔值

记录对多个日志记录器的请求。

system-scope = None

字符串值

系统操作范围

tenant-id = None

字符串值

租户 ID

tenant-name = None

字符串值

租户名称

timeout = None

整数值

http 请求的超时值

trust-id = None

字符串值

用作信任者使用的信任 ID

user-domain-id = None

字符串值

用户的域 ID

user-domain-name = None

字符串值

用户的域名

user-id = None

字符串值

用户 ID

username = None

字符串值

用户名

9.1.49. spice

下表概述了 /etc/nova/nova.conf 文件中的 [spice] 组下可用的选项。

表 9.48. spice
配置选项 = 默认值类型Description

agent_enabled = True

布尔值

在实例上启用 SPICE 客户机代理支持。

Spice 代理与 Spice 协议配合使用,以提供更好的客户机控制台体验。但是,Spice 控制台仍可在没有 Spice 代理的情况下使用。安装 Spice 代理后,启用了以下功能:

  • 在客户机和客户端机器之间复制和粘贴文本和图像
  • 当客户端屏幕更改时自动调整分辨率 - 例如,如果您使 Spice 控制台完整屏幕,客户机解析将调整以匹配其匹配,而不是字母箱。
  • 更好的鼠标集成 - 可以捕获和释放鼠标,而无需点击控制台内或按键来释放它。鼠标移动的性能也得到了提高。

enabled = False

布尔值

启用 SPICE 相关功能。

相关选项:

  • 必须明确禁用 VNC 才能访问 SPICE 控制台。在 [vnc] 部分中将 enabled 选项设置为 False,以禁用 VNC 控制台。

html5proxy_base_url = http://127.0.0.1:6082/spice_auto.html

URI 值

SPICE HTML5 控制台代理的位置。

最终用户将使用此 URL 连接到 nova-spicehtml5proxy 服务。此服务将请求转发到实例的控制台。

要使用 SPICE 控制台,服务 nova-spicehtml5proxy 应该正在运行。此服务通常在控制器节点上启动。

可能的值:

  • 必须是表单的有效 URL:http://host:port/spice_auto.html,其中 host 是运行 nova-spicehtml5proxy 的节点,端口通常为 6082。考虑不要使用默认值,因为它没有为任何实际部署定义。

相关选项:

  • 这个选项取决于 html5proxy_hosthtml5proxy_port 选项。计算节点返回的访问 URL 必须具有 nova-spicehtml5proxy 服务正在侦听的主机和端口。

html5proxy_host = 0.0.0.0

主机地址值

nova-spicehtml5proxy 服务侦听传入请求的 IP 地址或主机名。

相关选项:

  • 这个选项取决于 html5proxy_base_url 选项。nova-spicehtml5proxy 服务必须侦听一个可从 HTML5 客户端访问的主机。

html5proxy_port = 6082

端口值

nova-spicehtml5proxy 服务在其上侦听传入请求的端口。

相关选项:

  • 这个选项取决于 html5proxy_base_url 选项。nova-spicehtml5proxy 服务必须侦听一个可从 HTML5 客户端访问的端口。

image_compression = None

字符串值

配置 SPICE 映像压缩(无大)。

jpeg_compression = None

字符串值

配置 SPICE 映像压缩(适用于缓慢链接)。

playback_compression = None

布尔值

启用 SPICE 音频流压缩(使用 celt)。

server_listen = 127.0.0.1

字符串值

实例上运行的 SPICE 服务器应侦听的地址。

通常,nova-spicehtml5proxy 代理客户端在控制器节点上运行,并通过专用网络连接到计算节点上的这个地址。

可能的值:

  • 要侦听的 IP 地址。

server_proxyclient_address = 127.0.0.1

字符串值

nova-spicehtml5proxy 客户端用于连接实例控制台的地址。

通常,nova-spicehtml5proxy 代理客户端在控制器节点上运行,并通过专用网络连接到计算节点上的这个地址。

可能的值:

  • 计算节点上的任何有效的 IP 地址。

相关选项:

  • 此选项取决于 server_listen 选项。代理客户端必须能够使用此选项的值访问 server_listen 中指定的地址。

streaming_mode = None

字符串值

配置 SPICE 视频流检测和(术语)压缩。

zlib_compression = None

字符串值

配置 SPICE 映像压缩(对慢链接没有)。

9.1.50. upgrade_levels

下表概述了 /etc/nova/nova.conf 文件中的 [upgrade_levels] 组下可用的选项。

表 9.49. upgrade_levels
配置选项 = 默认值类型Description

baseapi = None

字符串值

基本 API RPC API 版本大写。

可能的值:

  • 默认情况下,发送客户端知道的最新版本
  • 代表 N.N 格式的版本号的字符串;例如,可能的值可以是 1.122.0
  • 小写的 OpenStack 版本名称,如 mitakaliberty

cert = None

字符串值

Cert RPC API 版本大写。

可能的值:

  • 默认情况下,发送客户端知道的最新版本
  • 代表 N.N 格式的版本号的字符串;例如,可能的值可以是 1.122.0
  • 小写的 OpenStack 版本名称,如 mitakaliberty

弃用自:18.0.0

reason: nova-cert 服务在 16.0.0 (Pike)中删除,因此不再使用这个选项。

compute = None

字符串值

计算 RPC API 版本大写。

默认情况下,我们始终使用客户端知道的最新版本发送消息。

如果您运行有旧的计算服务和新的计算服务,应该将其设置为最低部署的版本。这是为了保证所有服务永远不会发送其中一个计算节点无法理解的消息。请注意,我们只支持从版本 N 升级到 N+1。

如果要让 compute RPC 模块根据部署中的服务版本自动决定使用哪个版本,请将此选项设置为 "auto"。

可能的值:

  • 默认情况下,发送客户端知道的最新版本
  • auto :根据部署中的服务版本自动决定要使用的版本。
  • 代表 N.N 格式的版本号的字符串;例如,可能的值可以是 1.122.0
  • 小写的 OpenStack 版本名称,如 mitakaliberty

conductor = None

字符串值

编排器 RPC API 版本大写。

可能的值:

  • 默认情况下,发送客户端知道的最新版本
  • 代表 N.N 格式的版本号的字符串;例如,可能的值可以是 1.122.0
  • 小写的 OpenStack 版本名称,如 mitakaliberty

scheduler = None

字符串值

调度程序 RPC API 版本大写。

可能的值:

  • 默认情况下,发送客户端知道的最新版本
  • 代表 N.N 格式的版本号的字符串;例如,可能的值可以是 1.122.0
  • 小写的 OpenStack 版本名称,如 mitakaliberty

9.1.51. Vault

下表概述了 /etc/nova/nova.conf 文件中的 [vault] 组下可用的选项。

表 9.50. Vault
配置选项 = 默认值类型Description

approle_role_id = None

字符串值

Approle role_id 用于使用 vault 进行身份验证

approle_secret_id = None

字符串值

Approle secret_id 用于使用 vault 进行身份验证

kv_mountpoint = secret

字符串值

Vault 中要使用的 KV 存储的挂载点,例如:secret

kv_version = 2

整数值

要使用的 Vault 中的 KV 存储版本,例如:2

namespace = None

字符串值

用于 Vault 的所有请求的 vault 命名空间。Vault 命名空间功能仅适用于 Vault Enterprise

root_token_id = None

字符串值

vault 的 root 令牌

ssl_ca_crt_file = None

字符串值

ca 证书文件的绝对路径

use_ssl = False

布尔值

SSL Enabled/Disabled

vault_url = http://127.0.0.1:8200

字符串值

使用此端点连接到 Vault,例如:"http://127.0.0.1:8200"

9.1.52. vendordata_dynamic_auth

下表概述了 /etc/nova/nova.conf 文件中的 [vendordata_dynamic_auth] 组下可用的选项。

表 9.51. vendordata_dynamic_auth
配置选项 = 默认值类型Description

auth-url = None

字符串值

身份验证 URL

auth_section = None

字符串值

加载插件特定选项的配置部分

auth_type = None

字符串值

要载入的身份验证类型

cafile = None

字符串值

在验证 HTTP 连接时使用的 PEM 编码证书颁发机构。

certfile = None

字符串值

PEM 编码的客户端证书证书文件

collect-timing = False

布尔值

收集每个API 调用时间信息。

default-domain-id = None

字符串值

与 v3 和 v2 参数一起使用的可选域 ID。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

default-domain-name = None

字符串值

与 v3 API 和 v2 参数一起使用的可选域名。它将用于 v3 中的用户和项目域,并在 v2 身份验证中忽略。

domain-id = None

字符串值

域 ID 范围

domain-name = None

字符串值

域名范围为

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

PEM 编码的客户端证书密钥文件

password = None

字符串值

用户密码

project-domain-id = None

字符串值

包含项目的域 ID

project-domain-name = None

字符串值

包含项目的域名

project-id = None

字符串值

项目 ID 到范围

project-name = None

字符串值

项目名称到范围

split-loggers = False

布尔值

记录对多个日志记录器的请求。

system-scope = None

字符串值

系统操作范围

tenant-id = None

字符串值

租户 ID

tenant-name = None

字符串值

租户名称

timeout = None

整数值

http 请求的超时值

trust-id = None

字符串值

用作信任者使用的信任 ID

user-domain-id = None

字符串值

用户的域 ID

user-domain-name = None

字符串值

用户的域名

user-id = None

字符串值

用户 ID

username = None

字符串值

用户名

9.1.53. vmware

下表概述了 /etc/nova/nova.conf 文件中的 [vmware] 组下可用的选项。

表 9.52. vmware
配置选项 = 默认值类型Description

api_retry_count = 10

整数值

在连接失败时,必须重试 VMware vCenter 服务器 API 的次数,如套接字错误等。

ca_file = None

字符串值

指定验证 vCenter 服务器证书时使用的 CA 捆绑包文件。

cache_prefix = None

字符串值

此选项为存储缓存镜像的文件夹添加前缀

这不是完整路径 - 只是文件夹前缀。只有在计算节点间共享数据存储缓存时,才应使用此选项。

注意:仅当计算节点在同一主机上运行或者具有共享文件系统时,才应使用它。

可能的值:

  • 代表文件夹的缓存前缀的任何字符串

cluster_name = None

字符串值

VMware Cluster ComputeResource 的名称。

connection_pool_size = 10

整数值

这个选项设置 http 连接池大小

连接池大小是从 nova 到 vSphere 的最大连接数。只有存在表示连接池已满的警告时,才会增加它,否则,默认值应 suffice。

console_delay_seconds = None

整数值

如果受增加的网络延迟的影响,请在远程控制台中输入时重复字符,则设置这个值。

datastore_regex = None

字符串值

匹配数据存储名称的正则表达式模式。

datastore_regex 设置指定要用于计算的数据存储。例如, datastore_regex="nas configured" 选择名称以 "nas" 开头的所有数据存储。

注意

如果没有提供 regex,它只是使用最多可用空间选择数据存储。

可能的值:

  • 必须提供与数据存储匹配的正则表达式

host_ip = None

主机地址值

用于连接到 VMware vCenter 主机的主机名或 IP 地址。

host_password = None

字符串值

连接到 VMware vCenter 主机的密码。

host_port = 443

端口值

用于连接到 VMware vCenter 主机的端口。

host_username = None

字符串值

连接到 VMware vCenter 主机的用户名。

insecure = False

布尔值

如果为 true,则不会验证 vCenter 服务器证书。如果为 false,则使用默认 CA 信任存储进行验证。

相关选项:

  • ca_file :如果设置了 "ca_file",则忽略此选项。

integration_bridge = None

字符串值

只有在使用 NSX-MH Neutron 插件时,才应配置这个选项。这是 ESXi 服务器或主机上的集成桥接名称。这不应该为任何其他 Neutron 插件设置。因此,不会设置默认值。

可能的值:

  • 代表集成网桥名称的任何有效字符串

maximum_objects = 100

整数值

此选项指定要在单个结果中返回的最大对象数量的限制。

当对象数量达到指定的限制时,正值将导致操作暂停检索。服务器仍然可以将计数限制为小于配置的值。任何剩余的对象都可以使用额外的请求检索。

pbm_default_policy = None

字符串值

此选项指定要使用的默认策略。

如果设置了 pbm_enabled,并且没有为特定请求定义存储策略,则使用此策略。

可能的值:

  • 任何有效的存储策略,如 VSAN 默认存储策略

相关选项:

  • pbm_enabled

pbm_enabled = False

布尔值

此选项启用或禁用实例的存储策略放置。

相关选项:

  • pbm_default_policy

pbm_wsdl_location = None

字符串值

此选项指定 PBM 服务 WSDL 文件位置 URL。

设置此选项将禁用基于实例的存储策略放置。

可能的值:

serial_log_dir = /opt/vmware/vspc

字符串值

指定 Virtual Serial Port Concentrator 存储控制台日志文件的目录。它应与 VSPC 的 serial_log_dir 配置值匹配。

serial_port_proxy_uri = None

URI 值

标识提供对 serial_port_service_uri 的网络访问权限的代理服务。

可能的值:

  • 任何有效的 URI (方案为 telnettelnet )。

相关选项:

如果没有指定 serial_port_service_uri,则忽略此选项。

  • serial_port_service_uri

serial_port_service_uri = None

字符串值

标识将发送串行端口流量的远程系统。

此选项添加一个虚拟串行端口,它将控制台输出发送到可配置的服务 URI。在服务 URI 地址中,将收集控制台日志的虚拟串行端口集中器。如果没有设置,则不会将串行端口添加到创建的虚拟机中。

可能的值:

  • 任何有效的 URI

task_poll_interval = 0.5

浮点值

在 VMware VC 服务器上轮询远程任务的时间间隔(以秒为单位)。

use_linked_clone = True

布尔值

此选项启用/禁用链接克隆的使用。

ESX hypervisor 需要 VMDK 文件的副本才能引导虚拟机。计算驱动程序必须通过 HTTP 从 OpenStack Image 服务下载 VMDK 到虚拟机监控程序可见的数据存储并缓存它。需要 VMDK 的后续虚拟机使用缓存的版本,不需要从 OpenStack 镜像服务再次复制文件。

如果设置为 false,即使使用缓存的 VMDK,仍有一个从缓存位置复制到共享数据存储中的虚拟机监控程序文件目录的副本操作。如果设置为 true,则避免上述复制操作,因为它创建与其父虚拟机共享虚拟磁盘的虚拟机副本。

vnc_keymap = en-us

字符串值

VNC 的键映射。

键盘映射(键映射)决定默认应使用 VNC 会话的键盘布局。

可能的值:

  • 此节点上的底层虚拟机监控程序支持的键盘布局。这通常是一个 IETF 语言标签 (如 en-us)。

vnc_port = 5900

端口值

这个选项指定 VNC 启动端口。

由 ESX 主机创建的每个虚拟机都带有为远程连接启用 VNC 客户端的选项。以上选项 vnc_port 可帮助您为 VNC 客户端设置默认启动端口。

可能的值:

  • Any valid port number within 5900 -(5900 + vnc_port_total)

相关选项:

应将以下选项设置为启用 VNC 客户端。

  • vnc.enabled = True
  • vnc_port_total

vnc_port_total = 10000

整数值

VNC 端口总数。

9.1.54. vnc

下表概述了 /etc/nova/nova.conf 文件中的 [vnc] 组下可用的选项。

表 9.53. vnc
配置选项 = 默认值类型Description

auth_schemes = ['none']

列出值

与计算节点一起使用的身份验证方案。

控制代理和计算主机之间允许哪些 RFB 身份验证方案。如果启用了多个方案,则使用第一个匹配的方案,因此应首先列出最强的方案。

相关选项:

  • [VNC]vencrypt_client_key,[vnc]vencrypt_client_cert: 还必须设置

enabled = True

布尔值

启用 VNC 相关功能。

将通过图形设备创建客户机来支持这一点。然后,客户端(如 Horizon)可以建立到客户机的 VNC 连接。

novncproxy_base_url = http://127.0.0.1:6080/vnc_auto.html

URI 值

noVNC VNC 控制台代理的公共地址。

VNC 代理是一种 OpenStack 组件,它允许计算服务用户通过 VNC 客户端访问其实例。noVNC 通过基于 websocket 的客户端提供 VNC 支持。

这个选项设置客户端系统要连接的公共基本 URL。noVNC 客户端可以使用这个地址连接到 noVNC 实例,并通过扩展 VNC 会话。

如果使用 noVNC >= 1.0.0,则应使用 vnc_lite.html 而不是 vnc_auto.html

相关选项:

  • novncproxy_host
  • novncproxy_port

novncproxy_host = 0.0.0.0

字符串值

noVNC 控制台代理应绑定到的 IP 地址。

VNC 代理是一种 OpenStack 组件,它允许计算服务用户通过 VNC 客户端访问其实例。noVNC 通过基于 websocket 的客户端提供 VNC 支持。

这个选项设置 noVNC 控制台代理服务应绑定到的专用地址。

相关选项:

  • novncproxy_port
  • novncproxy_base_url

novncproxy_port = 6080

端口值

noVNC 控制台代理应绑定到的端口。

VNC 代理是一种 OpenStack 组件,它允许计算服务用户通过 VNC 客户端访问其实例。noVNC 通过基于 websocket 的客户端提供 VNC 支持。

此选项设置 noVNC 控制台代理服务应绑定到的私有端口。

相关选项:

  • novncproxy_host
  • novncproxy_base_url

server_listen = 127.0.0.1

主机地址值

实例应侦听此节点上的传入 VNC 连接请求的 IP 地址或主机名。

server_proxyclient_address = 127.0.0.1

主机地址值

VNC 控制台代理的私有、内部 IP 地址或主机名。

VNC 代理是一种 OpenStack 组件,它允许计算服务用户通过 VNC 客户端访问其实例。

此选项设置代理客户端应连接到的专用地址,如 nova-novncproxy

vencrypt_ca_certs = None

字符串值

CA 证书 PEM 文件的路径

到计算节点的 VNC 服务器使用的证书颁发机构的一个或多个 x509 证书的 PEM 文件的完全限定路径。

相关选项:

  • vnc.auth_schemes: 必须包括 vencrypt

vencrypt_client_cert = None

字符串值

客户端密钥文件的路径(用于 x509)

包含 x509 证书的 PEM 文件的完全限定路径,在 VNC 身份验证期间向计算节点显示这些证书。

Realted 选项:

  • vnc.auth_schemes: 必须包括 vencrypt
  • vnc.vencrypt_client_key: 还必须设置

vencrypt_client_key = None

字符串值

客户端证书 PEM 文件的路径(用于 x509)

到 PEM 文件的完全限定路径,其中包含 VNC 代理服务器在 VNC 身份验证期间向计算节点呈现的私钥。

相关选项:

  • vnc.auth_schemes: 必须包括 vencrypt
  • vnc.vencrypt_client_cert: 还必须设置

9.1.55. 临时解决方案

下表概述了 /etc/nova/nova.conf 文件中的 [workarounds] 组下可用的选项。

表 9.54. 临时解决方案
配置选项 = 默认值类型描述

disable_compute_service_check_for_ffu = False

布尔值

如果设置了此项,则旧计算服务的正常安全检查将被视为警告,而不是错误。这只是为了促进 Fast-Forward 升级,其中新的控制服务在计算节点能够更新其服务记录之前启动。在 FFU 中,数据库中的服务记录将超过一个版本,直到计算节点启动为止,但首先需要在线控制服务。

disable_deep_image_inspection = False

布尔值

这将禁用计算节点从 glance 下载时所执行的额外深度镜像检查。这包括将镜像传递给 qemu-img 的 backing-file、data-file 和 known-features 检测。通常,这个检查应该为最大安全性启用,但如果存在兼容性问题,这个临时解决方案选项允许禁用它。

disable_fallback_pcpu_query = False

布尔值

在使用固定实例时,禁用对 VCPU 分配的回退请求。

从 Train 开始,使用 libvirt virt 驱动程序的计算节点可能会报告 PCPU 清单,并将这用于固定实例。调度程序将自动使用与旧 CPU 固定相关的类别额外的 specs, hw:cpu_policyhw:cpu_thread_policy、其镜像元数据属性以及仿真程序线程固定类型额外的 spec, hw:emulator_threads_policy,将请求固定到新的放置请求。但是,计算节点需要额外的配置来报告 PCPU 清单,升级后可能不会立即存在此配置。为确保可在没有此额外配置的情况下创建固定实例,调度程序将发出第二个请求放置旧样式的 VCPU分配,并在需要时回退到这些分配候选。这对性能略有影响,不需要在所有主机上设置了新配置或升级新的部署。通过设置此选项,第二个查找被禁用,调度程序将仅请求基于 PCPU的分配。

弃用自:20.0.0

*reason:*None

disable_group_policy_check_upcall = False

布尔值

在 compute 中禁用服务器组策略检查 upcall。

为了检测使用服务器组关联性策略的争用,计算服务会尝试验证策略是否未被调度程序违反。它通过对 API 数据库进行调用,以列出服务器组中其正在启动的实例,这会违反我们的 api/cell 隔离目标。最终,通过调度程序和放置服务中的正确关联性保证可以解决这个问题,但之后需要进行此后检查以确保正确的关联性策略。

想要进行此检查的 api/cell 隔离应启用此标志的 Operator,这样可避免从计算中调用该标志。

相关选项:

  • [filter_scheduler]/track_instance_changes 还依赖于计算服务到调度程序服务的 upcalls。

disable_libvirt_livesnapshot = False

布尔值

使用 libvirt 驱动程序时禁用实时快照。

实时快照允许在不中断客户机的情况下进行磁盘的快照,与客户机代理一起使用以静止文件系统。

当使用 libvirt 1.2.2 实时快照在负载时失败(类似于并发 libvirt/qemu 操作)。此配置选项提供了一种机制来禁用实时快照,取代冷快照,同时解决这一问题。冷快照会在客户机完成快照过程中导致实例中断。

如需更多信息,请参阅错误报告:

https://bugs.launchpad.net/nova/+bug/1334398

可能的值:

  • true :使用 libvirt 时禁用实时快照
  • 错误:当快照进行时,始终使用实时快照(只要有新的足够 libvirt,后端存储支持它)

弃用自:19. 0.0

原因: 添加了这个选项以解决 libvirt 1.2.2 的问题。我们不再支持这个版本的 libvirt,这意味着不再需要这个临时解决方案。它将在以后的发行版本中被删除。

disable_rootwrap = False

布尔值

使用 sudo 而不是使用 rootwrap。

出于性能的原因,允许回退到 sudo。

如需更多信息,请参阅错误报告:

https://bugs.launchpad.net/nova/+bug/1415106

可能的值:

  • true :使用 sudo 而不是 rootwrap
  • false :通常使用 rootwrap

与其他选项的相互依存关系:

  • 所有影响 rootwrap 的选项都将被忽略。

enable_numa_live_migration = False

布尔值

启用使用 NUMA 拓扑的实例实时迁移。

使用 libvirt 驱动程序时,只有完全升级到 Train 的部署才支持使用 NUMA 拓扑的实例实时迁移。在以前的版本中,或在进行滚动升级的混合 Stein/Train 部署中,在使用 libvirt 驱动程序时默认禁用带有 NUMA 拓扑的实例实时迁移。这包括 CPU 固定或大页的实例实时迁移。目前没有重新计算此类实例的 CPU 固定和巨页信息,如 'bug footnote89064'_ 所述。这意味着,如果目标主机上已存在实例,迁移的实例可以放在与这些实例相同的专用内核中,或者使用为另一个实例分配的大页。另外,如果主机平台不是同构的,可以将实例分配给不存在的内核,或者在主机 NUMA 节点间意外分割。

尽管存在这些已知问题,但在某些情况下可能需要实时迁移。通过启用此选项,Operator 会了解问题,并愿意手动解决问题,从而为这些实例启用实时迁移支持。

相关选项:

弃用自:20.0.0

*reason:* 添加了这个选项,以便在使用 libvirt 驱动程序实时迁移带有 NUMA 拓扑的实例时缓解已知问题。这些问题在 Train 中解决。使用 libvirt 驱动程序的云,并完全升级到 Train 支持 NUMA 感知实时迁移。这个选项将在以后的发行版本中被删除。

enable_qemu_monitor_announce_self = False

布尔值

如果设置为 True,libvirt 驱动程序将尝试将宣布自己命令发送到 QEMU 监视器,以便生成 RARP 帧,以便在目的地后实时迁移阶段更新网络交换机。

请注意,这会导致域被 libvirt 视为污点。

相关选项:

  • :oslo.config:option:DEFAULT.compute_driver (libvirt)

ensure_libvirt_rbd_instance_dir_cleanup = False

布尔值

在使用 rbd 时,确保实例目录在清理过程中移除。

当启用此临时解决方案时,请确保使用 [libvirt]/images_type=rbd 在清理过程中删除实例目录。这可避免出现以下错误并恢复调整大小清理,导致主机上剩余的实例目录:

https://bugs.launchpad.net/nova/+bug/1414895

https://bugs.launchpad.net/nova/+bug/1761062

然后,当实例尝试返回主机时,这两个 bug 都可能会导致 DestinationDiskExists 错误。

  1. 警告:: Operator 需要确保实例目录本身(由 [DEFAULT]/instances_path 指定)在计算之间不会被共享,否则启用此临时解决方案,否则 console.log、内核、ramdisk 以及正在运行的实例使用的任何其他文件将会丢失。

相关选项:

  • compute_driver (libvirt)
  • [libvirt]/images_type (rbd)
  • instances_path

handle_virt_lifecycle_events = True

布尔值

启用处理从计算驱动程序发出的事件。

许多计算驱动程序会发出生命周期事件,它们是在实例启动或停止时发生的事件。如果实例因为 API 操作而完成任务状态更改,如调整大小,则忽略事件。

这是一个高级功能,允许虚拟机监控程序向计算服务发出意外状态更改的信号,并且实例可以自动关闭。不幸的是,这可能会在某些情况下竞争,例如在重启操作或计算服务或主机重启时(计划外或中断)。如果此类争用很常见,则建议禁用此功能。

当此功能被禁用并且 sync_power_state_interval 设置为负值时,应小心。在这种情况下,任何在虚拟机监控程序和 Nova 数据库之间同步的实例都必须手动同步。

如需更多信息,请参阅错误报告: https://bugs.launchpad.net/bugs/1444630

与其他选项的相互依存关系:

  • 如果 sync_power_state_interval 为负数,并且禁用此功能,则虚拟机监控程序和 Nova 数据库之间没有同步的实例必须手动同步。

libvirt_disable_apic = False

布尔值

当某些内核初始化客户机时,可能会导致内核挂起使客户机不可用。这是因为内核错误而发生。在大多数情况下,正确的修复会将客户机镜像内核更新至被修补的内核,但在某些情况下不可能。此临时解决方案允许模拟每个主机禁用,但不建议在 CI 或开发人员云之外使用。

never_download_image_if_on_rbd = False

布尔值

当从由 Ceph 支持的计算节点上的镜像引导时,如果镜像尚未驻留在 ceph 集群中(如果 glance 也使用相同的集群),nova 将从 glance 下载镜像并将其上传到 ceph 本身。如果使用多个 ceph 集群,这可能会导致 nova 意外地在本地 ceph 部署中以非COW 的方式复制镜像,这会浪费空间。

如需更多信息,请参阅错误报告:

https://bugs.launchpad.net/nova/+bug/1858877

启用此选项将导致 nova 在需要从 glance 下载镜像并将其上传到 ceph 本身时 拒绝 引导实例。

相关选项:

  • compute_driver (libvirt)
  • [libvirt]/images_type (rbd)

qemu_monitor_announce_self_count = 3

整数值

启用 enable_qemu_monitor_announce_self 时将 announce_self 命令发送到 QEMU monitor 的次数。

相关选项:

  • :oslo.config:option:WORKAROUNDS.enable_qemu_monitor_announce_self (libvirt)

qemu_monitor_announce_self_interval = 1

整数值

重新将 announce_self 命令重新发送到 QEMU 监控器前等待的秒数。

相关选项:

  • :oslo.config:option:WORKAROUNDS.enable_qemu_monitor_announce_self (libvirt)

reserve_disk_resource_for_image_cache = False

布尔值

如果设置为 True,则 libvirt 驱动程序将为镜像缓存中存储的镜像保留 DISK_GB 资源。如果 :oslo.config:option:DEFAULT.instances_path 位于与镜像缓存目录不同的磁盘分区中,则驱动程序不会为缓存保留资源。

这种磁盘保留由资源跟踪器中的定期任务完成,它每 :oslo.config:option:update_resources_interval 秒运行。因此,当镜像缓存时,保留不会立即更新。

相关选项:

  • :oslo.config:option:DEFAULT.instances_path
  • :oslo.config:option:image_cache.subdirectory_name
  • :oslo.config:option:update_resources_interval

skip_cpu_compare_at_startup = False

布尔值

这将跳过计算服务启动时的 CPU 比较调用,并允许 libvirt 处理它。

skip_cpu_compare_on_dest = False

布尔值

使用 libvirt 驱动程序时,在实时迁移过程中跳过将客户机 CPU 与目标主机进行比较。当使用 QEMU >= 2.9 和 libvirt >= 4.4.0 时,libvirt 将执行正确的操作,以便在实时迁移过程中检查目标主机上的 CPU 兼容性。

skip_hypervisor_version_check_on_lm = False

布尔值

启用后,它将在实时迁移过程中跳过虚拟机监控程序的版本检查。

skip_reserve_in_use_ironic_nodes = False

布尔值

如果您使用 Ironic 驱动程序,这可能很有用,但没有在 Ironic 中启用了自动清理。默认情况下,Nova 会将 Ironic 节点标记为保留(如果正在使用)。当您释放 Ironic 节点(通过删除 nova 实例)时,Nova 会取消保护该 Ironic 节点处于放置状态。通常这是个好主意,因为它避免在清理仍然被清理时将 Ironic 作为有效候选位置。无论您不使用自动清理功能,则可能会导致额外的延迟,并且 Ironic 节点可用于构建新的 Nova 实例。

unified_limits_count_pcpu_as_vcpu = False

布尔值

在使用统一限制时,请使用 VCPU + PCPU 进行 VCPU 配额使用量。

如果部署被配置为通过 [quota]driver=nova.quota.UnifiedLimitsDriver 使用统一限制,则默认情况下,VCPU 资源将独立于 PCPU 资源计算,这与放置服务中代表的方式一致。

传统的配额行为将 PCPU 计为 VCPU,并返回 VCPU + PCPU 使用量总和,作为 VCPU 的用量计数。依赖于 VCPU 和 PCPU 资源使用量计数的运算符应将此选项设置为 True。

相关选项:

  • :oslo.config:option:quota.driver

wait_for_vif_plugged_event_during_hard_reboot = []

列出值

libvirt virt 驱动程序通过关闭要重启的实例的每个 vif 来开启和硬重启,然后再次插入它们。默认情况下,nova 在允许实例运行前不会等待来自 neutron 的 network-vif-plugged 事件。这可能会导致实例通过 DHCP 请求 IP,然后 neutron 后端在 vif 插件后设置网络后端。

此标志定义 vifs nova 在硬重启期间预期 network-vif-plugged 事件发生。可能的值有 neutron 端口 vnic 类型:

  • normal
  • direct
  • macvtap
  • baremetal
  • direct-physical
  • virtio-forwarder
  • smart-nic
  • vdpa
  • accelerator-direct
  • accelerator-direct-physical
  • remote-managed

向此配置中添加 vnic_type 可使 Nova 等待每个实例的 vifs 在取消暂停实例之前具有特定的 vnic_type 的 vifs 等待 network-vif-plugged 事件具有特定的 vnic_type,这和新实例创建的工作方式类似。

请注意,并非所有 neutron 联网后端发送插件事件,对于某些 vnic_type,因此此配置默认为空。

ml2/ovs 和 networking-odl 后端已知为带有 普通 vnic_type 的端口发送插件时间事件,因此如果您仅在计算主机中使用这些后端,则可以安全地添加到此配置。

在插件过程中,neutron in-tree SRIOV 后端不会可靠地发送带有 直接 vnic_type 的端口的 network-vif-plugged 事件,且永远不会在插件过程中为带有 direct-physical vnic_type 的端口发送该事件。对于其他 vnic_type 和 backend 对,请咨询后端开发人员。

相关选项:

  • :oslo.config:option:DEFAULT.vif_plugging_timeout

9.1.56. wsgi

下表概述了 /etc/nova/nova.conf 文件中的 [wsgi] 组下可用的选项。

表 9.55. wsgi
配置选项 = 默认值类型Description

api_paste_config = api-paste.ini

字符串值

此选项代表 nova-api 的 paste.deploy 配置的文件名。

可能的值:

  • 代表 paste.deploy config 的文件名的字符串。

client_socket_timeout = 900

整数值

这个选项指定客户端连接套接字操作的超时时间。如果传入的连接闲置了这个秒数,它将被关闭。它表示套接字连接中单个读/写的超时。等待将ever 设置为 0。

default_pool_size = 1000

整数值

这个选项指定 wsgi 使用的 greenthreads 池的大小。可以使用这个选项限制并发连接数量。

keep_alive = True

布尔值

此选项允许使用相同的 TCP 连接来发送和接收多个 HTTP 请求/响应,而不是为每个请求/响应对打开一个请求/响应。HTTP keep-alive 表示 HTTP 连接重复使用。

可能的值:

  • true :重复使用 HTTP 连接。
  • false :明确关闭客户端套接字连接。

相关选项:

  • tcp_keepidle

max_header_line = 16384

整数值

此选项指定要接受的最大消息标头大小。在使用大型令牌时,可能需要增加 max_header_line (通常是由 Keystone v3 API 带有大型服务目录生成的)。

由于 TCP 是基于流的协议,为了重复利用连接,HTTP 必须有办法来指示前一个响应的末尾和接下来的开始。因此,在 keep_alive 情况下,所有消息都必须具有自我定义的消息长度。

secure_proxy_ssl_header = None

字符串值

这个选项指定用于确定原始请求的协议方案的 HTTP 标头,即使它已被 SSL 终止代理删除。

可能的值:

  • none (默认)- 请求方案不受任何 HTTP 标头的影响
  • 有效的 HTTP 标头,如 HTTP_X_FORWARDED_PROTO
警告

除非您知道操作是什么,否则不要设置此项。

在设置它前,请确保以下所有都为 true (假设上例中的值):

  • 您的 API 位于代理后面。
  • 您的代理从所有传入的请求中剥离 X-Forwarded-Proto 标头。换句话说,如果最终用户在其请求中包含该标头,代理会丢弃它。
  • 您的代理设置 X-Forwarded-Proto 标头并将其发送到 API,但只适用于最初通过 HTTPS 传入的请求。

如果其中任何一个不是 true,您应该将此设置为 None。

ssl_ca_file = None

字符串值

此选项允许设置应用来验证连接的客户端的 CA 证书文件的路径。

可能的值:

  • 代表 CA 证书文件的路径的字符串。

相关选项:

  • enabled_ssl_apis

ssl_cert_file = None

字符串值

此选项允许设置 API 服务器的 SSL 证书的路径。

可能的值:

  • 代表 SSL 证书的路径的字符串。

相关选项:

  • enabled_ssl_apis

ssl_key_file = None

字符串值

此选项指定在 SSL 生效时存储 API 服务器的 SSL 私钥的文件的路径。

可能的值:

  • 代表 SSL 私钥的路径的字符串。

相关选项:

  • enabled_ssl_apis

tcp_keepidle = 600

整数值

这个选项为每个服务器套接字设置 TCP_KEEPIDLE 的值(以秒为单位)。它指定保持连接活跃的时间持续时间。TCP 为请求保持连接活跃的应用生成 KEEPALIVE 传输。OS X 不支持。

相关选项:

  • keep_alive

wsgi_log_format = %(client_ip) s "%(request_line) s" status: %(status_code) s len: %(body_length) s time: %(wall_seconds).7f

字符串值

它代表一个 python 格式字符串,用作模板来生成日志行。以下值可以格式化成: client_ip, date_time, request_line, status_code, body_length, wall_seconds。

此选项用于在 eventlet 下运行 nova-api 时构建自定义请求日志。如果在 uwsgi 或 apache 下使用,这个选项无效。

可能的值:

  • %(client_ip) s "%(request_line) s" status: %(status_code) s 'len: %(body_length) s time: %(wall_seconds).7f (default)
  • 任何由特定值形成的格式化字符串。

弃用自:16.0.0

原因: 此选项仅在 eventlet 下运行 nova-api 时有效,并对非常 eventlet 的特定信息进行编码。从 Pike 开始,运行 nova-api 的首选模型位于 uwsgi 或 apache mod_wsgi 下。

9.1.57. zvm

下表概述了 /etc/nova/nova.conf 文件中的 [zvm] 组下可用的选项。

表 9.56. zvm
配置选项 = 默认值类型Description

ca_file = None

字符串值

要在启用了 TLS 的 httpd 服务器中验证的 CA 证书文件

字符串,它必须是 CA 捆绑包使用的路径。

cloud_connector_url = None

URI 值

用于与 z/VM Cloud Connector 通信的 URL。

image_tmp_path = $state_path/images

字符串值

将存储镜像的路径(快照、部署等)。

用于部署和通过快照捕获的镜像需要存储在计算主机的本地磁盘中。此配置标识目录位置。

可能的值:运行计算服务的主机上的文件系统路径。

reachable_timeout = 300

整数值

等待实例启动超时(秒)。

z/VM 驱动程序依赖于实例和云连接器之间的通信。创建实例后,必须有足够的时间来等待所有网络信息写入用户目录中。该驱动程序将使用超时值重新检查实例网络状态,如果设置网络失败,它将通知用户启动实例失败并将实例置于 ERROR 状态。然后会删除底层 z/VM 客户机。

可能的值:任何正整数。建议至少为 300 秒(5 分钟),但会因实例和系统负载而异。值 0 用于 debug。在这种情况下,当实例标记为 ERROR 状态时,底层 z/VM 客户机不会被删除。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.