glance-cache.conf

默认值

hashing_algorithm

类型:

字符串

默认值:

sha512

用于计算 ‘os_hash_value’ 属性的安全哈希算法。

此选项配置 Glance 的“多哈希”，它由两个镜像属性组成：‘os_hash_algo’ 和 ‘os_hash_value’。‘os_hash_algo’ 将填充此配置选项的值，而 ‘os_hash_value’ 将填充应用于上传或导入的镜像数据时计算出的十六进制摘要。

该值必须是 Python ‘hashlib’ 库识别的有效安全哈希算法名称。可以通过检查 Glance 安装中使用库的 ‘hashlib.algorithms_available’ 数据成员来确定这些算法。但是，为了互操作性，我们建议使用 ‘hashlib.algorithms_guaranteed’ 数据成员提供的安全哈希名称集，因为这些算法保证在所有平台上的 ‘hashlib’ 库中都受支持。因此，使用 ‘hashlib’ 本地化的任何镜像消费者都应该能够验证镜像的 ‘os_hash_value’。

默认值 ‘sha512’ 是一种性能良好的安全哈希算法。

如果此选项配置错误，任何存储镜像数据的尝试都将失败。因此，我们建议使用默认值。

可能的值

• Python ‘hashlib’ 库识别的任何安全哈希算法名称

相关选项

• 无

image_member_quota

类型:

整数

默认值:

128

每个镜像的最大镜像成员数量。

这限制了镜像可以共享的用户数量上限。任何负值都解释为无限制。

相关选项

• 无

image_property_quota

类型:

整数

默认值:

128

镜像允许的最大属性数量。

这强制执行镜像可以拥有的附加属性数量的上限。任何负值都解释为无限制。

image_tag_quota

类型:

整数

默认值:

128

镜像允许的最大标签数量。

任何负值都解释为无限制。

相关选项

• 无

image_location_quota

类型:

整数

默认值:

10

镜像允许的最大位置数量。

任何负值都解释为无限制。

相关选项

• 无

limit_param_default

类型:

整数

默认值:

25

最小值:

1

请求返回的默认结果数量。

对某些 API 请求（如列出镜像）的响应可能会返回多个项目。可以通过在 API 请求中指定 limit 参数来显式控制返回的结果数量。但是，如果未指定 limit 参数，则此配置值将用作任何 API 请求返回的默认结果数量。

注意

• 此配置选项的值不得大于 api_limit_max 指定的值。

• 将此设置为非常大的值可能会减慢数据库查询速度并增加响应时间。将此设置为非常小的值可能会导致用户体验不佳。

可能的值

• 任何正整数

相关选项

• api_limit_max

api_limit_max

类型:

整数

默认值:

1000

最小值:

1

请求可以返回的最大结果数量。

如 limit_param_default 的帮助文本中所述，某些请求可能会返回多个结果。返回的结果数量由请求中的 limit 参数或 limit_param_default 配置选项控制。无论哪种情况，该值都不能大于此配置选项定义的绝对最大值。大于此值的任何值都将被截断为此处定义的最大值。

注意：将此设置为非常大的值可能会减慢数据库

查询速度并增加响应时间。将此设置为非常小的值可能会导致用户体验不佳。

可能的值

• 任何正整数

相关选项

• limit_param_default

show_image_direct_url

类型:

布尔值

默认值:

False

返回镜像时显示直接镜像位置。

此配置选项指示在将镜像详细信息返回给用户时是否显示直接镜像位置。直接镜像位置是镜像数据存储在后端存储中的位置。此镜像位置显示在镜像属性 direct_url 下。

当镜像存在多个镜像位置时，将根据为每个存储分配的配置选项 weight 分配的存储权重显示最佳位置。

注意

• 暴露镜像位置可能存在严重的安全性风险，因为镜像位置有时可能包含凭据。因此，默认情况下将其设置为 False。只有在您了解自己在做什么的情况下，才谨慎地将其设置为 True！

• 如果操作员希望避免向用户显示任何镜像位置，则必须将此选项和 show_multiple_locations 都设置为 False。

可能的值

• True

• False

相关选项

• show_multiple_locations

• weight

show_multiple_locations

类型:

布尔值

默认值:

False

返回镜像时显示所有镜像位置。

此配置选项指示在返回镜像详细信息时是否显示所有镜像位置。当镜像存在多个镜像位置时，位置将根据为每个存储分配的配置选项 weight 分配的存储权重进行排序。镜像位置显示在镜像属性 locations 下。

注意

• 暴露镜像位置可能存在严重的安全性风险，因为镜像位置有时可能包含凭据。因此，默认情况下将其设置为 False。只有在您了解自己在做什么的情况下，才谨慎地将其设置为 True！

• 有关更多信息，请参阅 https://wiki.openstack.org/wiki/OSSN/OSSN-0065。

• 如果操作员希望避免向用户显示任何镜像位置，则必须将此选项和 show_image_direct_url 都设置为 False。

可能的值

• True

• False

相关选项

• show_image_direct_url

• weight

警告

此选项自 Newton 以来已弃用，将来可能会被静默忽略。

原因:

自 Newton 以来使用此选项存在安全风险，并且一旦我们找到满足当前需要它的用例的方法，将被删除。较早的声明，即可以通过策略配置实现相同的功能是不正确的。目前无法通过策略配置绕过此选项，尽管我们认为修复方向将朝这个方向发展。请关注 Glance 发行说明，以了解解决此问题的最新进展。

do_secure_hash

类型:

布尔值

默认值:

True

计算镜像的哈希值和校验和。

此配置选项指示 /v2/images/{image_id}/locations POST API 是否会在飞行中计算镜像的哈希值和校验和。如果为 False，则会静默忽略哈希值和校验和计算。

可能的值

• True

• False

http_retries

类型:

整数

默认值:

3

任何操作失败时重试的次数。

image_size_cap

类型:

整数

默认值:

1099511627776

最小值:

1

最大值:

9223372036854775808

用户可以上传的镜像的最大大小（以字节为单位）。

大于此处提及大小的镜像上传将导致镜像创建失败。此配置选项默认为 1099511627776 字节（1 TiB）。

注意

• 只有在仔细考虑后才应增加此值，并且必须设置为小于或等于 8 EiB（9223372036854775808）。

• 必须仔细考虑后端存储容量来设置此值。将此设置为非常小的值可能会导致大量镜像失败。将此设置为非常大的值可能会导致存储更快地消耗。因此，必须根据创建的镜像性质和可用存储容量来设置此值。

可能的值

• 任何小于或等于 9223372036854775808 的正数

user_storage_quota

类型:

字符串

默认值:

0

每个租户的最大镜像存储量。

这强制执行租户在所有存储中所有镜像消耗的存储量的上限。这是一个按租户限制。

此配置选项的默认单位为字节。但是，可以使用区分大小写的文字 B、KB、MB、GB 和 TB 指定存储单位，分别表示字节、千字节、兆字节、千兆字节和太字节。请注意，值和单位之间不应有空格。值 0 表示不强制执行配额。负值无效并导致错误。

如果启用了 use_keystone_limits，则此选项将不起作用。

可能的值

• 一个有效的字符串，表示存储值和上述提及的存储单位的字符串文字的组合。

相关选项

• use_keystone_limits

use_keystone_limits

