3.2. glance-scrubber.conf


本节包含 /etc/glance/glance-scrubber.conf 文件的选项。

3.2.1. DEFAULT

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

.

Expand
配置选项 = 默认值类型Description

allow_additional_image_properties = True

布尔值

允许用户向镜像添加额外的/自定义属性。

Glance 定义一组标准的属性(在其架构中),它们出现在每个镜像上。这些属性也称为基本属性。除了这些属性外,Glance 还允许用户添加自定义属性到镜像。它们称为 其他属性

默认情况下,此配置选项设置为 True,用户可以添加额外的属性。可添加到镜像的额外属性数量可以通过 image_property_quota 配置选项来控制。

可能的值:

  • True
  • False

相关选项:

  • image_property_quota

api_limit_max = 1000

整数值

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

limit_param_default 的帮助文本中所述,一些请求可能会返回多个结果。要返回的结果数量由请求中的 limit 参数或 limit_param_default 配置选项管理。在这两种情况下,的值都不能大于此配置选项定义的绝对最大值。大于这个值的任何内容都会舍入到此处定义的最大值。

注意

把它设置为非常大的值可能会减慢数据库查询并增加响应时间。把它设置为非常低的值可能会导致用户体验不佳。

可能的值:

  • 任何正整数

相关选项:

  • limit_param_default

daemon = False

布尔值

以守护进程形式运行 scrubber。

此布尔值配置选项指示清理网络是否应该作为长时间运行的进程运行,以定期唤醒清理镜像。可使用 wakeup_time 配置选项指定 wake up 间隔。

如果此配置选项设为 False (默认值),清理网络运行一次以清理镜像并退出。在这种情况下,如果操作器希望实施持续清理镜像,则需要将清理网络调度为 cron 作业。

可能的值:

  • True
  • False

相关选项:

  • wakeup_time

data_api = glance.db.sqlalchemy.api

字符串值

数据访问 API 的 Python 模块路径。

指定用于访问数据模型的 API 路径。此选项决定了如何访问镜像目录数据。

可能的值:

  • glance.db.sqlalchemy.api
  • glance.db.registry.api
  • glance.db.simple.api

如果此选项设为 glance.db.sqlalchemy.api,则镜像目录数据将存储在 中,并通过 SQLAlchemy Core 和 ORM API 从数据库中读取。

将这个选项设置为 glance.db.registry.api 将强制所有数据库访问请求通过 Registry 服务路由。这可避免 Glance API 节点的数据访问,以实现额外的安全性、可扩展性和易管理层。

注意

在 v2 OpenStack Images API 中,registry 服务是可选的。要在 v2 中使用 Registry API,选项 enable_v2_registry 必须设置为 True

最后,当此配置选项设置为 glance.db.simple.api 时,镜像目录数据存储在 中,并从内存中数据结构中读取。这主要用于测试。

相关选项:

  • enable_v2_api
  • enable_v2_registry

弃用自: Queens

原因: Glance 注册表服务在移除期间已弃用。

如需更多信息,请参阅 spec: http://specs.openstack.org/openstack/glance-specs/specs/queens/approved/glance/deprecate-registry.html

debug = False

布尔值

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

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,则忽略这个选项。

delayed_delete = False

布尔值

打开/关闭延迟删除。

通常,当镜像被删除时,glance-api 服务会将镜像置于 已删除 状态,并同时删除其数据。延迟删除是 Glance 中的一项功能,可延迟实际删除镜像数据直到后续时间(根据配置选项 scrub_time决定)。打开延迟删除时,glance-api 服务会在删除时将镜像放入 pending_delete 状态,并将镜像数据保留在存储后端中,以便稍后删除。在成功删除镜像数据时,镜像清理 网络会将镜像移至已删除 状态。

注意

打开延迟删除时,镜像清理网络 MUST 将作为定期运行,以防止后端存储使用不必要的使用量。

可能的值:

  • True
  • False

相关选项:

  • scrub_time
  • wakeup_time
  • scrub_pool_size

digest_algorithm = sha256

字符串值

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

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

要获取平台上 OpenSSL 版本支持的可用算法列表,请运行命令: openssl list-message-digest-algorithms。示例是 sha1sha256sha512

注意

digest_algorithm 与 Glance 的镜像签名和验证无关。它仅用于将通用唯一标识符(UUID)作为证书文件验证的一部分签名。

可能的值:

  • OpenSSL 消息摘要算法标识符

关系选项:

  • None

enable_v1_registry = True

布尔值

弃用以进行删除

弃用自: Newton

*reason:* Images (Glance)版本 1 API 在 Newton 版本中是 DEPRECATED,并将根据标准 OpenStack 弃用策略删除。因此,特定于镜像(Glance) v1 API 的配置选项在此处已弃用,并可能被删除。建议 Operator 部署镜像(Glance) v2 API。

enable_v2_api = True

布尔值

部署 v2 OpenStack 镜像 API。

当此选项设为 True 时,Glance 服务将响应符合 v2 OpenStack Images API 的注册端点的请求。

备注:

  • 如果禁用了这个选项,则还要禁用 enable_v2_registry 选项(默认启用)。

可能的值:

  • True
  • False

相关选项:

  • enable_v2_registry

弃用自: Newton

*reason:* Images (Glance)版本 1 API 已在 Newton 发行版本中为 DEPRECATED。根据标准 OpenStack 弃用策略,它将在 Pike 版本上或之后删除。删除镜像(Glance) v1 API 后,只能部署镜像(Glance) v2 API,并默认启用此选项,使此选项冗余。

