搜索

第 9 章 nova

download PDF

以下章节包含有关 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。

arq_binding_timeout = 300

整数值

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

等待 ARQ 绑定解析事件到达的秒数。事件表示实例的每个 ARQ 都绑定成功或无法绑定。如果没有到达,则实例启动会中止,但有一个例外。

backdoor_port = None

字符串值

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

backdoor_socket = None

字符串值

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

block_device_allocate_retries = 60

整数值

在服务器创建过程中附加卷前检查卷的次数。

当使用块设备映射创建服务器时,其中 source_type空白镜像 或快照target_typenova-compute 服务将创建一个卷,然后将其附加到服务器。在卷可以被附加前,它必须处于 "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
  • powervm.PowerVMDriver
  • zvm.ZVMDriver

compute_monitors = []

列表值

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

注意

每次只能载入每个命名空间的一个监控器(例如:cpu)。

可能的值:

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

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

config_drive_format = iso9660

字符串值

配置驱动器格式。

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

相关选项:

  • 当出现以下备选方法之一时,这个选项是有意义的:

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

弃用自:19. 0.0

原因: 此选项最初作为 libvirt 中 bug 的临时解决方案,即在 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 等其他服务。

可能的值:

  • true :注册自身后,每个新计算服务都会启用。
  • false :计算服务必须通过 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

布尔值

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

可能的值:

  • 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

整数值

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

每个计算节点运行任务的时间(以秒为单位)查询其所有实例网络信息,然后使用该信息更新 Nova db。如果此选项设为 0,Nova 永远不会更新它的缓存。如果没有更新缓存,元数据服务和 nova-api 端点将代理与实例相关的网络数据。因此,不建议将这个选项设置为 0。

可能的值:

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

Host = <based on operating system>

字符串值

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

用作:

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

在 AMQP 密钥中必须有效。

可能的值:

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

initial_cpu_allocation_ratio = 16.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.5

浮点值

初始虚拟 RAM 与物理 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 模板引擎呈现,并接收名为 接口 的顶级密钥。此键将包含一个字典列表,每个接口对应一个。

如需更多信息,请参阅 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 :禁用该选项。
  • 任何正整数(以秒为单位)。

相关选项:

  • 来自 instance_cleaning_opts 组中的 maximum_instance_delete_attempts

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

字符串值

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

instance_name_template = instance-%08x

字符串值

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

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