类型:

布尔值

默认值:

False

利用在 Keystone 中注册的每个租户资源限制。

启用此功能将导致 Glance 从 Keystone 中检索资源消耗限制并将其应用于 API 用户。在启用此功能之前，必须在 Keystone 中注册限制，否则所有配额都将被视为零，从而拒绝所有新的资源请求。

这些按租户资源限制与此配置文件中配置的静态全局限制是独立的。如果启用此功能，将忽略相关的静态全局限制。

pydev_worker_debug_host

类型:

主机地址

默认值:

localhost

此选项有一个示例默认值，这意味着其实际默认值可能与上述文档值不同。

pydev 服务器的主机地址。

提供一个表示 pydev 服务器的主机名或 IP，用于进行调试。pydev 服务器在此地址上侦听调试连接，从而实现 Glance 中的远程调试。

可能的值

• 有效的域名

• 有效的 IP 地址

相关选项

• 无

pydev_worker_debug_port

类型:

端口号

默认值:

5678

最小值:

0

最大值:

65535

pydev 服务器将侦听的端口号。

提供一个端口号以绑定 pydev 服务器。pydev 进程在此端口上接受调试连接，从而实现 Glance 中的远程调试。

可能的值

• 有效的端口号

相关选项

• 无

metadata_encryption_key

类型:

字符串

默认值:

<None>

用于加密存储位置元数据的 AES 密钥。

提供一个字符串值，表示用于加密 Glance 存储元数据的 AES 密码。

注意：用于 AES 密钥的值必须设置为长度为 16、24 或 32 字节的随机字符串。

可能的值

• 表示有效 AES 密钥的字符串值

相关选项

• 无

警告

此选项自 Dalmatian 以来已弃用，将来可能会被静默忽略。

原因:

此选项不服务于加密位置元数据的目的，而是仅对特定的 API 加密位置 URL。此外，如果在升级期间启用此选项，可能会破坏现有的部署，因为它不支持/不提供用于加密现有位置 URL 的数据库升级脚本。此外，其加密位置 URL 的功能不一致，导致下载失败。

digest_algorithm

类型:

字符串

默认值:

sha256

用于数字签名的摘要算法。

提供一个字符串值，表示用于生成数字签名的摘要算法。默认情况下，使用 sha256。

要获取平台上 OpenSSL 版本支持的可用算法列表，请运行命令：openssl list-message-digest-algorithms。示例包括 ‘sha1’、‘sha256’ 和 ‘sha512’。

注意：digest_algorithm 与 Glance 的镜像签名和验证无关。它仅用于对 UUID 进行签名，作为证书文件和密钥文件验证的一部分。

可能的值

• OpenSSL 消息摘要算法标识符

关系选项

• 无

警告

此选项自 Dalmatian 以来已弃用，将来可能会被静默忽略。

原因:

此选项自移除本机 SSL 支持以来已失效。

node_staging_uri

类型:

字符串

默认值:

file:///tmp/staging/

URL 提供临时数据将存储的位置

此选项仅供 Glance 内部使用。Glance 会在镜像导入过程中将用户上传的镜像数据保存到“暂存”端点。

此选项不会以任何方式更改“暂存”API 端点。

注意：不建议使用与 [task]/work_dir 相同的路径

注意：‘file://<绝对文件系统路径>’ 是 api_image_import 流程目前支持的唯一选项。

注意：暂存路径必须是所有 Glance API 节点可用的共享文件系统。

可能的值

• 以 ‘file://’ 开头，后跟绝对文件系统路径的字符串

相关选项

• [task]/work_dir

enabled_import_methods

类型:

列表

默认值:

['glance-direct', 'web-download', 'copy-image']

启用的镜像导入方法列表

默认情况下，‘glance-direct’、‘copy-image’ 和 ‘web-download’ 已启用。‘glance-download’ 可用，但需要联合部署。

相关选项

• [DEFAULT]/node_staging_uri

worker_self_reference_url

类型:

字符串

默认值:

<None>

此工作器的 URL。

如果设置此项，其他 Glance 工作器将知道如何直接联系此工作器（如果需要）。对于镜像导入，单个工作器暂存镜像，而其他工作器需要能够将导入请求代理到正确的工作器。

如果未设置，则将认为这是 public_endpoint，通常会在所有工作器上设置为相同的值，从而有效地禁用代理行为。

可能的值

• 可通过其他 worker 访问此 worker 的 URL

相关选项

• public_endpoint

image_cache_sqlite_db

类型:

字符串

默认值:

cache.db

用于图像缓存管理的 sqlite 文件数据库的相对路径。

这是指向跟踪图像缓存年龄和使用统计信息的 sqlite 文件数据库的相对路径。该路径相对于配置选项 image_cache_dir 指定的图像缓存基本目录。

这是一个轻量级数据库，只有一个表。

可能的值

• 有效的 sqlite 文件数据库相对路径

相关选项

• image_cache_dir

警告

此选项自 Caracal (2024.1) 起已弃用，未来可能会被静默忽略。

原因:

由于将使用集中式数据库进行图像缓存管理，‘E’ (2025.1) 开发周期将从‘E’中删除 sqlite 数据库和驱动程序。

image_cache_driver

类型:

字符串

默认值:

centralized_db

有效值:

centralized_db, sqlite, xattr

用于图像缓存管理的驱动程序。

此配置选项提供了在可用的不同图像缓存驱动程序之间进行选择的灵活性。图像缓存驱动程序负责提供图像缓存的基本功能，例如将图像写入/从缓存读取图像，跟踪缓存图像的年龄和使用情况，提供缓存图像列表，获取缓存大小，将图像排队进行缓存以及清理缓存等。

驱动程序的基本功能在基类 glance.image_cache.drivers.base.Driver 中定义。所有图像缓存驱动程序（现有和潜在的）都必须实现此接口。当前可用的驱动程序是 sqlite 和 xattr。这些驱动程序的主要区别在于它们存储有关缓存图像的信息的方式

• centralized_db 驱动程序使用中央数据库（对于所有 glance 节点都是通用的）来跟踪缓存图像的使用情况。

• sqlite（已弃用）驱动程序使用 sqlite 数据库（位于每个 glance 节点上）来跟踪缓存图像的使用情况。

• xattr 驱动程序使用文件的扩展属性来存储此信息。它还需要一个在文件被访问时设置 atime 的文件系统。

弃用警告

• 由于将使用集中式数据库进行图像缓存管理，‘E’ (2025.1) 开发周期将从‘E’中删除 sqlite 数据库和驱动程序。

可能的值

• centralized_db

• sqlite

• xattr

相关选项

• 无

image_cache_max_size

类型:

整数

默认值:

10737418240

最小值:

0

缓存清理程序清理图像缓存后的缓存大小上限，以字节为单位。

注意：这只是缓存清理程序采取行动的阈值。它不是一个硬性限制，超过该限制图像缓存将永远不会增长。事实上，根据缓存清理程序的运行频率和缓存填充速度，图像缓存很容易远远超过此处指定的大小。因此，必须小心安排缓存清理程序并设置此限制。

Glance 在下载图像时缓存图像。因此，随着下载次数的增加，图像缓存的大小会随着时间的推移而增长。为了防止缓存大小变得难以管理，建议将缓存清理程序作为定期任务运行。当缓存清理程序启动时，它会比较图像缓存的当前大小，如果图像缓存增长到此处指定的大小，则会触发清理。清理后，缓存的大小小于或等于此处指定的大小。