enable_v2_registry = True

布尔值

部署 v2 API Registry 服务。

当此选项设为 True 时,在 Glance 中为 v2 API 请求启用 Registry 服务。

备注:

  • 在 v2 API 中使用 Registry 是可选的,因此只有在 enable_v2_api 设置为 True 并且 data_api 选项被设为 glance.db.registry.api 时,才必须启用此选项。
  • 如果仅部署 v1 OpenStack Images API,则此选项应被禁用。

可能的值:

  • True
  • False

相关选项:

  • enable_v2_api
  • data_api

弃用自: Queens

原因: Glance 注册表服务在移除期间已弃用。

如需更多信息,请参阅 spec: http://specs.openstack.org/openstack/glance-specs/specs/queens/approved/glance/deprecate-registry.html

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

列出值

启用的镜像导入方法列表

'glance-direct', 'copy-image' and 'web-download' are enabled by default.
Copy to Clipboard Toggle word wrap
    Related options:
** [DEFAULT]/node_staging_uri
Copy to Clipboard Toggle word wrap

fatal_deprecations = False

布尔值

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

hashing_algorithm = sha512

字符串值

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

此选项配置 Glance"multihash",它由两个镜像属性组成: os_hash_algoos_hash_valueos_hash_algo 将由此配置选项的值填充,在算法应用到上传或导入的镜像数据时,os_hash_value 将由 hexdigest 填充。

该值必须是由 python hashlib 库识别的有效安全哈希算法名称。您可以通过检查 Glance 安装中使用的库版本的 hashlib.algorithms_available 数据成员来确定它们。然而,为了实现互操作性,我们建议您使用由 hashlib.algorithms_guaranteed 数据成员提供的安全散列名称集,因为所有平台上的 hashlib 库都可以保证支持这些算法。因此,在本地使用 hashlib 的任何镜像使用者都应该能够验证镜像的 os_hash_value

sha512 的默认值是一个性能安全哈希算法。

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

可能的值:

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

相关选项:

  • None

image_location_quota = 10

整数值

镜像允许的最大位置数。

任何负值都解释为无限。

相关选项:

  • None

image_member_quota = 128

整数值

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

这限制了镜像可以被共享的最大用户。任何负值都解释为无限。

相关选项:

  • None

image_property_quota = 128

整数值

镜像允许的最大属性数。

这对镜像可以具有的额外属性数量强制实施上限。任何负值都解释为无限。

注意

如果禁用附加属性,则这不会影响。请参阅 allow_additional_image_properties

相关选项:

  • allow_additional_image_properties

image_size_cap = 1099511627776

整数值

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

镜像上传大于此处提到的大小,会导致镜像创建失败。此配置选项默认为 1099511627776 字节(1 TiB)。

备注:

  • 这个值只有在仔细考虑后才会增加,且必须设置小于或等于 8 EiB (9223372036854775808)。
  • 此值必须在仔细考虑后端存储容量时设置。把它设置为非常低的值可能会导致大量镜像失败。另外,将其设置为非常大的值可能会导致存储更快地消耗。因此,这必须根据所创建和存储容量的性质来设置。

可能的值:

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

image_tag_quota = 128

整数值

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

任何负值都解释为无限。

相关选项:

  • None

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

字符串值

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

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

字符串值

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

limit_param_default = 25

整数值

返回请求的默认结果数。

对某些 API 请求(如列表镜像)的响应可能会返回多个项目。通过在 API 请求中指定 limit 参数,可以明确控制返回的结果数量。但是,如果没有指定 limit 参数,此配置值将用作任何 API 请求返回的默认结果数。

备注:

  • 此配置选项的值可能不大于 api_limit_max 指定的值。
  • 把它设置为非常大的值可能会减慢数据库查询并增加响应时间。把它设置为非常低的值可能会导致用户体验不佳。

可能的值:

  • 任何正整数

相关选项:

  • api_limit_max

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_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 使用

max_logfile_count = 30

整数值

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

max_logfile_size_mb = 200

整数值

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

metadata_encryption_key = None

字符串值

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

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

注意

要使用的 AES 密钥必须设置为长度为 16、24 或 32 字节的随机字符串。

可能的值:

  • 代表有效 AES 键的字符串值

相关选项:

  • None

node_staging_uri = file:///tmp/staging/

字符串值

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

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

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

注意

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

注意

file://<absolute-directory-path > 是唯一支持 api_image_import 流的选项。

注意

暂存路径必须位于所有 Glance API 节点可用的共享文件系统上。

可能的值:

  • file:// 开头加绝对 FS 路径的字符串

相关选项:

  • [task]/work_dir

publish_errors = False

布尔值

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

pydev_worker_debug_host = None

主机地址值

pydev 服务器的主机地址。

提供字符串值,代表用于调试的 pydev 服务器的主机名或 IP。pydev 服务器侦听此地址上的调试连接,有助于在 Glance 中进行远程调试。

可能的值:

  • 有效主机名
  • 有效的 IP 地址

相关选项:

  • None

pydev_worker_debug_port = 5678

端口值

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

提供将 pydev 服务器绑定到的端口号。pydev 进程接受此端口上的调试连接,并在 Glance 中实现远程调试。

可能的值:

  • 有效端口号

相关选项:

  • None

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

整数值

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

restore = None

字符串值

将镜像状态从 pending_delete 恢复到 active