可能的值:

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

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 [%(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 %(tenant) s %(domain) 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 调用操作:

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

相关选项:

  • 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 表示尝试创建本地磁盘的任何请求都将失败。这个选项旨在限制本地磁盘的数量(因此,root 本地磁盘是创建服务器时使用的 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

整数值

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

可能的值:

  • if == -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

可能的值:

  • 以逗号分隔的列表,其项是镜像属性。通常,此处只能包含基础镜像所需的镜像属性,因为从基础镜像创建的快照不需要它们。
  • 默认列表: 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' 错误。唯一性区分大小写。设置此选项可以提高最终用户的可用性,因为他们不必通过 ID 来区分具有相同名称的实例。

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 代理。与 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_typeauth_urlusername 等。由于重新声明发生在定期任务中,因此没有用户令牌清理附加到任何 SOFT_DELETED 服务器的卷,因此 nova 必须配置有管理员角色访问权限来清理 cinder 中的这些资源。

可能的值:

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

相关选项:

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

record = None

字符串值

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

report_interval = 10

整数值

指示给定虚拟机监控程序上服务状态的频率(以秒为单位)。Nova 需要知道这一点以确定部署的整体健康状况。

相关选项:

  • service_down_time report_interval 应该小于 service_down_time。如果 service_down_time 小于 report_interval,则服务通常会被视为 down,因为它们很少报告。

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 的调度程序。要防止磁盘资源被视为可用,可以使用此选项为该主机保留磁盘空间。

可能的值:

  • 任何正整数,代表主机保留的磁盘数量(以 MB 为单位)。

reserved_host_memory_mb = 512

整数值

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

可能的值:

  • 任何正整数,代表主机保留的内存量(以 MB 为单位)。

reserved_huge_pages = None

dict 值

每个 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 秒后自动确认调整大小。

调整大小的功能将在调整大小前保存现有服务器。在调整大小完成后,要求用户确认调整大小。用户有机会确认或恢复所有更改。确认调整大小会删除原始服务器,并将服务器状态从 resized 改为 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 包装器的目标是允许特定于服务的非特权用户以安全的方式以 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

整数值

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

可能的值:

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

相关选项:

  • "running_deleted_instance_action"

scheduler_instance_sync_interval = 120

整数值

发送调度程序当前实例 UUID 列表之间的间隔,以验证其实例视图是否与 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 守护进程的计算 worker 启动时,它会调用 join API 来加入 compute 组。nova 调度程序等服务可以查询 ServiceGroup API 来检查节点是否处于活动状态。在内部,ServiceGroup 客户端驱动程序会自动更新计算 worker 状态。该服务有多个后端实现: Database ServiceGroup 驱动程序和 Memcache ServiceGroup 驱动程序。

相关选项:

  • service_down_time (自上次检查以来为 up 服务提供最大时间)

shelved_offload_time = 0

整数值

她的实例前的时间有资格从主机移除。

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

可能的值:

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

shelved_poll_interval = 3600

整数值

轮询 sheed 实例以卸载的间隔。

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

可能的值:

  • any value criu 0 :禁用选项。
  • 任何正整数(以秒为单位)。

相关选项:

  • shelved_offload_time

shutdown_timeout = 60

整数值

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

它决定虚拟机执行干净的整个期间(以秒为单位)。在执行 stop、rescue 和 shelve 重建操作时,配置此选项可让虚拟机在实例关闭前执行受控关闭。默认超时为 60 秒。值 0 (零)表示客户机将立即关闭,且对 guest OS 清理没有机会。

超时值可以基于每个镜像覆盖,方法为 os_shutdown_timeout,它是一个镜像元数据设置,允许不同类型的操作系统指定需要完全关闭的时间。

可能的值:

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

source_is_ipv6 = False

布尔值

如果源主机使用 IPv6 寻址,则设置为 True。

ssl_only = False

布尔值

不允许非加密连接。

相关选项:

  • cert
  • key

state_path = $pybasedir

字符串值

维护 Nova 状态的顶级目录。

此目录用于存储 Nova 的内部状态。它被从此派生的不同其他配置选项使用。在某些情况下(如迁移)使用在多个计算主机(例如通过 NFS)之间共享的存储位置有意义。除非选项 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

整数值

可用于同步电源状态的绿色线程数。

此选项可用于减少对 hypervisor 或系统发出的并发请求数量,并出于性能原因(例如,使用 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 periodic 任务应运行的频率。小于 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

布尔值

启用使用写时复制(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 数字范围,或者后面有一个要排除的 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 in "daemon mode"。

相关选项:

  • vif_plugging_is_fatal - 如果 vif_plugging_timeout 被设置为零,vif_plugging_is_fatal 为 False,则事件不应该被完全到达。

virt_mkfs = []

多值

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

格式为 <os_type>=<mkfs 命令>

volume_usage_poll_interval = 0

整数值

收集卷使用情况的时间间隔。

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

可能的值:

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

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

字符串值

此字符串前面带有到 OpenStack Compute API 链接返回的普通 URL。如果为空(默认),则 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-style 元数据。从 crun 发行版本开始,可用版本有:

  • 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 的域名。

为实例主机名配置完全限定域名。如果未设置,则只配置没有域的主机名。

可能的值:

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

enable_instance_password = True

布尔值

启用通过相关服务器 API 调用返回实例密码,如创建、重建、撤离或救援。如果虚拟机监控程序不支持密码注入,则返回的密码将不正确,因此如果您的虚拟机监控程序不支持密码注入,则将其设置为 False。

glance_link_prefix = None

字符串值

此字符串前面带有到 Glance 资源链接返回的普通 URL。如果为空(默认),则 URL 会以保持不变。

可能的值:

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

instance_list_cells_batch_fixed_size = 100

整数值

如果 instance_list_cells_batch_strategy' 设置为 固定,则控制从每个单元数据库请求的实例的批处理大小。此完整值将定义在每次请求批处理实例时为每个单元发出的限制,无论系统中的单元数或其他因素如何。根据 instance_list_cells_batch_strategy 文档中的调用的一般逻辑,每个批处理的最小值是 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 数据库中进行额外的(fast)查询,但也(可能)限制必须查询的单元数据库数量以提供结果。如果您有少量单元,或者租户可能在所有单元中都有实例,则这应该是 False。如果您有很多单元,特别是如果您将租户限制为这些单元的一小部分,则这应该是 True。

list_records_by_skipping_down_cells = True

布尔值

当设置为 False 时,如果基础架构故障(如不响应的单元格)时,这会导致 API 返回一个 500 错误。如果您希望 API 跳过 down 单元,并从 up cells 设置这个选项设置为 True 时返回结果。

请注意,在 API microversion 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 sanitizing 代理时才应启用它。

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 失败是否对实例启动是致命的?

相关选项:

  • 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 捆绑包的路径,用于验证动态厂商数据 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

字符串值

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

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

可能的值:

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

vendordata_providers = ['StaticJSON']

列表值

vendordata 供应商列表。

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

有关实施 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

connection = None

字符串值

用于连接到数据库的 SQLAlchemy 连接字符串。不要为 nova-compute 服务设置它。

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。

max_overflow = None

整数值

如果设置,请将这个值用于 SQLAlchemy 的 max_overflow。

max_pool_size = None

整数值

在池中保留的最大 SQL 连接数。将值设为 0 表示没有限制。

max_retries = 10

整数值

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

mysql_sql_mode = TRADITIONAL

字符串值

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

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

number_of_retries = 60

整数值

在创建密钥时重试轮询的次数

retry_delay = 1

整数值

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

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. 缓存

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

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

backend = dogpile.cache.null

字符串值

缓存后端模块。对于具有数百个线程服务器的基于 eventlet 的环境,建议使用带有池(oslo_cache.memcache_pool)的 Memcache。对于小于 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 后端的套接字 keepalive 的全局切换

enabled = False

布尔值

缓存的全局切换。

expiration_time = 600

整数值

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

hashclient_retry_attempts = 2

整数值

在客户端标记为死前应尝试的次数,并在 HashClient 的内部机制中从池中删除。

hashclient_retry_delay = 1

浮点值

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

memcache_dead_retry = 300

整数值

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

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 backend)。

memcache_pool_unused_timeout = 60

整数值

到 memcached 的连接在池关闭前没有被使用的秒数。(仅oslo_cache.memcache_pool 后端)。

memcache_servers = ['localhost:11211']

列表值

memcache 服务器格式为 "host:port"。(dogpile.cache.memcached 和 oslo_cache.memcache_pool 后端)。如果给定主机引用 IPv6 或给定域,则您应该为给定地址系列(inet6) (inet6) (inet6) ( inet6[::1]:11211,inet6:[fd12:3456:789a:1::1]:11211,inet6:[controller-0.internalapi]:11211)作为前缀。如果未提供地址系列,则使用的默认地址系列将是 inet (对应于 IPv4)

memcache_socket_timeout = 1.0

浮点值

每次对服务器调用的超时时间(以秒为单位)。(dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。

proxies = []

列表值

用于导入的代理类会影响 dogpile.cache 后端功能的方式。有关 change-backend-behavior 的 dogpile.cache 文档。

retry_attempts = 2

整数值

在失败前尝试操作的次数。

retry_delay = 0

浮点值

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

socket_keepalive_count = 1

整数值

在丢弃连接前,保持 TCP 的最大 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.6. cinder

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

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

auth-url = None

字符串值

身份验证 URL

auth_section = None

字符串值

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

auth_type = None

字符串值

要加载的身份验证类型

cafile = None

字符串值

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

catalog_info = volumev3::publicURL

字符串值

在服务目录中查找 cinder 时匹配的信息。

& 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

布尔值

允许在不同可用区中的实例和卷之间附加。

如果 False,与 Nova 中的实例可用区的 Cinder 中必须位于同一可用区中的卷。

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

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

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

相关选项:

  • [DEFAULT]/default_schedule_zone

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.7. Compute

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

表 9.6. 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 时,将在以后的版本中简化此行为。

可能的值:

  • 以逗号分隔的物理 CPU 号列表,实例 VCPU 可以从中分配。每个元素应该是单个 CPU 号、一个 CPU 数字范围,或者后面有一个要排除的 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 时,将在以后的版本中简化此行为。

可能的值:

  • 以逗号分隔的物理 CPU 号列表,实例 VCPU 可以从中分配。每个元素应该是单个 CPU 号、一个 CPU 数字范围,或者后面有一个要排除的 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)网络服务的 network-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: if live_migration_wait_for _vif_plug_timeout 为 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

整数值

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

max_disk_devices_to_attach = -1

整数值

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

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

在托管服务器的计算服务上更改 [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. 警告:如果此选项设为 0,nova-compute 服务将无法启动,因为 0 磁盘设备是一个无效的配置,导致实例无法启动。

可能的值:

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

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.8. conductor

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

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

Worker = None

整数值

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

9.1.9. 控制台

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

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

allowed_origins = []

列表值

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

可能的值:

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

ssl_ciphers = None

字符串值

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

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

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

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

相关选项:

  • [DEFAULT] cert
  • [DEFAULT] key

ssl_minimum_version = default

字符串值

允许的 SSL/TLS 协议版本。

相关选项:

  • [DEFAULT] cert
  • [DEFAULT] key

9.1.10. consoleauth

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

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

token_ttl = 600

整数值

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

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

9.1.11. CORS

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

表 9.10. 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.12. cyborg

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

表 9.11. 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.13. database

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

表 9.12. 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)的支持。

mysql_sql_mode = TRADITIONAL

字符串值

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

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 调用的线程池的实验性使用

9.1.14. devices

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

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

enabled_vgpu_types = []

列表值

计算节点上启用 vGPU 类型。

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

如果提供多个 vGPU 类型,则必须将每个 vGPU 类型 额外部分 [vgpu_$(VGPU_TYPE)] 添加到配置文件中。然后,每个部分 都必须使用 单一配置选项 device_addresses 配置,这是分配给此类型的 PCI 地址列表。

如果缺少一个或多个部分(因为特定类型并不想用于至少一个物理 GPU),或者未提供设备地址,则 Nova 将只使用由 [devices]/enabled_vgpu_types 提供的第一个类型。

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

示例如下

[devices] enabled_vgpu_types = nvidia-35, nvidia-36

[vgpu_nvidia-35]
device_addresses = 0000:84:00.0,0000:85:00.0
[vgpu_nvidia-36]
device_addresses = 0000:86:00.0

9.1.15. ephemeral_storage_encryption

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

表 9.14. 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.16. filter_scheduler

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

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

aggregate_image_properties_isolation_namespace = None

字符串值

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

可以配置镜像和主机,以便某些镜像只能调度到特定聚合中的主机。这使用通过以此选项值开头的主机聚合上设置的元数据值完成。如果主机是带有此类元数据键的聚合的一部分,则请求 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 - 必须st 为零,以便计算报告此 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 的倍数比率。正值表示,eigher 将优先选择实例当前运行的同一单元中的主机。负值意味着,在实例当前运行的 其他 单元中首选主机。

相关选项:

  • [filter_scheduler] weight_classes

disk_weight_multiplier = 1.0

浮点值

磁盘权重多器比率。

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

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

可能的值:

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

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

列表值

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

用于过滤主机的过滤类名称的有序列表。这些过滤器将按照列出的顺序应用,以便首先将限制性最严格的过滤器放在最严格的过滤器中,以便提高过滤过程的效率。

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

可能的值:

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

相关选项:

  • [filter_scheduler] available_filters

host_subset_size = 1

整数值

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

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

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

可能的值:

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

hypervisor_version_weight_multiplier = 1.0

浮点值

虚拟机监控程序版本权重比率。

倍数用于根据报告的 hypervisor 版本对主机进行权重。负数表示首选使用较旧的主机,默认为首选较新的主机来协助升级。

可能的值:

  • 整数或浮点值,其中值对应于此 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 influence

    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 操作权重多器比率。

这个选项决定了具有不同工作负载的主机是如何权衡的。负值(如默认值)将导致调度程序首选使用更轻量的工作负载的主机,而正值将首选具有高度工作负载的主机。查看它的另一个方法是此选项的正值会将实例调度到已经忙碌的主机上,而负值则往往在更多主机之间分发工作负载。绝对值(无论是正还是负)控制 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 过滤器时影响调度。

可能的值:

  • 整数,其中整数对应于主机上可调度的最大实例。

相关选项:

  • [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_weight_multiplier = 1.0

浮点值

PCI 设备关联性权重倍数.

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

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

可能的值:

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

相关选项:

  • [filter_scheduler] weight_classes

ram_weight_multiplier = 1.0

浮点值

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 (默认),但有大量的主机具有相同的 maximal weight 时,启用它很有用。在 Ironic 部署中,这种场景很常见,其中通常有很多裸机节点返回了相同的权重。在这种情况下,启用这个选项会减少重新调度事件的争用和机会。同时,它将使实例打包(即使在未权衡的情况下)会减少密度。

soft_affinity_weight_multiplier = 1.0

浮点值

用于权衡主机用于组软关联性的倍数。

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

可能的值:

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

相关选项:

  • [filter_scheduler] weight_classes

soft_anti_affinity_weight_multiplier = 1.0

浮点值

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

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

可能的值:

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

相关选项:

  • [filter_scheduler] weight_classes

track_instance_changes = True

布尔值

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

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

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

  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 通过添加到或从之前所分配给的权重来对这些主机进行排序。权重可能会成为负数。实例将调度到 N 个最轻量级主机之一,其中 N 是 [filter_scheduler] host_subset_size

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

可能的值:

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

9.1.17. Glance

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

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

api_servers = None

列表值

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

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

注意

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

可能的值:

  • 任何以 "scheme://hostname:port[/path]" (如 "http://10.0.1.0:9292" 或 "https://my.glance.server/image")格式的完全限定域名。

弃用自: 21.0.0

reason: 在 17.0.0 Queens 发行版本中添加了标准 keystoneauth1 Adapter 选项支持镜像服务配置。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

布尔值

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

允许计算主机直接从 Ceph 下载和缓存镜像,而不是从 Glance API 中下载并缓存操作速度。这可能会使下载几十到几百 GB 镜像所需的时间从几十分钟减少到及十秒,但这需要基于 Ceph 的部署并需要可以从计算节点访问到 Ceph。

相关选项:

  • [glance] rbd_user
  • [glance] rbd_connect_timeout
  • [glance] rbd_pool
  • [glance] rbd_ceph_conf

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 配置文件的路径。

相关选项:

  • 只有在 [glance] enable_rbd_download 设为 True 时才会使用此选项。

rbd_connect_timeout = 5

整数值

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

相关选项:

  • 只有在 [glance] enable_rbd_download 设为 True 时才会使用此选项。

`rbd_pool = `

字符串值

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

相关选项:

  • 只有在 [glance] enable_rbd_download 设为 True 时才会使用此选项。

`rbd_user = `

字符串值

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

相关选项:

  • 只有在 [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.18. guestfs

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

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

debug = False

布尔值

启用/禁用 guestfs 日志记录。

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

相关选项:

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

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

9.1.19. healthcheck

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

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

backends = []

列表值

可执行健康检查并报告该信息作为请求的一部分的其他后端。

detailed = False

布尔值

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

disable_by_file_path = None

字符串值

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

disable_by_file_paths = []

列表值

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

path = /healthcheck

字符串值

响应 healtcheck 请求的路径。

9.1.20. hyperv

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

表 9.19. 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

布尔值

将密码注入配置驱动器。

启用后,可以从配置驱动器镜像获取 admin 密码。

相关选项:

  • 这个选项与启用 Hyper-V 的 config 驱动器使用情况的其他选项(如 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 虚拟化功能的 DirectX 11 功能。

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

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

3840x2160 仅在 Windows / Hyper-V Server 2016 中提供。

OS:monitor.客户机虚拟机监控器数。可接受值
[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)。

相关选项:

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

power_state_check_timeframe = 60

整数值

电源状态检查时间线

检查实例电源状态变化的时间线。此选项用于通过 WMI 接口在指定时间段内从 Hyper-V 获取实例状态。

可能的值:

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

power_state_event_polling_interval = 2

整数值

电源状态事件轮询间隔

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

可能的值:

  • 以秒为单位的时间(默认: 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 环境变量(默认)。
  • 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.21. image_cache

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

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

manager_interval = 2400

整数值

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

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

可能的值:

  • 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.22. ironic

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

表 9.21. 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.23. key_manager

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

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

auth_type = None

字符串值

要创建的身份验证凭证的类型。可能的值有 令牌密码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

字符串值

进行身份验证的用户名。password auth_type 需要。keystone_password auth_type 是可选的。

9.1.24. Keystone

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

表 9.23. Keystone
配置选项 = 默认值类型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 = identity

字符串值

端点 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.25. keystone_authtoken

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

表 9.24. 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" ),但如果绑定类型未知,则令牌将被拒绝。"必需"令牌绑定需要允许任何形式的令牌绑定。最后,令牌中必须存在的绑定方法名称。

http_connect_timeout = None

整数值

请求超时值与身份 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 服务器被视为 dead 的秒数。

memcache_pool_maxsize = 10

整数值

(可选)到每个 memcached 服务器的最大打开连接数。

memcache_pool_socket_timeout = 3

整数值

(可选)与 memcached 服务器通信的套接字超时(以秒为单位)。

memcache_pool_unused_timeout = 60

整数值

(可选)与 memcached 的连接在池关闭前未使用的秒数。

memcache_secret_key = None

字符串值

(可选,如果定义了 memcache_security_strategy )此字符串用于密钥派生。

memcache_security_strategy = None

字符串值

(可选)如果定义,则指示令牌数据是否应进行身份验证或加密。如果 MAC,令牌数据在缓存中进行身份验证(使用 HMAC)。如果 ENCRYPT,令牌数据会在缓存中加密并进行身份验证。如果该值不是这些选项之一或为空,则 auth_token 会在初始化时引发异常。

memcache_use_advanced_pool = False

布尔值

(可选)使用 advanced (事件安全)memcached 客户端池。高级池只能在 python 2.x 下工作。

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.26. libvirt

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

表 9.25. 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 将禁用客户机的 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 配置属性)、host-models 配置属性指定显式 CPU 模型、host-modelhost-passthrough

在某些情况下,您可能需要为 host-passthrough CPU 模式配置额外的 CPU 标志,因为有时 QEMU 可能会禁用某些 CPU 功能。例如,Intel 的"invtsc" (Invariable Time Stamp Counter) CPU 标记是,您需要将此标志公开给 Nova 实例,您需要明确启用它。

cpu_model_extra_flags 的可能值取决于使用的 CPU 型号。有关给定 CPU 模型的可能 CPU 功能标记,请参阅 /usr/share/libvirt/cpu_mapVRF.xml

特定 CPU 标记的特别备注:pcid (在应用 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 的上下文中,这些 CPU 模式(host-modelhost-passthrough)不需要使用 cpu_model_extra_flags

相关选项:

  • cpu_mode
  • cpu_models

cpu_models = []

列表值

主机支持的 CPU 模型列表。

列表应该被排序,以便在前面列出更常见的和不太高级 CPU 型号。以下是一个示例:SandyBridge ,IvyBridge,Haswell,Broadwell,后者的 CPU 模型的功能更丰富的了以前的 CPU 模型。

可能的值:

  • 命名的 CPU 模型可以通过 virsh cpu-models ARCH 找到,其中 ARCH 是您的主机架构。

相关选项:

  • cpu_mode :当您要配置(通过 cpu_models)特定名为 CPU 模型时,应将其设置为 custom。否则,这会导致错误,实例启动将失败。
  • virt_type :只有虚拟化类型 kvmqemu 使用此方法。

    1. 注意:请小心,仅指定可以在硬件中完全支持的型号。

device_detach_attempts = 8

整数值

驱动程序尝试在 libvirt 中分离设备的最大尝试次数。

相关选项:

  • :oslo.config:option:libvirt.device_detach_timeout

device_detach_timeout = 20

整数值

驱动程序等待成功或 libvirt 的失败事件在重新触发分离前尝试的最大秒数。

相关选项:

  • :oslo.config:option:libvirt.device_detach_attempts

disk_cachemodes = []

列表值

用于不同磁盘类型的特定缓存模式。

例如: file=directsync,block=none,network=writeback

对于本地或直接附加存储,建议您使用 writethrough (默认)模式,因为它确保数据完整性,并为客户机中运行的应用程序具有可接受的 I/O 性能,特别是读操作。但是,对于远程 NFS 存储,建议使用缓存模式,因为直接 I/O 操作(O_DIRECT)的性能优于同步 I/O 操作(使用 O_SYNC)。缓存模式不会有效地将所有客户机 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 性能很好,但数据在电源故障时不受保护。因此,建议只针对潜在的数据丢失的临时数据进行这个缓存模式。注意:包含后端磁盘机制可以提供安全回写缓存语义。专门用于绕过主机页面缓存,如 QEMU 的集成式 RBD 驱动程序。Ceph 文档建议将其设置为 writeback 以获得最大性能,同时保持数据安全性。
  • directsync :与"writethrough"类似,但它绕过主机页面缓存。
  • insecure:不安全缓存模式可完全忽略缓存传输操作。由于其名称意味着,此缓存模式应该只用于数据丢失的临时数据。这个模式可用于加快客户机安装,但您应该在生产环境中切换到另一个缓存模式。

disk_prefix = None

字符串值

覆盖附加到实例的设备的默认磁盘前缀。

如果设置,这将用来识别总线的可用磁盘空间名称。

可能的值:

  • 任何生成有效磁盘设备名称(如 sdahda )的前缀,例如:只有在设备名称与虚拟化类型的常用设备名称前缀不同(如 sd、xvd、uvd、vd)时才需要。

相关选项:

  • virt_type :使用哪个设备类型,这决定了默认的磁盘前缀。

enabled_perf_events = []

列表值

监视和收集统计数据的性能事件。

这将允许您指定事件列表来监控客户机的低级别性能,并通过 libvirt 驱动程序收集相关统计信息,后者又使用 Linux 内核的 perf 基础架构。设置此配置属性后,Nova 将生成 libvirt 客户机 XML 来监控指定的事件。

例如,要监控 CPU 周期(total/elapsed)和缓存未命中的计数,请按如下所示启用它们:

[libvirt]
enabled_perf_events = cpu_clock, cache_misses

可能的值:字符串列表。支持的事件列表包括在 这里'__。请注意,Intel CMT 事件 - 'cmtmbmbtmbml - 由最新的 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 受管磁盘的丢弃选项。

需要:

  • 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

整数值

要求将镜像复制到本地 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 - 控制故障 time-to-notice

`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 especially 禁用数据的注入。
  • -1 jpeg 查找使用 libguestfs 挂载的文件系统的根分区
  • 0 omitted the image is not partitioned
  • >0 TOKEN 用于注入的分区数量

仅限 Linux 发行版客户机。

相关选项:

  • inject_key :如果此选项允许注入它依赖于值大于或等于 -1 (用于 inject_partition )的 SSH 密钥。
  • inject_password :如果此选项允许注入 admin 密码,它依赖于值大于或等于 -1 (用于 inject_partition )。
  • [guestfs]/debug 您可以使用这个配置选项启用 debug 日志级别 libguestfs。调试问题时将有更详细的输出帮助。
  • virt_type :如果您使用 lxc 作为 virt_type,它将被视为单个分区镜像

inject_password = False

布尔值

仅允许在创建和重新构建过程中为实例注入管理员密码。

镜像中不需要代理来执行此操作。如果主机上的 libguestfs 可用,它将被使用。否则会使用 nbd。镜像的文件系统将被挂载,以及 REST API 调用中提供的 admin 密码,该密码将作为 root 用户的密码注入。如果没有 root 用户可用,实例将不会启动,并且抛出错误。请注意,当实例从卷启动时,无法 注入。

仅限 Linux 发行版客户机。

可能的值:

  • true :允许注入。
  • false :不允许注入。任何通过 REST API 提供的 admin 密码都会静默忽略。

相关选项:

  • inject_partition :此选项将决定文件系统的发现和使用。它还可以禁用注入。

iscsi_iface = None

字符串值

如果需要卸载支持,用于连接到目标的 iSCSI 传输 iface。

默认格式为 < transport_name>.<hwaddress& gt;,其中 <transport_name > 是接口之一(be2iscsi,bnx2i,cxgb3i,cxgb4i,qla4xxx,ocs,tcp)和 < hwaddress > 是接口的 MAC 地址,可以通过 iscsiadm -m iface 命令生成。不要将 iscsi_iface 参数与实际传输名称混淆。

iser_use_multipath = False

布尔值

使用 iSER 卷的多路径连接。

iser 卷可以连接为多路径设备。这将提供高可用性和容错功能。

live_migration_bandwidth = 0

整数值

迁移期间使用的最大带宽(单位 MiB/s)。

如果设置为 0,则虚拟机监控程序将选择合适的默认值。有些虚拟机监控程序不支持此功能,如果带宽不是 0,则返回错误。详情请查看 libvirt 文档。

live_migration_completion_timeout = 800

整数值

迁移在中止操作前成功完成传输数据的时间(以秒为单位)。

值是每个要传输的客户机 RAM + 磁盘,其绑定至少为 2 GiB。通常应该大于停机延迟 * 停机时间步骤。设置为 0 以禁用超时。

相关选项:

  • live_migration_downtime
  • live_migration_downtime_steps
  • live_migration_downtime_delay

live_migration_downtime = 500

整数值

实时迁移切换的最大允许停机时间(以毫秒为单位)。

将向上舍入到至少 100ms。如果要允许实时迁移更快地完成,或者通过允许客户机暂停以更长时间进行实时迁移切换期间,您可以增加这个值。

相关选项:

  • live_migration_completion_timeout

live_migration_downtime_delay = 75

整数值

迁移停机时间增加每个步骤之间等待的时间(以秒为单位)。

最小延迟为 3 秒。值是每个要传输的客户机 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 的版本不可用时,才会使用自动聚合。

相关选项:

  • live_migration_permit_post_copy

live_migration_permit_post_copy = False

布尔值

这个选项允许 nova 将当前实时迁移切换到 post-copy 模式,即,在迁移完成前,将活动虚拟机切换到目标节点上的一个大小,从而确保需要传输的内存上的上限。post-copy 需要 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 模式不可用,则强制完全回退到暂停虚拟机,以确保实时迁移操作完成。

使用 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 迁移标志,避免了需要配置网络,以允许直接 hypervisor 到 hypervisor 通信。如果为 False,请使用原生传输。如果没有设置,Nova 将根据在虚拟机监控程序中选择本地加密支持的可用性。启用此选项会绝对影响性能。

请注意,这个选项与块迁移的使用不兼容。

弃用自: 23.0.0

原因: "tunnelled 实时迁移"有两个固有的限制:它无法处理非共享存储设置中的磁盘的实时迁移;它具有巨大的性能成本。这两个问题都由 ''live_migration_with_native_tls''(需要预先配置的 TLS 环境)解决,这是保护所有实时迁移流的建议方法。

live_migration_uri = None

字符串值

实时迁移流量源使用的实时迁移目标 URI。

覆盖默认的 libvirt 实时迁移目标 URI (依赖于 virt_type)。任何包含的"%s"都会被迁移目标主机名替换,如果设为 live_migration_inbound_addr,则替换 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 加密。

这个选项将允许迁移流(客户机 RAM 和设备状态)和磁盘 流通过原生 TLS 传输,例如,内置于 QEMU 中的 TLS 支持。

先决条件:在所有相关的 Compute 节点上正确配置 TLS 环境。这意味着,认证机构(CA)、服务器、客户端证书、对应的密钥及其文件已发生,并验证。

备注:

  • 为了对迁移流和磁盘流(也称为 "block migration")进行加密,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 存储后端上存储块存储服务卷。此选项指定挂载 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 卷的 secret 的 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 criu-wagonit is non-blocking,因此比较快,并避免 /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 手册页。请注意,必须指定 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 配置,ts s 是默认值。

为了支持冷迁移和调整大小,nova 需要知道运行 swtpm 二进制文件的组,以确保文件在节点间移动后获得正确的所有权。

相关选项:

  • 还必须设置 swtpm_user

swtpm_user = tss

字符串值

swtpm 二进制文件以.

使用模拟 TPM 时,swt pm 二进制文件将运行来模拟 TPM 设备。此二进制文件以 身份运行的用户取决于 libvirt 配置,ts s 是默认值。

为了支持冷迁移和调整大小,nova 需要知道运行 swtpm 二进制文件的用户,以确保文件在节点间移动后获得正确的所有权。

相关选项:

  • 还必须设置 swtpm_group

sysinfo_serial = unique

字符串值

用于填充虚拟 BIOS 中 guest 的主机"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 模型不是 server grade,并可能对电源丢失进行任意的一组数据更改。此类 SSD 不应在 Vstorage 中使用,并且存在危险,因为可能会导致数据崩溃和不一致。请参考手册,了解哪些 SSD 模型已知是安全的,或使用 vstorage-hwflush-check (1)实用程序进行验证。

此选项定义应包含 "%(cluster_name) s" 模板的路径,来将缓存与多个共享分开。

相关选项:

  • vzstorage_mount_opts 可能包括更详细的缓存选项。

vzstorage_log_path = /var/log/vstorage/%(cluster_name)s/nova.log.gz

字符串值

vzstorage 客户端日志的路径。

此选项定义集群操作的日志,它应包含 "%(cluster_name) s" 模板,以将日志与多个共享分开。

相关选项:

  • vzstorage_mount_opts 可能包括更详细的日志记录选项。

vzstorage_mount_group = qemu

字符串值

挂载所有者组名称。

此选项定义 Vzstorage 集群挂载点的所有者组。

相关选项:

  • vzstorage_mountedServiceSet 组的参数

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 作为那些具有显式 vzstorageer 选项的选项。

相关选项:

  • 所有其他 vzstorage AlertManager 选项

vzstorage_mount_perms = 0770

字符串值

挂载访问模式。

此选项定义 Vzstorage 集群挂载点的访问位,其格式类似于 chmod (1)实用程序,如下所示:0770。它由一到四个数字组成,范围从 0 到 7,如果缺少前面的位则代表这些位为 0。

相关选项:

  • vzstorage_mountedServiceSet 组的参数

vzstorage_mount_point_base = $state_path/mnt

字符串值

在计算节点上挂载 Virtuozzo 存储集群的目录。

这个选项为 Vzstorage 集群定义非标准挂载点。

相关选项:

  • vzstorage_mountedServiceSet 组的参数

vzstorage_mount_user = stack

字符串值

挂载所有者用户名。

此选项定义 Vzstorage 集群挂载点的所有者用户。

相关选项:

  • vzstorage_mountedServiceSet 组的参数

wait_soft_reboot_seconds = 120

整数值

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

9.1.27. metrics

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

表 9.26. metrics
配置选项 = 默认值类型Description

必需 = True

布尔值

是否需要指标。

此设置决定了如何处理不可用的指标。如果此选项设置为 True,则指标不可用的任何主机都会引发异常,因此建议在 weighing 前使用 MetricFilter 来过滤这些主机。

可能的值:

  • 布尔值,其中 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 被减少并撤销
  • -1.0: 效果被撤销
  • <-1.0: 效果会按比例和反向增加

可能的值:

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

相关选项:

  • [filter_scheduler] weight_classes
  • [metrics] weight_of_unavailable

weight_of_unavailable = -10000.0

浮点值

不可用指标的默认权重。

当满足以下任一条件时,将使用这个值来代替任何实际指标值:

  • 主机不能使用 [metrics] weight_setting 命名的一个指标,required 的值为 False
  • [metrics] weight_setting 中为指标指定的比率为 0。
  • [metrics] weight_multiplier 选项设为 0。

可能的值:

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

相关选项:

  • [metrics] weight_setting
  • [metrics] 必需
  • [metrics] weight_multiplier

weight_setting = []

列表值

指标到权重修饰符的映射.

此设置指定要权衡的指标以及每个指标的相对比率。这应该是一个字符串值,由一个或多个 name=ratio 对组成,用逗号分开,其中 name 是要权衡的指标的名称,而 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.28. mks

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

表 9.27. 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.29. neutron

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

表 9.28. 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 没有在端口绑定 reponses 中指定浮动 IP 池名称时,才会使用此选项。

domain-id = None

字符串值

范围的域 ID

domain-name = None

字符串值

范围为的域名

endpoint-override = None

字符串值

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

extension_sync_interval = 600

整数值

整数值,代表在查询 Neutron 扩展前要等待的秒数。下一次 Neutron 中需要创建资源的时间(以秒为单位)后,它会为已加载的扩展重新查询 Neutron。将值设为 0 将刷新没有等待的扩展。

http_retries = 3

整数值

neutronclient 在任何失败的 http 调用中应重试的次数。

0 表示只尝试一次连接。把它设置为任何正整数表示在失败连接中重试多次,例如将其设置为 3 表示连接总数为 4。

可能的值:

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

insecure = False

布尔值

验证 HTTPS 连接。

keyfile = None

字符串值

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

`metadata_proxy_shared_secret = `

字符串值

此选项包含用于验证对 Neutron 元数据请求的代理请求的共享 secret 字符串。要使用,请求中必须提供 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.30. notifications

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

表 9.29. 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.31. oslo_concurrency

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

表 9.30. oslo_concurrency
配置选项 = 默认值类型Description

disable_process_locking = False

布尔值

启用或禁用进程间锁定。

lock_path = None

字符串值

用于锁定文件的目录。为安全起见,指定目录应只由运行需要锁定的进程的用户写入。默认为环境变量 OSLO_LOCK_PATH。如果使用外部锁定,则必须设置锁定路径。

9.1.32. oslo_messaging_amqp

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

表 9.31. 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 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 default_rpc_exchange if set other 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 消息。

notify_address_prefix = openstack.org/om/notify

字符串值

所有生成的通知地址的地址前缀

notify_server_credit = 100

整数值

传入通知消息的窗口大小

pre_settled = ['rpc-cast', 'rpc-reply']

多值

发送此类型的消息预先组装。预先设置的消息不会接收来自 peer 的确认信息。请注意:如果发送失败,则预先设置的消息可能会被静默丢弃。允许的值: rpc-call - 发送 RPC Calls pre-settled rpc-reply- 发送 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 消息的窗口大小。

rpc_address_prefix = openstack.org/om/rpc

字符串值

所有生成的 RPC 地址的地址前缀

rpc_server_credit = 100

整数值

传入 RPC Request 消息的窗口大小

`sasl_config_dir = `

字符串值

包含 SASL 配置的目录路径

`sasl_config_name = `

字符串值

配置文件名称(不带 .conf 后缀)

`sasl_default_realm = `

字符串值

如果用户名中没有 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 extension (rfc6066)来为每个虚拟主机提供证书。如果服务器的 SSL 证书使用虚拟主机名称而不是 DNS 名称,则将 ssl_verify_vhost 设置为 True。

trace = False

布尔值

debug :将 AMQP 帧转储到 stdout

unicast_address = unicast

字符串值

在发送到特定 RPC/Notification 服务器时,附加到地址前缀。消息总线用来识别发送到单个目的地的消息。

9.1.33. oslo_messaging_kafka

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

表 9.32. oslo_messaging_kafka
配置选项 = 默认值类型Description

compression_codec = none

字符串值

producer 生成的所有数据的压缩 codec。如果没有设置,则不会使用压缩。请注意,这允许的值取决于 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 consumer 的最大获取字节数

max_poll_records = 500

整数值

轮询调用中返回的最大记录数

pool_size = 10

整数值

Kafka Consumers 的池大小

producer_batch_size = 16384

整数值

producer async 发送的批处理大小

producer_batch_timeout = 0.0

浮点值

以秒为单位的 KafkaProducer 批处理延迟上限

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.34. oslo_messaging_notifications

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

表 9.33. oslo_messaging_notifications
配置选项 = 默认值类型Description

driver = []

多值

处理发送通知的驱动程序。可能的值有 messaging, messagingv2, routing, log, test, noop

retry = -1

整数值

重新发送因为可恢复错误而发送失败的通知消息的最大尝试次数。0 - 不重试,-1 - indefinite

topics = ['notifications']

列表值

用于 OpenStack 通知的 AMQP 主题。

transport_url = None

字符串值

代表用于通知的消息传递驱动程序的 URL。如果没有设置,我们回退到用于 RPC 的同一配置。

9.1.35. oslo_messaging_rabbit

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

表 9.34. oslo_messaging_rabbit
配置选项 = 默认值类型Description

amqp_auto_delete = False

布尔值

AMQP 中的自动删除队列。

amqp_durable_queues = False

布尔值

在 AMQP 中使用持久队列。

direct_mandatory_flag = True

布尔值

(DEPRECATED)为直接发送启用/禁用 RabbitMQ 强制标记。直接发送用作回复,因此在客户端队列不存在时引发 MessageUndeliverable 异常。MessageUndeliverable 异常将用于循环使发送者恢复。此标志已弃用,且无法停用此功能

enable_cancel_on_failover = False

布尔值

启用 x-cancel-on-ha-failover 标志,使 rabbitmq 服务器将取消并通知 consumerswhen 队列停机

heartbeat_in_pthread = False

布尔值

默认情况下,通过原生 python 线程运行健康检查心跳线程。如果此选项等于 False,则健康检查 heartbeat 将继承父进程的执行模型。例如,如果父进程使用 eventlet/greenlet 对 stdlib 进行补丁,则心跳将通过绿色线程运行。这个选项应该只针对 wsgi 服务设置为 True。

heartbeat_rate = 2

整数值

heartbeat_timeout_threshold 期间的时间我们检查心跳的频率。

heartbeat_timeout_threshold = 60

整数值

如果 heartbeat 的 keep-alive 失败(0 禁用 heartbeat),则 Rabbit 代理被视为 down 的秒数。

kombu_compression = None

字符串值

EXPERIMENTAL: Possible 值为: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\.) gem {"ha-mode": "all"} "

rabbit_interval_max = 30

整数值

RabbitMQ 连接重试的最大间隔。默认值为 30 秒。

rabbit_login_method = AMQPLAIN

字符串值

RabbitMQ 登录方法。

rabbit_qos_prefetch_count = 0

整数值

指定要预抓取的消息数量。设置为零可允许无限消息。

rabbit_retry_backoff = 2

整数值

连接到 RabbitMQ 时重试之间的 backoff 时长。

rabbit_retry_interval = 1

整数值

使用 RabbitMQ 重试连接的频率。

rabbit_transient_queues_ttl = 1800

整数值

正整数代表队列 TTL (x-expires)的持续时间(以秒为单位)。TTL 期间未使用的队列将被自动删除。参数仅影响 reply 和 fanout 队列。

ssl = False

布尔值

通过 SSL 连接。

`ssl_ca_file = `

字符串值

SSL 证书颁发机构文件(仅在启用了 SSL 时评估)。

`ssl_cert_file = `

字符串值

SSL 证书文件(仅在启用了 SSL 时评估)。

`ssl_key_file = `

字符串值

SSL 密钥文件(仅在启用了 SSL 时valid)。

`ssl_version = `

字符串值

要使用的 SSL 版本(仅在启用了 SSL 时评估)。有效值为 TLSv1 和 SSLv23。SSLv2、SSLv3、TLSv1_1 和 TLSv1_2 可能在某些发行版中提供。

9.1.36. oslo_middleware

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

表 9.35. oslo_middleware
配置选项 = 默认值类型Description

enable_proxy_headers_parsing = False

布尔值

应用程序是否在代理后面。这决定了中间件是否应该解析标头。

max_request_body_size = 114688

整数值

每个请求的最大正文大小,以字节为单位。

secure_proxy_ssl_header = X-Forwarded-Proto

字符串值

用于确定原始请求协议方案的 HTTP 标头,即使它被 SSL 终止代理隐藏也是如此。

9.1.37. oslo_policy

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

表 9.36. oslo_policy
配置选项 = 默认值类型描述

enforce_new_defaults = False

布尔值

这个选项控制在评估策略时是否使用旧的弃用默认值。如果为 True,则不会评估旧的已弃用的默认值。这意味着,如果旧默认值允许任何现有令牌,但不允许使用新默认值,它将被禁止。我们鼓励启用此标志以及 enforce_scope 标志,以便您可以同时获得新默认值和 scope_type 的好处

enforce_scope = False

布尔值

此选项控制在评估策略时是否强制执行范围。如果为 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 cert 文件的绝对路径

remote_ssl_client_crt_file = None

字符串值

基于 REST 的策略检查的客户端证书的绝对路径

remote_ssl_client_key_file = None

字符串值

绝对路径客户端密钥文件 REST 基于策略检查

remote_ssl_verify_server_crt = False

布尔值

基于 REST 的策略检查的服务器身份验证

9.1.38. pci

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

表 9.37. pci
配置选项 = 默认值类型Description

alias = []

多值

PCI 透传设备要求的别名。

这允许用户在额外规格中指定类别的别名,而无需重复所有 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`.
  • 通过重复选项(而不是通过指定)来支持多个别名

    列表值)
    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" }

passthrough_whitelist = []

多值

可用于虚拟机的 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
  • 总线 - 0xFF
  • slot - 0x1F
  • function - 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 matching PCI devices.
      Supported `<tag>` values are :
    • physical_network
    • trusted

      有效示例为
      passthrough_whitelist = {"devname":"eth0", "physical_network":"physnet"} passthrough_whitelist = {"address":":0a:00."} passthrough_whitelist = {"address":":0a:00.", "physical_network":"physnet1"} passthrough_whitelist = {"vendor_id":"1137", "product_id":"0071"} passthrough_whitelist = {"vendor_id":"1137", "product_id":"0071", "address": "0000:0a:00.1", "physical_network":"physnet1"} passthrough_whitelist = {"address":{"domain": ".", "bus": "02", "slot": "01", "function": "[2-7]"}, "physical_network":"physnet1"} passthrough_whitelist = {"address":{"domain": ".", "bus": "02", "slot": "0[1-2]", "function": ".*"}, "physical_network":"physnet1"} passthrough_whitelist = {"devname": "eth0", "physical_network":"physnet1", "trusted": "true"}
      以下无效,因为它们指定了相互排斥的选项
      passthrough_whitelist = {"devname":"eth0", "physical_network":"physnet", "address":":0a:00."}
  • 与上述格式对应的 JSON 字典列表。对于

    示例
    passthrough_whitelist = [{"product_id":"0001", "vendor_id":"8086"}, {"product_id":"0002", "vendor_id":"8086"}]

9.1.39. placement

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

表 9.38. 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.40. powervm

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

表 9.39. powervm
配置选项 = 默认值类型Description

disk_driver = localdisk

字符串值

用于 PowerVM 磁盘的磁盘驱动程序。PowerVM 支持 localdisk 和 PowerVM 共享存储池磁盘驱动程序。

相关选项:

  • volume_group_name - 使用 localdisk 时需要

proc_units_factor = 0.1

浮点值

用于计算提供给每个 vCPU 的物理处理器计算能力的因素。例如值 1.0 表示整个物理处理器,而 0.05 代表物理处理器的 1/20。

`volume_group_name = `

字符串值

用于块设备操作的卷组。如果 disk_driver 是 localdisk,则必须指定此属性。强烈建议您不要使用 rootvg,因为管理分区使用并填充它将导致失败。

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>

整数值

可用于 privsep 的线程数量,以同时运行进程。默认为系统中的 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 驱动程序进行发送范围。
  • 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 服务。此参数定义名称(例如: sentinal_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 状态的未调度的服务器,行为也会不同。永不调度到计算主机的服务器没有放置分配,因此它不会消耗内核和 RAM 的配额使用量。

对于处于 SHELVED_OFFLOADED 状态的服务器,行为会有所不同。SHELVED_OFFLOADED 状态的服务器没有放置分配,因此它不会消耗内核和 RAM 的配额使用量。请注意,由于此,如果用户没有足够的配额来支持服务器所需的核心和 RAM,则可能会拒绝服务器的请求。

在从放置计算使用前,必须完成 populate_queued_for_deletepopulate_user_id 在线数据迁移。在数据迁移完成前,如果此配置选项被设置为 True,则系统将回退到来自单元数据库的旧配额使用量计数,具体取决于每个配额检查期间 EXISTS 数据库查询的结果。希望避免从 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,以避免在允许超过配额时避免额外的负载。例如,当用户设置为 False 时,如果用户进行高度并行的 REST API 请求来创建服务器,则它们可以创建比其允许的配额更多的服务器。如果配额是 10 个服务器,则它们可能会在突发期间创建 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: 必须为超v。

html5_proxy_base_url = http://127.0.0.1:6083/

URI 值

最终用户用来连接到 RDP HTML5 控制台代理的 URL。使用这个 token-embedded URL 调用控制台代理服务,并建立到正确实例的连接。

RDP HTML5 控制台代理服务需要配置为侦听此处配置的地址。通常,控制台代理服务将在控制器节点上运行。用作默认值的 localhost 地址只能在单一节点环境中工作,例如 devstack。

RDP HTML5 代理允许用户使用 RDP 通过任何 Windows 服务器或工作站的 Web 或图形控制台访问。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 或名称)。

当您想通过不同主机上运行的调试器连接到 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

端口值

要连接的调试端口。

此命令行参数允许您通过不同主机上运行的调试器指定您要用来连接到 nova 服务的端口。

请注意,使用远程 debug 选项更改 nova 如何使用 eventlet 库来支持 async IO。这可能会导致在正常操作下不会发生失败。自行使用风险。

可能的值:

  • 您要用作 nova 服务的命令行参数的端口号。

    例如:
    nova-compute --config-file /etc/nova/nova.conf --remote_debug-host <IP 地址 debugger> --remote_debug-port <port debugger 正在侦听>。

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

布尔值

使用 placement 根据镜像元数据过滤主机。

此设置会导致调度程序将已知的镜像元数据属性转换为放置所需的特征,以根据镜像元数据过滤主机。此功能需要主机支持,且目前由以下计算驱动程序支持:

  • libvirt.LibvirtDriver (自 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

整数值

调度尝试的最大数量。

这是对给定实例构建/移动操作进行的最多尝试次数。它限制调度程序返回的备用主机数量。当主机列表耗尽时,会引发 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 = False

布尔值

使用 placement 确定可用区。

此设置会使调度程序使用设置为传入请求所提供的值的元数据键(availability_zone)查找主机聚合,并从放置请求请求结果限制为该聚合。

必须在放置中镜像匹配的聚合 UUID,才能正常工作。如果没有找到带有 availability_zone 键的主机聚合,或者该聚合与放置中的不匹配,则结果将与找不到任何合适的主机相同。

请注意,如果启用此标志,您可以在调度程序中禁用(无效率) AvailabilityZoneFilter。

可能的值:

  • 布尔值。

相关选项:

  • [filter_scheduler] enabled_filters

query_placement_for_image_type_support = False

布尔值

使用 placement 来确定对实例的镜像类型的主机支持。

此设置会导致调度程序仅为支持请求中使用的镜像的 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 选项)。
  • 端口必须与本节的 option serialproxy_port 相同。
  • 如果您选择使用安全 websocket 连接,则使用 wss:// 启动这个选项,而不是不安全的 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 选项 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 的用户令牌与 Cinder、Glance 和 Neutron 等其他 REST API 通信。用户令牌在向 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 客户端访问的端口。

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 中指定的地址。

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

原因: nova-cert 服务在 16.0.0 (Pike)中删除,因此不再使用这个选项。

compute = None

字符串值

计算 RPC API 版本大写。

默认情况下,我们始终使用客户端了解的最新版本发送消息。

如果您运行有旧的计算服务和新的计算服务,应该将其设置为最低部署的版本。这是为了保证所有服务永远不会发送其中一个计算节点无法理解的消息。请注意,我们只支持从 N 版本升级到 N+1。

如果要让计算 RPC 模块根据部署中的服务版本自动决定要使用的版本,请将此选项设置为 "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

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 的连接的最大数量。只有在代表连接池已满的警告时,才会增加它,否则默认值应该会增大。

console_delay_seconds = None

整数值

如果受增加的网络延迟影响,请在远程控制台中输入时造成重复字符,则设置这个值。

datastore_regex = None

字符串值

与数据存储名称匹配的正则表达式模式。

datastore_regex 设置指定用于 Compute 的数据存储。例如,datastore_regex="nasgem" 选择名称以 "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 镜像服务下载 VMDK 到 hypervisor 可见的数据存储并将其缓存。需要 VMDK 的后续虚拟机使用缓存版本,且不必从 OpenStack 镜像服务再次复制该文件。

如果设置为 false,即使在缓存的 VMDK 中,仍存在从缓存位置复制到共享数据存储中的 hypervisor 文件目录的副本操作。如果设置为 true,则避免上述复制操作,因为它会创建与父虚拟机共享虚拟磁盘的虚拟机副本。

vnc_keymap = en-us

字符串值

VNC 的键映射。

键盘映射(keymap)决定 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 文件的路径

包含一个或多个 x509 证书的 PEM 文件的完全限定路径,用于计算节点 VNC 服务器使用的证书颁发机构。

相关选项:

  • VNC.auth_schemes :必须包含 vencrypt

vencrypt_client_cert = None

字符串值

客户端密钥文件的路径(用于 x509)

包含 x509 证书的 PEM 文件的完全限定路径,在 VNC 身份验证过程中 VNC 代理服务器将其提供给计算节点。

Realted 选项:

  • VNC.auth_schemes :必须包含 vencrypt
  • 还必须设置 VNC.vencrypt_client_key:

vencrypt_client_key = None

字符串值

客户端证书 PEM 文件的路径(用于 x509)

包含 VNC 代理服务器在 VNC 身份验证过程中向计算节点呈现的私钥的 PEM 文件的完全限定路径。

相关选项:

  • VNC.auth_schemes :必须包含 vencrypt
  • vnc.vencrypt_client_cert: must also be set

9.1.55. 临时解决方案

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

表 9.54. 临时解决方案
配置选项 = 默认值类型描述

disable_compute_service_check_for_ffu = False

布尔值

如果设置了此设置,则旧计算服务的正常安全检查将被视为警告而不是错误。这只是为了促进在计算节点能够更新其服务记录之前启动新控制服务的快速转发升级。在 FFU 中,数据库中的服务记录将早于一个版本,直到计算节点启动为止,但首先需要控制服务在线。

disable_fallback_pcpu_query = False

布尔值

在使用固定实例时,禁用对 VCPU 分配的回退请求。

从 Train 开始,使用 libvirt virt 驱动程序的计算节点可以报告 PCPU 清单,并将将此用于固定实例。调度程序将使用旧的 CPU 固定相关的类别额外规格、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 数据库进行 upcall 来列出要引导的服务器组中的实例,这会违反了我们的 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 时禁用实时快照
  • false :在快照进行快照时始终使用实时快照(只要有新的足够 libvirt 和后端存储支持它)

弃用自:19. 0.0

reason: 添加了这个选项来临时处理 libvirt 1.2.2 的问题。我们不再支持这个 libvirt 版本,这意味着不再需要这个临时解决方案。它将在以后的发行版本中被删除。

disable_native_luksv1 = False

布尔值

将加密的 LUKSv1 Cinder 卷附加到实例时,Libvirt 驱动程序会将加密的磁盘配置为由 QEMU 原生解密。

QEMU 使用的 libgcrypt 库中发现了一个性能问题,在这种情况下,服务器会限制 I/O 性能。

如需更多信息,请参阅以下 bug 报告:

RFE: 硬件加速 AES-XTS 模式 https://bugzilla.redhat.com/show_bug.cgi?id=1762765

启用这个临时解决方案选项将导致 Nova 使用传统的基于 os-brick 的 os-brick 加密器来解密 LUKSv1 卷。

请注意,在使用不提供主机块设备(如 Ceph )的卷时启用此选项,会导致从实例引导或将卷连接到实例失败。如需了解避免 RBD 执行此操作的方法,请参阅 [workarounds]/rbd_block_device 选项。

相关选项:

  • compute_driver (libvirt)
  • rbd_block_device (workarounds)

弃用自: 23.0.0

原因: 在 libgcrypt 中提示这个临时解决方案的底层性能回归已被解决,从 1.8.5 开始已解决

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 拓扑的实例实时迁移。

只有在完全升级到 Train 的部署中支持使用 libvirt 驱动程序时,使用 NUMA 拓扑的实时迁移实例。在以前的版本中,或在带有滚动升级的混合 Stein/Train 部署中,在使用 libvirt 驱动程序时默认禁用带有 NUMA 拓扑的实例实时迁移。这包括使用 CPU 固定或大页实时迁移实例。目前不会重新计算此类实例的 CPU 固定和巨页信息,如 'bugkamelet89064'_ 所述。这意味着,如果目标主机上已存在实例,迁移的实例可以放在与这些实例相同的专用内核中,或使用为另一个实例分配的大页。另外,如果主机平台不是同构,可以将实例分配给不存在的内核,或者跨主机 NUMA 节点意外分割。

尽管这些已知的问题,在有些情况下可能需要实时迁移。通过启用此选项,了解此问题的 operator 并需要手动工作,可以对这些实例启用实时迁移支持。

相关选项:

弃用自:20.0.0

*reason:* 这个选项被添加来缓解使用 libvirt 驱动程序的 NUMA 拓扑迁移实例时已知的问题。这些问题在Train 中解决。使用 libvirt 驱动程序的云,并完全升级到 Train 支持 NUMA 感知实时迁移。这个选项将在以后的发行版本中被删除。

enable_qemu_monitor_announce_self = False

布尔值

如果 libvirt 驱动程序设为 True,则 libvirt 驱动程序将尝试作为向 QEMU 监视器发送声明命令的最佳努力,以便它生成 RARP 帧以更新目标后实时迁移阶段的网络交换机。

请注意,这会导致 libvirt 认为域被 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

然后,如果实例试图返回到主机,则这两个错误都可能会导致 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

布尔值

在一些内核初始化 guest apic 时,可能会导致内核挂起,导致客户机不可用。这会导致内核错误。在大多数情况下,正确的修复它会将客户机镜像内核更新至一个已修补的客户机镜像内核,但在某些情况下无法进行修复。此临时解决方案允许模拟每个主机禁用 apic,但不建议在 CI 或开发人员云之外使用。

never_download_image_if_on_rbd = False

布尔值

从由 ceph 支持的计算节点上的镜像引导时,如果镜像还没有驻留在 ceph 集群中(如果 glance 也使用相同的集群),nova 将从 glance 下载镜像并将其上传到 ceph 本身。如果使用多个 ceph 集群,这可能会导致 nova 在本地 ceph 部署中意外地复制镜像。

如需更多信息,请参阅错误报告:

https://bugs.launchpad.net/nova/+bug/1858877

启用此选项将导致 nova 在需要从 glance 下载镜像并将其上传到 ceph 本身时 拒绝 引导实例。

相关选项:

  • compute_driver (libvirt)
  • [libvirt]/images_type (rbd)

rbd_volume_local_attach = False

布尔值

将 RBD Cinder 卷作为主机块设备附加到计算。

启用此选项后,指示 os-brick 将计算主机上本地的 RBD 卷连接为块设备,而不是通过 QEMU 进行原生连接。

这个临时解决方案目前不支持扩展附加的卷。

这可与 disable_native_luksv1 临时解决方案 配置选项一起使用,以避免在 libgcrypt 库中找到的最近发现的性能问题。

这个临时解决方案是临时的,当所有受影响的发行版本都能够更新其 libgcrypt 库后,会在 W 版本中删除这个临时解决方案。

相关选项:

  • compute_driver (libvirt)
  • disable_qemu_native_luksv1 (workarounds)

弃用自: 23.0.0

原因: 在 libgcrypt 中提示这个临时解决方案的底层性能回归已被解决,从 1.8.5 开始已解决

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

布尔值

这将在 Compute 服务启动时跳过 CPU 比较调用,并允许 libvirt 处理它。

skip_cpu_compare_on_dest = False

布尔值

启用后,它将跳过目标主机上的 CPU 比较。当使用 QEMU >= 2.9 和 libvirt >= 4.4.0 时,libvirt 将对在实时迁移过程中检查目标主机上的 CPU 兼容性进行正确的操作。

skip_hypervisor_version_check_on_lm = False

布尔值

启用后,它将在实时迁移过程中跳过虚拟机监控程序的版本检查。

wait_for_vif_plugged_event_during_hard_reboot = []

列表值

libvirt virt 驱动程序通过停止重新引导实例的每个 vif 来实施电源和硬重启,然后再次插入它们。默认情况下,nova 不会等待来自 neutron 的 network-vif-plugged 事件,然后让实例运行。这可能会导致实例通过 DHCP 请求 IP,然后 neutron 后端有机会在 vif 插件后设置网络后端。

此标志定义在硬重启过程中需要 network-vif-plugged 事件。可能的值有 neutron port vnic 类型:

  • normal
  • direct
  • macvtap
  • baremetal
  • direct-physical
  • virtio-forwarder
  • smart-nic
  • vdpa
  • accelerator-direct
  • accelerator-direct-physical

向此配置中添加 vnic_type 会导致 Nova 等待每个实例的 vifs 的 vifs 在取消暂停实例之前具有特定 vnic_type 的 vifs 等待网络插入事件,类似于新实例创建的工作方式。

请注意,并非所有 neutron 网络后端都会为某些 vnic_type 发送插件时间事件,因此此配置默认为空。

ml2/ovs 和 networking-odl 后端已知为带有 normal vnic_type 的端口发送插件时间事件,因此如果您在计算主机上只使用这些后端,则可以安全地将此配置 正常 添加。

在带有 direct vnic_type 的端口期间,neutron in-tree SRIOV 后端不会可靠地发送 network-vif-plugged 事件,且永远不会在插件期间发送具有 直接物理 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 配置的文件名的字符串。

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

整数值

此选项指定要接受的消息标头的最大行大小。在使用带有大型服务目录的 Keystone v3 API 生成时,可能需要增加 max_header_line 的最大行大小。

由于 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

reason: 此选项仅在 eventlet 下运行 nova-api 时起作用,并对非常特定于事件的信息进行编码。从 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 云连接器通信的 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.