可能的值

• 任何非负整数

相关选项

• 无

image_cache_stall_time

类型:

整数

默认值:

86400

最小值:

0

未完成的图像在缓存中保留的时间量，以秒为单位。

未完成的图像是指正在下载的图像。有关更多详细信息，请参阅配置选项 image_cache_dir 的描述。有时，由于各种原因，下载可能会挂起，并且未完全下载的图像会保留在 incomplete 目录中。此配置选项设置了未完成的图像应保留在 incomplete 目录中的时间限制，然后进行清理。一旦未完成的图像花费的时间超过此处指定的时间，它将在下次运行缓存清理程序时被删除。

建议在 Glance API 节点上将缓存清理程序作为定期任务运行，以防止未完成的图像占用磁盘空间。

可能的值

• 任何非负整数

相关选项

• 无

image_cache_dir

类型:

字符串

默认值:

<None>

图像缓存的基本目录。

这是缓存图像数据并从中提供服务的位置。所有缓存的图像都直接存储在此目录中。此目录还包含三个子目录，即 incomplete、invalid 和 queue。

incomplete 子目录是下载图像的暂存区域。首先将图像下载到此目录。当图像下载成功时，它将被移动到基本目录。但是，如果下载失败，则部分下载的图像文件将被移动到 invalid 子目录。

queue 子目录用于将图像排队进行下载。主要由缓存预取器使用，可以将缓存预取器作为与缓存清理程序和缓存清理程序类似的定期任务进行安排，以提前缓存图像。收到缓存图像的请求后，Glance 会在 queue 目录中创建一个文件，文件名是图像 ID。缓存预取器在运行时会轮询 queue 目录中的文件，并按创建顺序开始下载它们。下载成功后，零大小的文件将从 queue 目录中删除。如果下载失败，则零大小的文件将保留，并在下次运行缓存预取器时重试。

可能的值

• 有效的路径

相关选项

• image_cache_sqlite_db

debug

类型:

布尔值

默认值:

False

可变:

此选项可以在不重启的情况下更改。

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

log_config_append

类型:

字符串

默认值:

<None>

可变:

此选项可以在不重启的情况下更改。

日志配置文件的名称。此文件将附加到任何现有的日志配置文件。有关日志配置文件的详细信息，请参阅 Python 日志模块文档。请注意，当使用日志配置文件时，所有日志配置都设置在配置文件中，并且其他日志配置选项将被忽略（例如，log-date-format）。

已弃用的变体

Group	名称
DEFAULT	log-config
DEFAULT	log_config

log_date_format

类型:

字符串

默认值:

%Y-%m-%d %H:%M:%S

定义日志记录中的 %(asctime)s 的格式字符串。默认值：上述值。如果设置了 log_config_append，则此选项将被忽略。

log_file

类型:

字符串

默认值:

<None>

(可选) 将日志输出发送到的日志文件名。如果没有设置默认值，日志将输出到 stderr，如 use_stderr 中定义的那样。如果设置了 log_config_append，则此选项将被忽略。

已弃用的变体

Group	名称
DEFAULT	logfile

log_dir

类型:

字符串

默认值:

<None>

(可选) 用于相对 log_file 路径的基本目录。如果设置了 log_config_append，则此选项将被忽略。

已弃用的变体

Group	名称
DEFAULT	logdir

watch_log_file

类型:

布尔值

默认值:

False

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

警告

此选项已弃用，将来可能会被静默忽略。

原因:

已知此功能长期存在问题，并且依赖于未维护的库

use_syslog

类型:

布尔值

默认值:

False

使用 syslog 进行日志记录。现有的 syslog 格式已弃用，以后将更改为符合 RFC5424。如果设置了 log_config_append，则此选项将被忽略。

use_journal

类型:

布尔值

默认值:

False

启用 journald 进行日志记录。如果正在 systemd 环境中运行，您可能希望启用 journal 支持。这样做将使用 journal 本机协议，其中包括结构化元数据以及日志消息。如果设置了 log_config_append，则此选项将被忽略。

syslog_log_facility

类型:

字符串

默认值:

LOG_USER

接收日志行的 syslog facility。如果设置了 log_config_append，则此选项将被忽略。

use_json

类型:

布尔值

默认值:

False

使用 JSON 格式进行日志记录。如果设置了 log_config_append，则此选项将被忽略。

use_stderr

类型:

布尔值

默认值:

False

将日志输出记录到标准错误。如果设置了 log_config_append，则此选项将被忽略。

log_color

类型:

布尔值

默认值:

False

(可选) 根据日志级别设置“color”键。此选项仅在将日志记录到 stderr 或 stdout 时生效。如果设置了 log_config_append，则此选项将被忽略。

log_rotate_interval

类型:

整数

默认值:

1

日志文件轮换前的时间量。如果未设置 log_rotation_type 为“interval”，则此选项将被忽略。

log_rotate_interval_type

类型:

字符串

默认值:

days

有效值:

秒、分钟、小时、天、星期几、午夜

轮换间隔类型。在安排下一次轮换时，使用上次文件更改时间（或服务启动时间）。

max_logfile_count

类型:

整数

默认值:

30

最大轮换日志文件数。

max_logfile_size_mb

类型:

整数

默认值:

200

日志文件最大大小（MB）。如果“log_rotation_type”未设置为“size”，则此选项将被忽略。

log_rotation_type

类型:

字符串

默认值:

none

有效值:

interval, size, none

日志轮换类型。

可能的值

interval

以预定义的时间间隔轮换日志。

size

当日志达到预定义的大小后轮换日志。

none

不轮换日志文件。

logging_context_format_string

类型:

字符串

默认值:

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

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

logging_default_format_string

类型:

字符串

默认值:

%(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)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_exception_prefix

类型:

字符串

默认值:

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

将此格式作为异常输出的每一行的前缀。由 oslo_log.formatters.ContextFormatter 使用

logging_user_identity_format

类型:

字符串

默认值:

%(user)s %(project)s %(domain)s %(system_scope)s %(user_domain)s %(project_domain)s

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

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']

包日志级别列表，格式为 logger=LEVEL 对。如果设置了 log_config_append，则此选项将被忽略。

publish_errors

类型:

布尔值

默认值:

False

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

instance_format

类型:

字符串

默认值:

"[instance: %(uuid)s] "

与日志消息一起传递的实例的格式。

instance_uuid_format

类型:

字符串

默认值:

"[instance: %(uuid)s] "

与日志消息一起传递的实例 UUID 的格式。

rate_limit_interval

类型:

整数

默认值:

0

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

rate_limit_burst

类型:

整数

默认值:

0

每 rate_limit_interval 允许记录的最大消息数。

rate_limit_except_level

类型:

字符串

默认值:

CRITICAL

有效值:

CRITICAL, ERROR, INFO, WARNING, DEBUG, ‘’

速率限制使用的日志级别。日志级别大于或等于 rate_limit_except_level 的日志不会被过滤。空字符串表示所有级别都不会被过滤。

fatal_deprecations

类型:

布尔值

默认值:

False

启用或禁用弃用信息的致命状态。

glance_store

stores

类型:

列表