当镜像被错误删除且 Glance 中启用了 pending delete 功能,管理员可利用此选项将镜像的状态从 pending_delete 重置为 active。请确保在恢复镜像前停止 glance-scrubber 守护进程,以避免镜像数据不一致。

可能的值:

  • 镜像的 uuid

scrub_pool_size = 1

整数值

用于清理镜像的线程池大小。

当需要清理大量镜像时,清理镜像会有助于并行清理镜像,以便清理队列可以保持控制,并且后端存储会及时回收。此配置选项表示并行清理的最大镜像数。默认值为 one,它表示串行清理。上述任何值都表示并行清理。

可能的值:

  • 任何非零正整数

相关选项:

  • delayed_delete

scrub_time = 0

整数值

延迟镜像清理的时间(以秒为单位)。

打开延迟删除后,镜像会在删除时放入 pending_delete 状态,直到清理网络删除其镜像数据。通常,在镜像放入 pending_delete 状态后,镜像可以被清理。但是,清理过程可能会延迟到之后使用这个配置选项。此选项表示镜像在可用于清理前处于 pending_delete 状态的时间段。

这一点很重要,这对存储有影响。scrub_time 越大,从已删除的镜像回收后端存储的时间越长。

可能的值:

  • 任何非负整数

相关选项:

  • delayed_delete

show_image_direct_url = False

布尔值

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

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

当镜像存在多个镜像位置时,会根据配置选项 location_strategy 所示的位置显示最佳位置。

备注:

  • 显示镜像位置可能会显示 GRAVE SECURITY RISK,因为镜像位置有时可以包含凭证。因此,默认设置为 False。把它设置为 True,使用 EXTREME CAUTION,仅限 IF 您知道您的操作!
  • 如果操作员希望避免向用户显示任何镜像位置,则此选项和 show_multiple_locations 必须设为 False

可能的值:

  • True
  • False

相关选项:

  • show_multiple_locations
  • location_strategy

show_multiple_locations = False

布尔值

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

此配置选项指示在将镜像详细信息返回给用户时是否显示所有镜像位置。当镜像存在多个镜像位置时,位置会根据配置 opt location_strategy 所指示的位置策略进行排序。镜像位置显示在镜像属性 位置 下。

备注:

  • 显示镜像位置可能会显示 GRAVE SECURITY RISK,因为镜像位置有时可以包含凭证。因此,默认设置为 False。把它设置为 True,使用 EXTREME CAUTION,仅限 IF 您知道您的操作!
  • 如需更多信息,请参阅 https://wiki.openstack.org/wiki/OSSN/OSSN-0065
  • 如果操作员希望避免向用户显示任何镜像位置,则此选项和 show_image_direct_url 必须设为 False

可能的值:

  • True
  • False

相关选项:

  • show_image_direct_url
  • location_strategy

弃用自: Newton

*reason:*Use of this option (自 Newton 起已弃用)是一个安全风险,并在我们找出一个满足当前需要它的用例时删除。较早的公告,使用策略可以以更大的粒度来实现相同的功能。您目前无法通过策略配置来临时解决这个选项,但我们认为修复将采取方向。请留意 Glance 发行注记,以继续解决此问题。

syslog-log-facility = LOG_USER

字符串值

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

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_eventlog = False

布尔值

日志输出到 Windows 事件日志。

use_stderr = False

布尔值

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

user_storage_quota = 0

字符串值

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

这对所有存储中的所有租户使用的总存储实施上限。这是按租户的限制。

此配置选项的默认单位是字节。但是,可以使用区分大小写的文字 BKBMBGBTB 指定存储单元,分别代表 Bytes、KiloBytes、MegaBytes 和 TeraBytes。请注意,值和单元之间不应有任何空格。值 0 表示没有配额强制。负值无效,并导致错误。

可能的值:

  • 字符串是代表存储值的非负整数的有效连接,以及代表上述存储单元的可选字符串字面量。

相关选项:

  • None

wakeup_time = 300

整数值

清理网络在守护进程模式下运行的时间间隔(以秒为单位)。

scrubber 可以作为 cron 作业或守护进程运行。当作为守护进程运行时,此配置时间指定两个运行之间的时间段。当唤醒清理程序时,它会考虑 scrub_time,获取并清理所有可以被清理的 pending_delete 镜像。

如果唤醒时间时间设置为一个非常大的值,则每次运行时可能会清理大量镜像。另外,这会影响后端存储回收的速度。

可能的值:

  • 任何非负整数

相关选项:

  • daemon
  • delayed_delete

watch-log-file = False

布尔值

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

3.2.2. database

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

Expand
表 3.25. 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 调用启用实验性的线程池使用

3.2.3. glance_store

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

Expand
表 3.26. glance_store
配置选项 = 默认值类型Description

cinder_api_insecure = False

布尔值

允许对 cinder 执行不安全的 SSL 请求。

如果此选项被设置为 True,则使用 cinder_ca_certificates_file 选项指定的 CA 证书文件验证 HTTPS 端点连接。

可能的值:

  • True
  • False

相关选项:

  • cinder_ca_certificates_file

cinder_ca_certificates_file = None

字符串值

用于 cinder 客户端请求的 CA 证书文件的位置。

如果设置,则使用指定的 CA 证书文件通过 HTTPS 端点验证 cinder 连接。如果端点是 HTTP,则忽略这个值。cinder_api_insecure 必须设为 True 才能启用验证。

可能的值:

  • ca 证书文件的路径

相关选项:

  • cinder_api_insecure

cinder_catalog_info = volumev2::publicURL

字符串值

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

如果没有设置 cinder_endpoint_template,并且任何 cinder_store_auth_address, cinder_store_user_name, cinder_store_project_name, cinder_store_password 没有设置,cinder 存储将使用此信息从当前上下文中的服务目录中查找 Cinder 端点。如果设置,则考虑 cinder_os_region_name 来获取适当的端点。

服务目录可以通过 openstack catalog list 命令列出。

可能的值:

  • 应指定以下格式的字符串: < service_type>:<service_name>:<interface > At least service_typeinterfaceservice_name 可以省略。

相关选项:

  • cinder_os_region_name
  • cinder_endpoint_template
  • cinder_store_auth_address
  • cinder_store_user_name
  • cinder_store_project_name
  • cinder_store_password

cinder_endpoint_template = None

字符串值

使用 cinder 端点的模板覆盖服务目录查找。

设置此选项时,会使用这个值来生成 cinder 端点,而不是从服务目录中查找。如果指定了 cinder_store_auth_addresscinder_store_user_namecinder_store_project_namecinder_store_password,则忽略这个值。

如果设置了此配置选项,则忽略 cinder_catalog_info

可能的值:

  • cinder 端点的 URL 模板字符串,其中 %%(tenant) s 替换为当前的租户(项目)名称。例如: http://cinder.openstack.example.org/v2/%%(tenant)s

相关选项:

  • cinder_store_auth_address
  • cinder_store_user_name
  • cinder_store_project_name
  • cinder_store_password
  • cinder_catalog_info

cinder_enforce_multipath = False

布尔值

如果设为 True,则当 multipathd 未运行时,镜像传输的附加卷将中止。否则,它将回退到单一路径。

可能的值:

  • True 或 False

相关选项:

  • cinder_use_multipath

cinder_http_retries = 3

整数值

失败 http 调用的 cinderclient 重试次数。

当调用被任何错误失败时,cinderclient 将在休眠几秒钟后重试调用最多指定时间。

可能的值:

  • 正整数

相关选项:

  • None

cinder_mount_point_base = /var/lib/glance/mnt

字符串值

NFS 卷在 glance 节点上挂载的目录。

可能的值:

  • 代表挂载点的绝对路径的字符串。

cinder_os_region_name = None

字符串值

从服务目录查找 cinder 服务的区域名称。

这仅在使用 cinder_catalog_info 确定端点时使用。如果设置,此节点的 cinder 端点的查找将过滤到指定的区域。当目录中列出多个区域时,这非常有用。如果没有设置,则从每个区域查找端点。

可能的值:

  • 是有效区域名称的字符串。

相关选项:

  • cinder_catalog_info

cinder_state_transition_timeout = 300

整数值

等待 cinder 卷过渡到 complete 的时间(以秒为单位)。

当 cinder 卷创建、删除或附加到 glance 节点以读/写卷数据时,卷的状态将改变。例如,在创建过程完成后,新创建的卷状态会从 creating 变为 available。这指定了等待状态更改的最长时间。如果在等待时发生超时,或者状态更改为意外值(如 错误),则镜像创建会失败。

可能的值:

  • 正整数

相关选项:

  • None

cinder_store_auth_address = None

字符串值

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

当指定所有 cinder_store_auth_addresscinder_store_user_namecinder_store_project_namecinder_store_password 选项时,指定的值始终用于身份验证。这非常有用,通过将镜像卷存储在特定于镜像服务的项目/租户中来隐藏用户。它还允许用户在 glance 的 ACL 控制下的其他项目之间共享镜像卷。

如果没有设置其中任何一个选项,则使用 cinder 端点从服务目录中查找,并使用当前上下文的用户和项目。

可能的值:

  • 有效的身份验证服务地址,例如: http://openstack.example.org/identity/v2.0

相关选项:

  • cinder_store_user_name
  • cinder_store_password
  • cinder_store_project_name

cinder_store_password = None

字符串值

针对 cinder 进行身份验证的用户的密码。

这必须与以下所有相关选项一起使用。如果没有指定,则使用当前上下文的用户。

可能的值:

  • cinder_store_user_name指定的用户的有效密码

相关选项:

  • cinder_store_auth_address
  • cinder_store_user_name
  • cinder_store_project_name

cinder_store_project_name = None

字符串值

镜像卷存储在 cinder 中的项目名称。

如果没有设置此配置选项,则使用当前上下文中的项目。

这必须与以下所有相关选项一起使用。如果没有指定,则使用当前上下文的项目。

可能的值:

  • 有效的项目名称

相关选项:

  • cinder_store_auth_address
  • cinder_store_user_name
  • cinder_store_password

cinder_store_user_name = None

字符串值

要针对 cinder 进行身份验证的用户名。

这必须与以下所有相关选项一起使用。如果没有指定,则使用当前上下文的用户。

可能的值:

  • 有效的用户名

相关选项:

  • cinder_store_auth_address
  • cinder_store_password
  • cinder_store_project_name

cinder_use_multipath = False

布尔值

用于标识多路径的标记在部署中被支持或不支持。

如果不支持多路径,则将其设置为 False。

可能的值:

  • True 或 False

相关选项:

  • cinder_enforce_multipath

cinder_volume_type = None

字符串值

用于在 cinder 中创建卷的卷类型。

有些 Cinder 后端可以有多个卷类型来优化存储使用。添加此选项可让操作员在 Cinder 中选择可为镜像优化的特定卷类型。