默认值:

['file', 'http']

启用的 Glance 存储。

将用于存储磁盘镜像的存储后端注册为逗号分隔的列表。Glance 用于存储磁盘镜像的默认存储是 file 和 http。

可能的值

• 逗号分隔的列表，可以包括

  • file

  • http

  • swift

  • rbd

  • cinder

  • vmware

  • s3

相关选项

• default_store

警告

此选项已弃用，将来可能会被删除。其值可能会被静默忽略。

原因:

此选项已弃用，取而代之的是新的配置选项 enabled_backends，该选项有助于配置具有不同方案的多个后端存储。此选项计划在 U 开发周期中删除。

default_store

类型:

字符串

默认值:

file

有效值:

file, filesystem, http, https, swift, swift+http, swift+https, swift+config, rbd, cinder, vsphere, s3

用于存储镜像的默认方案。

提供一个字符串值，表示用于存储镜像的默认方案。如果未设置，Glance 将使用 file 作为默认方案，使用 file 存储存储镜像。

注意：为此配置选项提供的值必须是使用 stores 配置选项注册的存储的有效方案。

可能的值

• file

• filesystem

• http

• https

• swift

• swift+http

• swift+https

• swift+config

• rbd

• cinder

• vsphere

• s3

相关选项

• stores

警告

此选项已弃用，将来可能会被删除。其值可能会被静默忽略。

原因:

此选项已弃用，取而代之的是新的配置选项 default_backend，其作用类似于 default_store 配置选项。此选项计划在 U 开发周期中删除。

filesystem_store_datadir

类型:

字符串

默认值:

/var/lib/glance/images

文件系统后端存储写入镜像的目录。

启动时，Glance 会创建该目录（如果它不存在），并验证运行 glance-api 的用户是否具有写入权限。如果未提供写入权限，将引发 BadStoreConfiguration 异常，并且文件系统存储可能无法用于添加新镜像。

注意：只有当文件系统存储用作存储后端时，才使用此目录。必须在 glance-api.conf 中指定 filesystem_store_datadir 或 filesystem_store_datadirs 选项。如果同时指定这两个选项，将引发 BadStoreConfiguration 异常，并且文件系统存储可能无法用于添加新镜像。

可能的值

• 指向目录的有效路径

相关选项

• filesystem_store_datadirs

• filesystem_store_file_perm

filesystem_store_datadirs

类型:

多值

默认值:

''

文件系统后端存储写入镜像的目录列表及其优先级。

文件系统存储可以配置为将镜像存储在多个目录中，而不是使用由 filesystem_store_datadir 配置选项指定的单个目录。在使用多个目录时，可以为每个目录指定可选优先级，以指定应使用的首选顺序。优先级是一个整数，与冒号连接目录路径，其中较高的值表示较高的优先级。当两个目录具有相同的优先级时，将使用具有最多可用空间的目录。如果未指定优先级，则默认值为零。

有关配置使用多个存储目录的文件系统存储的更多信息，请参见 https://docs.openstack.org/glance/2025.2/configuration/configuring.html

注意：只有当文件系统存储用作存储后端时，才使用此目录。必须在 glance-api.conf 中指定 filesystem_store_datadir 或 filesystem_store_datadirs 选项。如果同时指定这两个选项，将引发 BadStoreConfiguration 异常，并且文件系统存储可能无法用于添加新镜像。

可能的值

• 字符串列表，格式如下

  • <有效的 目录路径>:<可选 整数优先级>

相关选项

• filesystem_store_datadir

• filesystem_store_file_perm

警告

此选项在 Flamingo 版本中已弃用，未来可能会被静默忽略。

原因:

希望使用多个数据目录的用户应配置多个文件系统存储，而不是使用 filesystem_store_datadirs。此选项计划在 H 开发周期中删除。

filesystem_store_metadata_file

类型:

字符串

默认值:

<None>

文件系统存储元数据文件。

此选项指定一个文件路径，该文件包含要与文件系统存储关联的任何位置返回的元数据。设置此选项后，它仅对之后创建的新镜像有效 - 之前存在的镜像不受影响。

该文件必须包含有效的 JSON 对象。该对象应包含键 id 和 mountpoint。两个键的值都应该是字符串。

可能的值

• 指向存储元数据文件的有效路径

相关选项

• 无

filesystem_store_file_perm

类型:

整数

默认值:

0

镜像文件的文件访问权限。

设置镜像数据的预期文件访问权限。这提供了一种启用其他服务（例如 Nova）直接从文件系统存储使用镜像的方式。打算授予访问权限的服务运行的用户可以成为拥有创建文件的组的成员。将小于或等于零的值分配给此配置选项表示不对默认权限进行任何更改。此值将解码为八进制数字。

有关更多信息，请参阅 https://docs.openstack.org/glance/2025.2/configuration/configuring.html

可能的值

• 有效的的文件访问权限

• 零

• 任何负整数

相关选项

• 无

filesystem_store_chunk_size

类型:

整数

默认值:

65536

最小值:

1

块大小，以字节为单位。

读取或写入镜像文件时使用的块大小。提高此值可以提高吞吐量，但处理大量请求时可能会略微增加内存使用量。

可能的值

• 任何正整数值

相关选项

• 无

filesystem_thin_provisioning

类型:

布尔值

默认值:

False

启用或禁用此后端的稀疏配置。

此配置选项启用不实际将空字节序列写入文件系统的功能。文件系统将自动将出现的空洞解释为零字节，并且实际上不会消耗存储空间。启用此功能还将加快镜像上传速度并节省网络流量，以及节省后端空间，因为空字节序列不会通过网络发送。

可能的值

• True

• False

相关选项

• 无

https_ca_certificates_file

类型:

字符串

默认值:

<None>

CA 捆绑文件路径。

此配置选项使操作员能够使用自定义证书颁发机构文件来验证远程服务器证书。如果设置此选项，将忽略 https_insecure 选项，并将使用指定的文件来验证服务器证书并建立与服务器的安全连接。

可能的值

• 指向 CA 文件的有效路径

相关选项

• https_insecure

https_insecure

类型:

布尔值

默认值:

True

设置远程服务器证书的验证。

此配置选项采用布尔值，以确定是否验证远程服务器证书。如果设置为 True，则不会验证远程服务器证书。如果将选项设置为 False，则将使用默认 CA 信任库进行验证。

如果设置了 https_ca_certificates_file，则会忽略此选项。然后将使用 https_ca_certificates_file 选项中指定的文件来验证远程服务器证书。

可能的值

• True

• False

相关选项

• https_ca_certificates_file

http_proxy_information

类型:

dict

默认值:

{}

用于连接到远程服务器的 http/https 代理信息。

此配置选项指定应用于连接到远程服务器的 http/https 代理信息。代理信息应为方案和代理的键值对，例如 http:10.0.0.1:3128。您还可以通过用逗号分隔键值对来指定多个方案的代理，例如 http:10.0.0.1:3128, https:10.0.0.1:1080。

可能的值

• 逗号分隔的方案：代理对列表，如上所述

相关选项

• 无

rbd_store_chunk_size

类型:

整数

默认值:

8

最小值:

1

将 RADOS 镜像分成块的大小，以兆字节为单位。