如果没有设置,则将使用 cinder 配置中指定的默认卷类型来创建卷。

可能的值:

  • 来自 cinder 的有效卷类型

相关选项:

  • None

default_store = file

字符串值

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

提供字符串值,代表用于存储镜像的默认方案。如果没有设置,Glance 使用 file 作为默认方案来使用文件存储镜像。

注意

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

可能的值:

  • file
  • filesystem
  • http
  • https
  • swift
  • swift+http
  • swift+https
  • swift+config
  • rbd
  • sheepdog
  • cinder
  • vsphere

相关选项:

  • 存储

弃用自: Rocky

reason: 这个选项针对新的配置选项 ''default_backend'' 弃用,它的行为与 ''default_store' 配置选项类似。

计划在 U 开发周期中移除这个选项。

default_swift_reference = ref1

字符串值

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

提供字符串值,代表对使用 swift 帐户/后端存储进行镜像存储所需的默认参数集的引用。此配置选项的默认引用值为 ref1。此配置选项会解引用参数,并在每次添加新镜像时方便 Swift 存储后端中的镜像存储。

可能的值:

  • 有效字符串值

相关选项:

  • None

filesystem_store_chunk_size = 65536

整数值

块大小,以字节为单位。

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

可能的值:

  • 任何正整数值

相关选项:

  • None

filesystem_store_datadir = /var/lib/glance/images

字符串值

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

启动后,Glance 将创建该目录(如果该目录尚不存在),并验证对其运行 glance-api 的用户的写入访问权限。如果写入访问不可用,则会引发 BadStoreConfiguration 异常,文件系统存储可能无法添加新镜像。

注意

只有在将文件系统存储用作存储后端时才使用此目录。filesystem_store_datadirfilesystem_store_datadirs 选项必须在 glance-api.conf 中指定。如果指定了这两个选项,则会引发 BadStoreConfiguration,文件系统存储可能无法添加新镜像。

可能的值:

  • 到目录的有效路径

相关选项:

  • filesystem_store_datadirs
  • filesystem_store_file_perm

filesystem_store_datadirs = None

多值

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

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

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

注意

只有在将文件系统存储用作存储后端时才使用此目录。filesystem_store_datadirfilesystem_store_datadirs 选项必须在 glance-api.conf 中指定。如果指定了这两个选项,则会引发 BadStoreConfiguration,文件系统存储可能无法添加新镜像。

可能的值:

  • 以下格式的字符串列表:

    • <a valid directory path>:<optional integer priority>

相关选项:

  • filesystem_store_datadir
  • filesystem_store_file_perm

filesystem_store_file_perm = 0

整数值

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

为镜像数据设置所需的文件访问权限。这提供了启用其他服务(如 Nova)的方法,以直接从文件系统存储使用镜像。运行要授予访问权限的服务的用户可能成为拥有创建文件的组的成员。为这个配置选项分配一个小于或等于 0 的值表示没有对默认权限进行任何更改。这个值将被解码为八进制数字。

如需更多信息,请参阅文档 https://docs.openstack.org/glance/latest/configuration/configuring.html

可能的值:

  • 有效文件访问权限
  • 任何负整数

相关选项:

  • None

filesystem_store_metadata_file = None

字符串值

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

到包含与文件系统存储关联的任何位置返回的元数据的路径。该文件必须包含有效的 JSON 对象。该对象应包含键 idmountpoint。这两个键的值应当是字符串。

可能的值:

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

相关选项:

filesystem_thin_provisioning = False

布尔值

在此后端中启用或未进行精简配置。

此配置选项启用在文件系统中不实际写入 null 字节序列的功能,显示的漏洞将自动被文件系统解释为 null 字节,且不实际消耗您的存储。除了在后端保存空间外,启用此功能还将加快镜像上传并保存网络流量,因为不通过网络发送 null 字节序列。

可能的值:

  • True
  • False

相关选项:

  • None

http_proxy_information = {}

字典值

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

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

可能的值:

  • 以逗号分隔的 scheme:proxy 对列表,如上所述

相关选项:

  • None

https_ca_certificates_file = None

字符串值

CA 捆绑包文件的路径。

此配置选项可让操作员使用自定义证书颁发机构文件来验证远程服务器证书。如果设置了这个选项,则忽略 https_insecure 选项,并且指定的 CA 文件将用于验证服务器证书并建立与服务器的安全连接。

可能的值:

  • CA 文件的有效路径

相关选项:

  • https_insecure

https_insecure = True

布尔值

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

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

如果设置了 https_ca_certificates_file,则忽略这个选项。然后,使用 https_ca_certificates_file 选项指定的文件验证远程服务器证书。

可能的值:

  • True
  • False

相关选项:

  • https_ca_certificates_file

rados_connect_timeout = 0

整数值

连接到 Ceph 集群的超时值。

此配置选项在连接到 Ceph 集群时使用的超时值(以秒为单位)内设置在关闭连接前等待 glance-api 的时间。这可防止在连接到 RBD 时出现 glance-api 挂起。如果此选项的值设为小于或等于 0,则不设置超时,并且使用默认的 librados 值。

可能的值:

  • 任何整数值

相关选项:

  • None

`rbd_store_ceph_conf = `

字符串值

Ceph 配置文件路径.

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

注意

如果使用 Cephx 身份验证,这个文件应该在 client.<USER> 部分中包含对正确的密钥环的引用

注意 2:如果将此选项留空(默认),则使用的实际 Ceph 配置文件可能会根据所使用的 librados 版本而改变。如果您准确了解哪个配置文件生效,您可以使用此选项在此处指定该文件。

可能的值:

  • 配置文件的有效路径

相关选项:

  • rbd_store_user

rbd_store_chunk_size = 8

整数值

将 RADOS 镜像分解到其中的大小(以 MB 为单位)。

提供一个整数值,以 MB 为单位代表 Glance 映像的块。默认块大小为 8MB。为获得最佳性能,该值应该是 2 的指数。

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

可能的值:

  • 任何正整数值

相关选项:

  • None

rbd_store_pool = images

字符串值

存储镜像的 RADOS 池。

当 RBD 用作存储 Glance 镜像的存储后端时,镜像通过对对象(镜像区块)的逻辑分组存储到 池中。每个池都通过它可以包含的放置组数量来定义。使用的默认池是 images

有关 RBD 存储后端的更多信息,请访问 :http://ceph.com/planet/how-data-is-stored-in-ceph-cluster/

可能的值:

  • 有效的池名称

相关选项:

  • None

rbd_store_user = None

字符串值

要进行身份验证的 RADOS 用户。

此配置选项在 RADOS 用户中进行身份验证。这只在启用 RADOS 身份验证时才需要,且仅在用户使用 Cephx 身份验证时才适用。如果用户未设置此选项的值,或设置为 None,则会选择默认值,它将基于 rbd_store_ceph_conf 中的 client. 部分。

可能的值:

  • 有效的 RADOS 用户

相关选项:

  • rbd_store_ceph_conf

rbd_thin_provisioning = False

布尔值

在此后端中启用或未进行精简配置。

此配置选项启用 RBD 后端上不实际写入 null 字节序列的功能,可能出现的漏洞由 Ceph 自动解释为 null 字节,且不会真正使用您的存储。除了在后端保存空间外,启用此功能还将加快镜像上传并保存网络流量,因为不通过网络发送 null 字节序列。

可能的值:

  • True
  • False

相关选项:

  • None

rootwrap_config = /etc/glance/rootwrap.conf

字符串值

用于以 root 身份运行命令的 rootwrap 配置文件的路径。

cinder 存储需要 root 特权才能运行镜像卷(用于连接到 iSCSI/FC 卷并读取/写入卷数据等)。该配置文件应允许 cinder store 和 os-brick 库所需的命令。

可能的值:

  • rootwrap 配置文件的路径

相关选项:

  • None

sheepdog_store_address = 127.0.0.1

主机地址值

将 Sheepdog 守护进程绑定到的地址。

提供代表将 Sheepdog 守护进程绑定到的地址的字符串值。为 sheep 设置的默认地址是 127.0.0.1。

Sheepdog 守护进程也称为 sheep,通过跨存储网络写入对象来管理分布式集群中的存储。它标识并处理定向到地址集的消息,使用 sheepdog_store_address 选项存储 Glance 镜像的块。

可能的值:

  • 有效的 IPv4 地址
  • 有效的 IPv6 地址
  • 有效的主机名

相关选项:

  • sheepdog_store_port

弃用自: Train

reason: Sheepdog 项目不再被主动维护。Sheepdog 驱动程序计划在 U 开发周期中移除。

sheepdog_store_chunk_size = 64

整数值

要存储在 Sheepdog 数据存储中的块大小。

提供一个整数值,以兆字节(1048576 字节)表示大小,将 Glance 镜像分为其中。默认块大小为 64MB。

使用 Sheepdog 分布式存储系统时,镜像将区块化到此大小的对象中,然后存储在分布式数据存储中,以用于 Glance。

块大小(如果 2 的指数)有助于避免碎片并启用更高的性能。

可能的值:

  • 以兆字节为单位的正整数值。

相关选项:

弃用自: Train

reason: Sheepdog 项目不再被主动维护。Sheepdog 驱动程序计划在 U 开发周期中移除。

sheepdog_store_port = 7000

端口值

sheep 守护进程将侦听的端口号。

提供一个整数值,代表您希望 Sheepdog 守护进程侦听的有效端口号。默认端口为 7000。

Sheepdog 守护进程也称为 sheep,通过跨存储网络写入对象来管理分布式集群中的存储。它标识并处理在端口号上接收的消息,使用 sheepdog_store_port 选项存储 Glance 镜像的块。

可能的值:

  • 有效端口号(0 到 65535)

相关选项:

  • sheepdog_store_address

弃用自: Train

reason: Sheepdog 项目不再被主动维护。Sheepdog 驱动程序计划在 U 开发周期中移除。

stores = ['file', 'http']

列出值

启用的 Glance 存储列表。

注册存储后端,以逗号分隔列表形式存储磁盘镜像。启用用于存储使用 Glance 的磁盘镜像的默认存储是 filehttp

可能的值:

  • 以逗号分隔的列表,其中包括:

    • file
    • http
    • swift
    • rbd
    • sheepdog
    • cinder
    • vmware

相关选项:

  • default_store

弃用自: Rocky

reason: 这个选项会根据新的配置选项 ''enabled_backends'' 弃用,这有助于配置不同方案的多个后端存储。

计划在 U 开发周期中移除这个选项。

swift_buffer_on_upload = False

布尔值

在上传到 Swift 前缓冲镜像片段。

提供布尔值以指示 Glance 在上传到 swift 时是否应将镜像数据缓冲到磁盘。这可让 Glance 恢复上传到错误。