提供一个整数值，表示将 Glance 镜像分成块的大小（以兆字节为单位）。默认块大小为 8 兆字节。为了获得最佳性能，该值应为 2 的幂。

当 Ceph 的 RBD 对象存储系统用作存储 Glance 镜像的存储后端时，镜像将分成大小由此选项设置的块。这些分块对象然后存储在分布式块数据存储中以供 Glance 使用。

可能的值

• 任何正整数值

相关选项

• 无

rbd_store_pool

类型:

字符串

默认值:

images

存储镜像的 RADOS 存储池。

当 RBD 作为 Glance 镜像的存储后端时，镜像通过逻辑分组对象（镜像的块）存储到 池 中。每个池都定义了它可以包含的放置组数量。默认使用的池是 ‘images’。

有关 RBD 存储后端的更多信息，请参见此处：https://ceph.net.cn/planet/how-data-is-stored-in-ceph-cluster/

可能的值

• 有效的池名称

相关选项

• 无

rbd_store_user

类型:

字符串

默认值:

<None>

用于身份验证的 RADOS 用户。

此配置选项接收用于身份验证的 RADOS 用户。仅当启用 RADOS 身份验证并且用户使用 Cephx 身份验证时才需要此选项。如果用户未设置此选项的值或将其设置为 None，则将选择默认值，该值将基于 rbd_store_ceph_conf 中的 client 部分。

可能的值

• 有效的 RADOS 用户

相关选项

• rbd_store_ceph_conf

rbd_store_ceph_conf

类型:

字符串

默认值:

''

Ceph 配置文件路径。

此配置选项指定要使用的 Ceph 配置文件路径。如果用户未设置此选项的值或将其设置为空字符串，librados 将按顺序搜索默认 Ceph 配置文件位置，以读取标准的 ceph.conf 文件。有关详细信息，请参阅 Ceph 文档。

注意：如果使用 Cephx 身份验证，此文件应在 client.<USER> 部分包含对正确 keyring 的引用

注意 2：如果将此选项保留为空（默认值），则实际使用的 Ceph 配置文件可能会根据所使用的 librados 版本而更改。如果对生效的配置文件有明确了解的需求，可以使用此选项在此处指定该文件。

可能的值

• 有效的配置文件路径

相关选项

• rbd_store_user

rados_connect_timeout

类型:

整数

默认值:

-1

连接到 Ceph 集群的超时值。

此配置选项接收用于连接到 Ceph 集群的超时值（以秒为单位），即设置 glance-api 在关闭连接之前等待的时间。这可以防止 glance-api 在连接到 RBD 时挂起。如果此选项的值设置为小于 0，则不设置超时，并使用默认的 librados 值。

可能的值

• 任何整数值

相关选项

• 无

rbd_thin_provisioning

类型:

布尔值

默认值:

False

启用或禁用此后端的稀疏配置。

此配置选项启用不实际写入空字节序列到 RBD 后端的功能，Ceph 会自动将出现的空洞解释为零字节，并且不会真正消耗存储空间。启用此功能还可以加快镜像上传速度并节省网络流量，同时节省后端空间，因为空字节序列不会通过网络发送。

可能的值

• True

• False

相关选项

• 无

s3_store_host

类型:

字符串

默认值:

<None>

S3 服务器侦听的主机。

此配置选项设置 S3 或 S3 兼容存储服务器的主机。在使用 S3 存储后端时，需要此选项。主机可以包含 DNS 名称（例如 s3.amazonaws.com、my-object-storage.com）或 IP 地址（127.0.0.1）。

可能的值

• 有效的 DNS 名称

• 有效的 IPv4 地址

相关选项

• s3_store_access_key

• s3_store_secret_key

s3_store_region_name

类型:

字符串

默认值:

''

S3 区域名称。

此参数将设置 boto 使用的 region_name。如果未设置此参数，我们将尝试从 s3_store_host 计算它。

可能的值

• 有效的区域名称

相关选项

• s3_store_host

s3_store_access_key

类型:

字符串

默认值:

<None>

S3 查询令牌访问密钥。

此配置选项接收用于与 Amazon S3 或 S3 兼容存储服务器进行身份验证的访问密钥。在使用 S3 存储后端时，需要此选项。

可能的值

• 具有适当权限的用户访问密钥的任何字符串值

相关选项

• s3_store_host

• s3_store_secret_key

s3_store_secret_key

类型:

字符串

默认值:

<None>

S3 查询令牌密钥。

此配置选项接收用于与 Amazon S3 或 S3 兼容存储服务器进行身份验证的密钥。在使用 S3 存储后端时，需要此选项。

可能的值

• 与使用 s3_store_host 选项指定的访问密钥对应的任何字符串值

相关选项

• s3_store_host

• s3_store_access_key

s3_store_bucket

类型:

字符串

默认值:

<None>

用于存储 Glance 数据的 S3 存储桶。

此配置选项指定将在 S3 中存储 Glance 镜像的位置。如果 s3_store_create_bucket_on_put 设置为 true，即使存储桶不存在，也会自动创建它。

可能的值

• 任何字符串值

相关选项

• s3_store_create_bucket_on_put

• s3_store_bucket_url_format

s3_store_create_bucket_on_put

类型:

布尔值

默认值:

False

确定 S3 是否应创建一个新的存储桶。

此配置选项接收一个布尔值，指示 Glance 是否应在 S3 中创建新的存储桶（如果它不存在）。

可能的值

• 任何布尔值

相关选项

• 无

s3_store_bucket_url_format

类型:

字符串

默认值:

auto

用于确定对象的 S3 调用格式。

此配置选项接收用于指定 S3 存储桶中对象地址的访问模型。

注意：在 path 样式中，对象的端点看起来像 ‘https://s3.amazonaws.com/bucket/example.img’。在 virtual 样式中，对象的端点看起来像 ‘https://bucket.s3.amazonaws.com/example.img’。如果存储桶名称不遵循 DNS 命名约定，则可以使用路径样式获取对象，但不能使用虚拟样式。

可能的值

• 任何字符串值，例如 auto、virtual 或 path

相关选项

• s3_store_bucket

s3_store_large_object_size

类型:

整数

默认值:

100

最小值:

0

S3 应该从多大尺寸（MB）开始对镜像文件进行分块并在 S3 中执行多部分上传。

此配置选项接收一个阈值（以 MB 为单位），以确定是将图像按原样上传到 S3 还是将其拆分（Multipart Upload）。

注意：您只能拆分最多 10,000 个图像。

可能的值

• 任何正整数值或零

相关选项

• s3_store_large_object_chunk_size

• s3_store_thread_pools

s3_store_large_object_chunk_size

类型:

整数

默认值:

10

S3 在上传部分时应使用的多部分上传部分大小（MB）。

此配置选项接收用于 Multipart Upload 的图像拆分大小（以 MB 为单位）。

注意：您只能拆分最多 10,000 个图像。

可能的值

• 任何正整数值（必须大于或等于 5M）

相关选项

• s3_store_large_object_size

• s3_store_thread_pools

s3_store_thread_pools

类型:

整数

默认值:

10

执行 S3 中的多部分上传的线程池数量。

此配置选项接收在执行 Multipart Upload 时使用的线程池数量。

可能的值

• 任何正整数值

相关选项

• s3_store_large_object_size

• s3_store_large_object_chunk_size

s3_store_cacert

类型:

字符串

默认值:

''

要使用的 CA 证书包的路径。默认值（空字符串）强制使用 botocore 使用的默认 CA 证书包。

可能的值

• 要使用的 CA 证书包的路径

• 使用 botocore 使用的默认 CA 证书包的空字符串

swift_store_auth_insecure

类型:

布尔值

默认值:

False

设置服务器证书的验证。

此布尔值确定是否验证服务器证书。如果此选项设置为 True，swiftclient 在身份验证时不会检查有效的 SSL 证书。如果该选项设置为 False，则使用默认的 CA truststore 进行验证。

可能的值

• True

• False

相关选项

• swift_store_cacert

swift_store_cacert

类型:

字符串

默认值:

/etc/ssl/certs/ca-certificates.crt

此选项有一个示例默认值，这意味着其实际默认值可能与上述文档值不同。

CA 捆绑文件路径。

此配置选项允许操作员指定用于在连接到 Swift 时进行 SSL 验证的自定义证书颁发机构文件的路径。

可能的值

• 指向 CA 文件的有效路径

相关选项

• swift_store_auth_insecure

swift_store_region

类型:

字符串

默认值:

RegionTwo

此选项有一个示例默认值，这意味着其实际默认值可能与上述文档值不同。

Glance 要使用的 Swift 区域。

提供一个字符串值，表示 Glance 可以连接以进行图像存储的 Swift 区域。默认情况下，未设置区域。

当 Glance 使用 Swift 作为存储后端来存储特定租户的镜像，而该租户在不同区域拥有多个端点时，使用 swift_store_region 设置 Swift 区域允许 Glance 连接到指定区域的 Swift，而不是单个区域的连接。

此选项可以为单租户和多租户存储配置。

注意：使用 swift_store_region 设置区域是特定于租户的，并且仅在租户在不同区域拥有多个端点时才需要。

可能的值

• 表示有效 Swift 区域的字符串值。

相关选项

• 无

swift_store_endpoint

类型:

字符串

默认值:

https://swift.openstack.example.org/v1/path_not_including_container_name

此选项有一个示例默认值，这意味着其实际默认值可能与上述文档值不同。

用于 Swift 后端存储的 URL 端点。

提供一个字符串值，表示用于在 Swift 存储中存储 Glance 镜像的 URL 端点。默认情况下，未设置端点，并使用 auth 返回的存储 URL。使用 swift_store_endpoint 设置端点会覆盖存储 URL，并用于 Glance 镜像存储。

注意：URL 应包含到但不包括容器的路径。通过将容器和对象附加到配置的 URL 来获取对象的地址。

可能的值

• 表示 Swift 容器的有效 URL 路径的字符串值

相关选项

• 无

swift_store_endpoint_type

类型:

字符串

默认值:

publicURL

有效值:

publicURL, adminURL, internalURL

Swift 服务的端点类型。

此字符串值指示用于获取 Swift 端点的端点类型。端点类型确定用户将允许执行的操作，例如，读取和写入存储。

可能的值

• publicURL

• adminURL

• internalURL

相关选项

• swift_store_endpoint

swift_store_service_type

类型:

字符串

默认值:

object-store

要使用的 Swift 服务类型。

提供一个字符串值，表示在使用 Swift 后端存储时用于存储镜像的服务类型。默认服务类型设置为 object-store。

可能的值

• 表示 Swift 存储的有效服务类型的字符串。

相关选项

• 无

swift_store_container

类型:

字符串

默认值:

glance

存储镜像的单个容器的名称/多个容器名称的前缀

当使用单个容器来存储镜像时，此配置选项指示要在 Glance 帐户中用于存储所有镜像的容器。当使用多个容器来存储镜像时，这将是所有容器的名称前缀。可以使用配置选项 swift_store_multiple_containers_seed 来控制使用单个/多个容器。

当使用多个容器时，容器的名称将以该配置选项的值加上镜像 UUID 的前 N 个字符作为后缀（用下划线分隔，其中 N 由 swift_store_multiple_containers_seed 指定）。

例如：如果种子设置为 3 并且 swift_store_container = glance，则 UUID 为 fdae39a1-bac5-4238-aba4-69bcc726e848 的镜像将放置在容器 glance_fda 中。UUID 中的所有破折号都包含在创建容器名称中，但不计入字符限制，因此当 N=10 时，容器名称将为 glance_fdae39a1-ba.

可能的值

• 如果使用单个容器，此配置选项可以是 Glance 的 Swift 帐户中的任何有效的 swift 容器名称

• 如果使用多个容器，此配置选项可以是任何字符串，只要它满足 Swift 强制执行的容器命名规则即可。还应考虑 swift_store_multiple_containers_seed 的值。

相关选项

• swift_store_multiple_containers_seed

• swift_store_multi_tenant

• swift_store_create_container_on_put

swift_store_large_object_size

类型:

整数

默认值:

5120

最小值:

1

当图像数据的大小超过此阈值（MB）时，Glance 将开始对图像数据进行分段。

Swift 对单个上传对象的尺寸有限制。默认情况下，此限制为 5GB。要上传大于此限制的对象，对象将被分割成多个较小的对象，并通过清单文件将它们绑定在一起。有关更多详细信息，请参阅 https://docs.openstack.org/swift/2025.2/overview_large_objects.html

此配置选项指定 Swift 驱动程序开始将图像数据分成多个较小文件的大小阈值。目前，Swift 驱动程序仅支持创建动态大对象。

注意：应考虑到 Swift 集群强制执行的大对象限制来设置此值。

可能的值

• 一个正整数，小于或等于 Swift 集群强制执行的大对象限制。

相关选项

• swift_store_large_object_chunk_size

swift_store_large_object_chunk_size

类型:

整数

默认值:

200

最小值:

1

当图像数据被分段时，分段的最大大小（MB）。

当图像数据被分段以上传大于 Swift 集群强制限制的图像时，图像数据将被分成小于此配置选项指定大小的分段。有关更多详细信息，请参阅 swift_store_large_object_size。

例如：如果 swift_store_large_object_size 为 5GB，而 swift_store_large_object_chunk_size 为 1GB，则大小为 6.2GB 的图像将被分成 7 个分段，其中前 6 个分段的大小为 1GB，第七个分段的大小为 0.2GB。

可能的值

• 一个正整数，小于或等于 Swift 集群强制执行的大对象限制。

相关选项

• swift_store_large_object_size

swift_store_create_container_on_put

类型:

布尔值

默认值:

False

在上传图像时，如果容器不存在则创建容器。

在上传图像时，如果对应的容器不存在，并且此配置选项设置为 True，则将创建该容器。默认情况下，不会创建它。此行为适用于单容器和多容器模式。

可能的值

• True

• False

相关选项

• 无

swift_store_multi_tenant

类型:

布尔值

默认值:

False

将图像存储在租户的 Swift 帐户中。

这启用了多租户存储模式，导致 Glance 图像存储在租户特定的 Swift 帐户中。如果禁用此选项，Glance 将所有图像存储在其自己的帐户中。有关多租户存储的更多详细信息，请参阅 https://wiki.openstack.org/wiki/GlanceSwiftTenantSpecificStorage

注意：如果使用多租户 Swift 存储，请确保不要设置带有“swift_store_config_file”选项的 Swift 配置文件。

可能的值

• True

• False

相关选项

• swift_store_config_file

swift_store_multiple_containers_seed

类型:

整数

默认值:

0

最小值:

0

最大值:

32

用于存储图像的容器数量的种子。

在使用单租户存储时，图像可以存储在一个或多个容器中。设置为 0 时，所有图像都将存储在一个容器中。设置为 1 到 32 之间的整数值时，将使用多个容器来存储图像。此配置选项将确定创建多少个容器。将使用的容器总数等于 16^N，因此如果将此配置选项设置为 2，则将使用 16^2=256 个容器来存储图像。

请参阅 swift_store_container 以获取有关命名约定的更多详细信息。有关使用多个容器的更多详细信息，请参阅 https://specs.openstack.org/openstack/glance-specs/specs/2025.2/swift-store-multiple-containers.html

注意：只有在禁用 swift_store_multi_tenant 时才使用此选项。

可能的值

• 一个非负整数，小于或等于 32

相关选项

• swift_store_container

• swift_store_multi_tenant

• swift_store_create_container_on_put

swift_store_admin_tenants

类型:

列表

默认值:

[]

将被授予管理员访问权限的租户列表。

这是将在多租户模式下获得对 Glance 创建的所有 Swift 容器的读/写访问权限的租户列表。默认值为一个空列表。

可能的值

• 表示 Keystone 项目/租户 UUID 的逗号分隔的字符串列表

相关选项

• 无

swift_store_ssl_compression

类型:

布尔值

默认值:

True

HTTPS Swift 请求的 SSL 层压缩。

提供一个布尔值来确定是否要在 SSL 层压缩图像的 HTTPS Swift 请求。默认情况下，启用压缩。

当使用 Swift 作为 Glance 图像存储的后端存储时，可以使用此选项设置 HTTPS Swift 请求的 SSL 层压缩。如果设置为 False，则禁用 HTTPS Swift 请求的 SSL 层压缩。禁用此选项可能会提高已经压缩格式的图像（例如 qcow2）的性能。

可能的值

• True

• False

相关选项

• 无

swift_store_retry_get_count

类型:

整数

默认值:

0

最小值:

0

Swift 下载将被重试的次数，直到请求失败。

提供一个整数值，表示在出错之前必须重试图像下载的次数。默认值为零（在图像下载失败时不会重试）。设置为正整数值时，swift_store_retry_get_count 确保在发送错误消息之前，下载将在下载失败后尝试多次。

可能的值

• 零

• 正整数值

相关选项

• 无

swift_store_expire_soon_interval

类型:

整数

默认值:

60

最小值:

0

定义当前令牌到期前可以请求新令牌的时间窗口（秒）。

通常，Swift 存储驱动程序会在当前令牌到期时获取新令牌，以确保继续访问 Swift。但是，某些 Swift 事务（例如上传图像分段）可能无法很好地恢复令牌到期的情况。

因此，在当前令牌到期之前请求新令牌，我们可以确保令牌不会到期或在尝试事务之前即将到期。默认情况下，Swift 存储驱动程序在当前令牌到期前 60 秒或更短的时间内请求新令牌。

可能的值

• 零

• 正整数值

相关选项

• 无

swift_store_use_trusts

类型:

布尔值

默认值:

True

在多租户 Swift 存储中使用信任。

当使用多租户存储时，此选项指示 Swift 存储为每个添加/获取请求创建一个信任。使用信任允许 Swift 存储避免由于身份验证令牌到期而可能导致的问题。

默认情况下，swift_store_use_trusts 设置为 True``(启用 信任 的使用)。 如果 设置为 False，则将使用用户令牌进行 Swift 连接，从而消除了创建信任的开销。

注意：仅当 swift_store_multi_tenant 设置为 True 时才考虑此选项

可能的值

• True

• False

相关选项

• swift_store_multi_tenant

swift_buffer_on_upload

类型:

布尔值

默认值:

False

在上传到 Swift 之前缓冲图像分段。

提供一个布尔值，以指示 Glance 是否应在上传到 swift 时将图像数据缓冲到磁盘。这使 Glance 能够在出错时恢复上传。

注意：启用此选项时，应格外小心，因为它会增加 API 节点上的磁盘使用量。请注意，根据文件系统的配置，用于缓冲的磁盘空间可能会减少实际可用的 Glance 图像缓存磁盘空间。磁盘利用率将根据以下公式确定：（swift_store_large_object_chunk_size * workers * 1000）

可能的值

• True

• False

相关选项

• swift_upload_buffer_dir

default_swift_reference

类型:

字符串

默认值:

ref1

对默认 Swift 帐户/后端存储参数的引用。

提供一个字符串值，表示对使用 swift 帐户/后端存储进行图像存储所需的默认参数集。此配置选项取消引用参数并促进每次添加新图像时在 Swift 存储后端中存储图像。

可能的值

• 一个有效的字符串值

相关选项

• 无

swift_store_auth_version

类型:

字符串

默认值:

3

有效值:

3

要使用的身份验证版本。当前唯一有效的版本是 3。

警告

此选项已弃用，将来可能会被静默忽略。

原因:

此选项是为了向后兼容的原因而保留的，但不再需要，因为现在仅支持单个版本（3）。

swift_store_auth_address

类型:

字符串

默认值:

<None>

Swift 身份验证服务正在侦听的地址。

警告

此选项已弃用，将来可能会被静默忽略。

原因:

Swift 后端配置文件中的“auth_address”选项代替使用。

swift_store_user

类型:

字符串

默认值:

<None>

用于对 Swift 身份验证服务进行身份验证的用户。

警告

此选项已弃用，将来可能会被静默忽略。

原因:

Swift 后端配置文件中的“user”选项代替设置。

swift_store_key

类型:

字符串

默认值:

<None>

用于对 Swift 身份验证服务进行身份验证的用户的身份验证密钥。

警告

此选项已弃用，将来可能会被静默忽略。

原因:

Swift 后端配置文件中的“key”选项用于设置身份验证密钥。

swift_store_config_file

类型:

字符串

默认值:

<None>

包含 swift 帐户配置的文件的绝对路径。

包括一个字符串值，表示指向包含每个配置的 Swift 帐户/后端存储引用的文件的路径。默认情况下，未指定任何文件路径，并且禁用了自定义 Swift 引用。配置此选项强烈建议在使用 Swift 存储后端进行图像存储时使用，因为它避免了将凭据存储在数据库中。

注意：如果将 swift_store_multi_tenant 设置为 True，请不要配置此选项。

可能的值

• 表示 glance-api 节点上绝对路径的字符串值

相关选项

• swift_store_multi_tenant

swift_upload_buffer_dir

类型:

字符串

默认值:

<None>

在上传到 Swift 之前缓冲图像分段的目录。

提供一个字符串值，表示 glance 节点上用于在上传到 swift 之前短暂缓冲图像分段的目录的绝对路径。

注意

• 仅当配置选项 swift_buffer_on_upload 设置为 True 时才需要此选项。

• 应考虑到 swift_store_large_object_chunk_size 和给定 glance 节点可以同时上传的最大图像数量来配置此目录。

可能的值

• 表示绝对目录路径的字符串值

相关选项

• swift_buffer_on_upload

• swift_store_large_object_chunk_size

vmware_server_host

类型:

主机地址

默认值:

127.0.0.1

此选项有一个示例默认值，这意味着其实际默认值可能与上述文档值不同。

ESX/ESXi 或 vCenter Server 目标系统的地址。

此配置选项设置 ESX/ESXi 或 vCenter Server 目标系统的地址。在使用 VMware 存储后端时，此选项是必需的。地址可以包含 IP 地址（127.0.0.1）或 DNS 名称（www.my-domain.com）。

可能的值

• 一个有效的 IPv4 或 IPv6 地址

• 有效的 DNS 名称

相关选项

• vmware_server_username

• vmware_server_password

vmware_server_username

类型:

字符串

默认值:

root

此选项有一个示例默认值，这意味着其实际默认值可能与上述文档值不同。

服务器用户名。

此配置选项获取用于与 VMware ESX/ESXi 或 vCenter Server 进行身份验证的用户名。在使用 VMware 存储后端时，此选项是必需的。

可能的值

• 具有适当权限的用户的任何字符串

相关选项

• vmware_server_host

• vmware_server_password

vmware_server_password

类型:

字符串

默认值:

vmware

此选项有一个示例默认值，这意味着其实际默认值可能与上述文档值不同。

服务器密码。

此配置选项获取用于与 VMware ESX/ESXi 或 vCenter Server 进行身份验证的密码。在使用 VMware 存储后端时，此选项是必需的。

可能的值

• 与使用“vmware_server_username”选项指定的用户名对应的任何字符串密码

相关选项

• vmware_server_host

• vmware_server_username

vmware_api_retry_count

类型:

整数

默认值:

10

最小值:

1

VMware API 重试次数。

此配置选项指定在连接相关问题或服务器 API 调用过载时，必须重试 VMware ESX/VC 服务器 API 的次数。不可能指定“无限重试”。

可能的值

• 任何正整数值

相关选项

• 无

vmware_task_poll_interval

类型:

整数

默认值:

5

最小值:

1

轮询在 VMware ESX/VC 服务器上启动的远程任务的间隔时间，单位为秒。

此配置选项接受轮询正在进行的异步任务时，VMWare ESX/VC 服务器 API 调用中睡眠的时间（单位为秒）。

可能的值

• 任何正整数值

相关选项

• 无

vmware_store_image_dir

类型:

字符串

默认值:

/openstack_glance

Glance 镜像将在数据存储中存储的目录。

此配置选项指定 Glance 镜像将在 VMware 数据存储中存储的目录路径。 如果未设置此选项，Glance 镜像存储的默认目录为 openstack_glance。

可能的值

• 任何有效的目录路径字符串

相关选项

• 无

vmware_insecure

类型:

布尔值

默认值:

False

设置 ESX/vCenter 服务器证书的验证。

此配置选项接受一个布尔值，以确定是否验证 ESX/vCenter 服务器证书。 如果此选项设置为 True，则不验证 ESX/vCenter 服务器证书。 如果此选项设置为 False，则使用默认 CA 信任库进行验证。

如果设置了“vmware_ca_file”选项，则忽略此选项。 在这种情况下，将使用“vmware_ca_file”选项中指定的文件来验证 ESX/vCenter 服务器证书。

可能的值

• True

• False

相关选项

• vmware_ca_file

已弃用的变体

Group	名称
glance_store	vmware_api_insecure

vmware_ca_file

类型:

字符串

默认值:

/etc/ssl/certs/ca-certificates.crt

此选项有一个示例默认值，这意味着其实际默认值可能与上述文档值不同。

CA 捆绑包文件的绝对路径。

此配置选项允许操作员使用自定义证书颁发机构文件来验证 ESX/vCenter 证书。

如果设置此选项，将忽略“vmware_insecure”选项，并使用指定的 CA 文件来验证 ESX/vCenter 服务器证书并建立与服务器的安全连接。

可能的值

• 任何有效的 CA 文件的绝对路径字符串

相关选项

• vmware_insecure

vmware_datastores

类型:

多值

默认值:

''

可以存储镜像的数据存储。

此配置选项指定可以在 VMWare 存储后端中存储镜像的数据存储。 可以多次指定此选项以指定多个数据存储。 数据存储名称应在数据中心路径之后指定，并用“:”分隔。 可以在数据存储名称之后再次用“:”分隔一个可选的权重，以指定优先级。 因此，所需的格式变为 <datacenter_path>:<datastore_name>:<optional_weight>。

在添加镜像时，将选择权重最高的数据存储，除非在已知镜像大小时，可用空间不足。 如果未指定权重，则假定为零，并且在选择时会最后考虑该目录。 如果多个数据存储具有相同的权重，则选择可用空间最多的数据存储。

可能的值

• 任何格式为 <datacenter_path>:<datastore_name>:<optional_weight> 的字符串

相关选项

• 无

oslo_policy

enforce_scope

类型:

布尔值

默认值:

True

此选项控制在评估策略时是否强制执行范围。如果为 True，则将请求中使用的令牌的范围与正在强制执行的策略的 scope_types 进行比较。如果范围不匹配，将引发 InvalidScope 异常。如果为 False，将记录一条消息，告知操作员策略正在使用不匹配的范围调用。

警告

此选项已弃用，将来可能会被静默忽略。

原因:

此配置是临时添加的，旨在促进顺利过渡到新的 RBAC。OpenStack 将始终强制执行范围检查。此配置选项已被弃用，将在 2025.2 版本周期中删除。

enforce_new_defaults

类型:

布尔值

默认值:

True

此选项控制在评估策略时是否使用旧的弃用默认值。如果为 True，则不会评估旧的弃用默认值。这意味着，如果任何现有的令牌允许使用旧的默认值，但对于新的默认值不允许，则将被禁止。鼓励启用此标志以及 enforce_scope 标志，以便同时获得新默认值和 scope_type 的好处。如果为 False，则逻辑上将弃用策略检查字符串与新的策略检查字符串进行 OR 运算，从而允许在具有新策略的发布版本之间实现平滑的升级体验，这是默认行为。

policy_file

类型:

字符串

默认值:

policy.yaml

将角色映射到给定服务权限的文件的相对或绝对路径。相对路径必须相对于设置此选项的配置文件指定。

policy_default_rule

类型:

字符串

默认值:

default

默认规则。在找不到请求的规则时强制执行。

policy_dirs

类型:

多值

默认值:

policy.d

存储策略配置文件目录。它们可以相对于 config_dir 选项定义的搜索路径中的任何目录，也可以是绝对路径。要搜索这些目录，必须存在 policy_file 中定义的的文件。忽略丢失或空的目录。

remote_content_type

类型:

字符串

默认值:

application/x-www-form-urlencoded

有效值:

application/x-www-form-urlencoded, application/json

用于基于 REST 的策略检查发送和接收数据的 Content Type

remote_ssl_verify_server_crt

类型:

布尔值

默认值:

False

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

remote_ssl_ca_crt_file

类型:

字符串

默认值:

<None>

基于 REST 的策略检查的 ca 证书文件的绝对路径

remote_ssl_client_crt_file

类型:

字符串

默认值:

<None>

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

remote_ssl_client_key_file

类型:

字符串

默认值:

<None>

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

remote_timeout

类型:

浮点数

默认值:

60

最小值:

0

基于 REST 的策略检查的超时时间（秒）