注意:在启用这个选项时,当启用这个选项时,当这个 API 节点上的磁盘用量增加时,应该非常谨慎。请注意,根据文件系统的配置方式,用于缓冲的磁盘空间可能会减少 glance 镜像缓存的可用磁盘空间。磁盘利用率将根据以下 equation 的上限:(swift_store_large_object_chunk_size * worker * 1000)

可能的值:

  • True
  • False

相关选项:

  • swift_upload_buffer_dir

swift_store_admin_tenants = []

列出值

将被授予 admin 访问权限的租户列表。

这是租户的列表,将被授予由 Glance 在多租户模式下由 Glance 创建的所有 Swift 容器的读/写访问权限。默认值为空列表。

可能的值:

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

相关选项:

  • None

swift_store_auth_address = None

字符串值

Swift 身份验证服务侦听的端口。

swift_store_auth_insecure = False

布尔值

设置服务器证书验证。

此布尔值决定是否验证服务器证书。如果此选项设为 True,则 swiftclient 在验证时不会检查有效的 SSL 证书。如果选项设为 False,则使用默认 CA 信任存储进行验证。

可能的值:

  • True
  • False

相关选项:

  • swift_store_cacert

swift_store_auth_version = 2

字符串值

要使用的身份验证服务版本。对于 keystone 有效版本是 2 和 3,对于 swauth 和 rackspace 为 1(已弃用) 。

swift_store_cacert = None

字符串值

CA 捆绑包文件的路径。

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

可能的值:

  • CA 文件的有效路径

相关选项:

  • swift_store_auth_insecure

swift_store_config_file = None

字符串值

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

包括一个字符串值,代表配置的每个 Swift 帐户/后向存储具有引用的配置的路径。默认情况下,未指定文件路径并禁用自定义 Swift 引用。强烈建议在将镜像存储中使用 Swift 存储后端来配置此选项,因为它可避免在数据库中存储凭证。

注意

如果将 swift_store_multi_tenant 设置为 True,请不要配置这个选项。

可能的值:

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

相关选项:

  • swift_store_multi_tenant

swift_store_container = glance

字符串值

为多个容器存储 images/name 前缀的单个容器名称

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

使用多个容器时,容器将按照为此配置选项设置的值加上镜像 UUID 的前 N 个字符,作为由下划线分隔的后缀(其中 N 由 swift_store_multiple_containers_seed指定)。

示例:如果 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_create_container_on_put = False

布尔值

在上传镜像时,创建容器(如果不存在)。

在上传镜像时,如果相应的容器不存在,则会创建它,如果此配置选项被设置为 True。默认情况下,不会创建它。这个行为适用于单和多个容器模式。

可能的值:

  • True
  • False

相关选项:

  • None

swift_store_endpoint = None

字符串值

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

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

注意

URL 应包括最多的路径,但不包括容器。通过将容器和对象附加到配置的 URL 来获取对象的位置。

可能的值:

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

相关选项:

  • None

swift_store_endpoint_type = publicURL

字符串值

Swift 服务的端点类型。

此字符串值指示用于获取 Swift 端点的端点类型。端点类型决定了用户被允许执行的操作,例如,读取和写入存储。只有在 swift_store_auth_version 大于 1 时才会使用此设置。

可能的值:

  • publicURL
  • adminURL
  • internalURL

相关选项:

  • swift_store_endpoint

swift_store_expire_soon_interval = 60

整数值

定义在当前令牌到期之前请求新令牌的窗口大小(以秒为单位)。

通常,Swift 存储驱动程序在当前令牌过期时获取新令牌,以确保持续访问 Swift。但是,如果令牌实时过期,一些 Swift 事务(如上传镜像片段)可能无法正常恢复。

因此,通过在当前令牌到期前获取新令牌,我们在尝试事务前确保令牌不会过期或接近过期。默认情况下,Swift 存储驱动程序在当前令牌过期前请求新的令牌 60 秒或更短。

可能的值:

  • 正整数值

相关选项:

  • None

swift_store_key = None

字符串值

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

swift_store_large_object_chunk_size = 200

整数值

镜像数据片段时段的最大大小(以 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_large_object_size = 5120

整数值

Glance 将启动分段数据的大小(以 MB 为单位)。

Swift 对单个上传对象的大小具有上限。默认情况下,这是 5GB。要上传大于这个限制的对象,对象被分段为与清单文件关联的多个较小的对象。如需更多详情,请参阅 https://docs.openstack.org/swift/latest/overview_large_objects.html

此配置选项指定 Swift 驱动程序将镜像数据分段到多个较小的文件的大小阈值。目前,Swift 驱动程序只支持创建动态大对象。

注意

这应该通过考虑 Swift 集群实施的大对象限制来设置。

可能的值:

  • 一个小于或等于 Swift 集群实施的大型对象限制的正整数。

相关选项:

  • swift_store_large_object_chunk_size

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

整数值

seed 表示用于存储镜像的容器数量。

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

有关命名约定的详情,请参阅 swift_store_container。有关使用多个容器的更多详细信息,请参阅 https://specs.openstack.org/openstack/glance-specs/specs/kilo/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_region = None

字符串值

Glance 使用的 Swift 端点的区域。

提供字符串值,代表 Glance 可以为镜像存储连接的 Swift 区域。默认情况下,没有设置区域。

当 Glance 使用 Swift 作为存储后端来为具有多个端点的特定租户存储镜像时,使用 swift_store_region 设置 Swift 区域可让 Glance 在指定区域中连接 Swift,而不是单个区域连接。

此选项可以针对单租户和多租户存储进行配置。

注意

使用 swift_store_region 设置区域是特定于租户的,只有在 租户在不同区域间有多个端点时才需要。

可能的值:

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

相关选项:

  • None

swift_store_retry_get_count = 0

整数值

在请求失败前重试 Swift 下载的次数。

提供一个整数值,代表在出错前必须重试镜像下载的次数。默认值为 0 (在失败的镜像下载时不重试)。当设置为正整数值时,swift_store_retry_get_count 可确保在发送错误消息前在下载失败时多次尝试下载。

可能的值:

  • 正整数值

相关选项:

  • None

swift_store_service_type = object-store

字符串值

要使用的 Swift 服务类型。

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

注意

如果 swift_store_auth_version 设为 2,则此配置选项的值需要是 object-store。如果使用较高版本的 Keystone 或不同的身份验证方案,则可以修改此选项。

可能的值:

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

相关选项:

  • None

swift_store_ssl_compression = True

布尔值

HTTPS Swift 请求的 SSL 层压缩。

提供布尔值,以确定是否对 SSL 层的镜像压缩 HTTPS Swift 请求。默认情况下启用压缩。

在将 Swift 用作 Glance 镜像存储的后端存储时,可以使用此选项设置 HTTPS Swift 请求的 SSL 层压缩。如果设置为 False,则禁用 HTTPS Swift 请求的 SSL 层压缩。禁用此选项可能会提高已压缩格式(如 qcow2)的镜像的性能。

可能的值:

  • True
  • False

相关选项:

  • None

swift_store_use_trusts = True

布尔值

将信任用于多租户 Swift 存储。

此选项指示 Swift 存储在使用多租户存储时为每个 add/get 请求创建信任。使用信任可让 Swift 存储避免在上传或下载数据期间由身份验证令牌过期导致的问题。

默认情况下,swift_store_use_trusts 设置为 True(启用信任时使用)。如果设置为 False,则使用用户令牌用于 Swift 连接,从而消除信任创建开销。

注意

只有在 swift_store_multi_tenant 设为 True时,才会考虑此选项

可能的值:

  • True
  • False

相关选项:

  • swift_store_multi_tenant

swift_store_user = None

字符串值

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

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_api_retry_count = 10

整数值

VMware API 重试次数。

此配置选项指定在连接相关问题或服务器 API 调用超载时必须重试 VMware ESX/VC 服务器 API 的次数。无法指定 retry forever

可能的值:

  • 任何正整数值

相关选项:

  • None

vmware_ca_file = None

字符串值

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

此配置选项可让操作员使用自定义 Cerificate Authority File 来验证 ESX/vCenter 证书。

如果设置了这个选项,则会忽略"vmware_insecure"选项,并且指定的 CA 文件将用于验证 ESX/vCenter 服务器证书,并建立与服务器的安全连接。

可能的值:

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

相关选项:

  • vmware_insecure

vmware_datastores = None

多值

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

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

添加镜像时,将选择具有最高权重的数据存储,除非在已知镜像大小时没有足够的可用空间。如果未指定权重,则假定为 0,目录将被视为最后选择。如果多个数据存储具有相同的权重,则会选择具有最多可用空间的权重。

可能的值:

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

相关选项:* None

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

vmware_server_host = None

主机地址值

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_password = None

字符串值

服务器密码.

此配置选项使用密码来使用 VMware ESX/ESXi 或 vCenter Server 进行身份验证。使用 VMware 存储后端时需要这个选项。

可能的值:

  • 任何字符串,这是与使用 "vmware_server_username" 选项指定的用户名对应的密码

相关选项:

  • vmware_server_host
  • vmware_server_username

vmware_server_username = None

字符串值

服务器用户名.

此配置选项使用用于使用 VMware ESX/ESXi 或 vCenter Server 进行身份验证的用户名。使用 VMware 存储后端时需要这个选项。

可能的值:

  • 任何字符串,这是具有适当权限的用户的用户名

相关选项:

  • vmware_server_host
  • vmware_server_password

vmware_store_image_dir = /openstack_glance

字符串值

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

此配置选项指定 glance 镜像将存储在 VMware 数据存储中的目录的路径。如果没有设置这个选项,则存储 glance 镜像的默认目录为 openstack_glance。

可能的值:

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

相关选项:

  • None

vmware_task_poll_interval = 5

整数值

在 VMware ESX/VC 服务器上轮询远程任务的时间间隔(以秒为单位)。

此配置选项使用休眠时间(以秒为单位)轮询 async 任务,作为 VMWare ESX/VC 服务器 API 调用的一部分。

可能的值:

  • 任何正整数值

相关选项:

  • None

3.2.4. oslo_concurrency

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

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

disable_process_locking = False

布尔值

启用或禁用进程间的锁定。

lock_path = None

字符串值

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

3.2.5. oslo_policy

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

Expand
表 3.28. oslo_policy
配置选项 = 默认值类型Description

enforce_scope = False

布尔值

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

policy_default_rule = default

字符串值

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

policy_dirs = ['policy.d']

多值

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

policy_file = policy.json

字符串值

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

remote_content_type = application/x-www-form-urlencoded

字符串值

用于发送和接收基于 REST 策略检查的数据的内容类型

remote_ssl_ca_crt_file = None

字符串值

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

remote_ssl_client_crt_file = None

字符串值

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

remote_ssl_client_key_file = None

字符串值

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

remote_ssl_verify_server_crt = False

布尔值

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

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat