zaqar.conf

默认值

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

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

admin_mode
类型:

布尔值

默认值:

False

激活特权端点。

pooling
类型:

布尔值

默认值:

False

启用跨多个存储后端池化。如果启用池化,则使用存储驱动程序配置来确定目录/控制平面数据存储的位置。

已弃用的变体

Group

名称

DEFAULT

分片

unreliable
类型:

布尔值

默认值:

False

禁用所有可靠性约束。

enable_deprecated_api_versions
类型:

列表

默认值:

[]

要启用的已弃用 API 版本的列表。

enable_checksum
类型:

布尔值

默认值:

False

启用消息体的校验和。默认值为 False。

auth_strategy
类型:

字符串

默认值:

''

用于身份验证的后端。如果不需要身份验证,请保持为空。现有策略:keystone。请参阅下面的 keystone_authtoken 部分。

executor_thread_pool_size
类型:

整数

默认值:

64

当 executor 是 threading 或 eventlet 时,executor 线程池的大小。

已弃用的变体

Group

名称

DEFAULT

rpc_thread_pool_size

rpc_response_timeout
类型:

整数

默认值:

60

等待调用响应的秒数。

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/2025.2/reference/transport.html

control_exchange
类型:

字符串

默认值:

openstack

主题的作用域所在的默认交换机。可以通过 transport_url 选项中指定的交换机名称覆盖。

rpc_ping_enabled
类型:

布尔值

默认值:

False

添加一个端点来响应 ping 调用。端点命名为 oslo_rpc_server_ping

cache

config_prefix
类型:

字符串

默认值:

cache.oslo

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

expiration_time
类型:

整数

默认值:

600

最小值:

1

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

backend_expiration_time
类型:

整数

默认值:

<None>

最小值:

1

在缓存后端中自动清除过期记录的过期时间。此值应大于 expiration_time 和所有 cache_time 选项

backend
类型:

字符串

默认值:

dogpile.cache.null

有效值:

oslo_cache.memcache_pool, oslo_cache.dict, oslo_cache.mongo, oslo_cache.etcd3gw, dogpile.cache.pymemcache, dogpile.cache.memcached, dogpile.cache.pylibmc, dogpile.cache.bmemcached, dogpile.cache.dbm, dogpile.cache.redis, dogpile.cache.redis_sentinel, dogpile.cache.memory, dogpile.cache.memory_pickle, dogpile.cache.null

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

backend_argument
类型:

多值

默认值:

''

传递给后端模块的参数。对于要传递给 dogpile.cache 后端的每个参数,指定此选项一次。示例格式:“<argname>:<value>”。

proxies
类型:

列表

默认值:

[]

要导入的代理类,它们会影响 dogpile.cache 后端的运作方式。请参阅 dogpile.cache 文档中关于 changing-backend-behavior 的内容。

enabled
类型:

布尔值

默认值:

False

全局缓存开关。

debug_cache_backend
类型:

布尔值

默认值:

False

来自缓存后端的额外调试信息(缓存键、get/set/delete/等调用)。只有在需要查看带有键/值的特定缓存后端 get/set/delete 调用时,此选项才真正有用。通常应将其设置为 false。

memcache_servers
类型:

列表

默认值:

['localhost:11211']

Memcache 服务器的格式为“host:port”。这由依赖于 Memcached 的后端使用。如果使用 dogpile.cache.memcachedoslo_cache.memcache_pool,并且给定的主机引用 IPv6 或给定的域名引用 IPv6,则应使用地址族 (inet6) (例如 inet6:[::1]:11211inet6:[fd12:3456:789a:1::1]:11211inet6:[controller-0.internalapi]:11211) 对给定的地址进行前缀。如果未提供地址族,则这些后端将使用默认 inet 地址族,它对应于 IPv4。

memcache_dead_retry
类型:

整数

默认值:

300

在再次尝试之前,Memcached 服务器被认为已死的时间(秒)。(仅适用于 dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。

memcache_socket_timeout
类型:

浮点数

默认值:

1.0

每次调用服务器的超时时间(秒)。(仅适用于 dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。

memcache_pool_maxsize
类型:

整数

默认值:

10

每个 Memcached 服务器的最大开放连接数。(仅适用于 oslo_cache.memcache_pool 后端)。

memcache_pool_unused_timeout
类型:

整数

默认值:

60

连接在池中未被使用之前保持打开状态的秒数。(仅适用于 oslo_cache.memcache_pool 后端)。

memcache_pool_connection_get_timeout
类型:

整数

默认值:

10

获取 Memcache 客户端连接的操作等待的秒数。

memcache_pool_flush_on_reconnect
类型:

布尔值

默认值:

False

全局切换,确定是否在重新连接时刷新 Memcache。(仅适用于 oslo_cache.memcache_pool 后端)。

memcache_sasl_enabled
类型:

布尔值

默认值:

False

如果 SASL_enable 为 true,则启用 SASL(简单身份验证和安全层),否则禁用。

memcache_username
类型:

字符串

默认值:

<None>

启用 SASL 的 Memcached 的用户名

memcache_password
类型:

字符串

默认值:

<None>

启用 SASL 的 Memcached 的密码

redis_server
类型:

字符串

默认值:

localhost:6379

Redis 服务器的格式为“host:port”

redis_db
类型:

整数

默认值:

0

最小值:

0

Redis 服务器中的数据库 ID

redis_username
类型:

字符串

默认值:

<None>

redis 的用户名

redis_password
类型:

字符串

默认值:

<None>

redis 的密码

redis_sentinels
类型:

列表

默认值:

['localhost:26379']

Redis sentinel 服务器的格式为“host:port”

redis_socket_timeout
类型:

浮点数

默认值:

1.0

每次调用服务器的超时时间(秒)。(仅适用于 dogpile.cache.redis 和 dogpile.cache.redis_sentinel 后端)。

redis_sentinel_service_name
类型:

字符串

默认值:

mymaster

Redis sentinel 集群的服务名称。

tls_enabled
类型:

布尔值

默认值:

False

与缓存服务器通信时使用 TLS 的全局切换。目前受 dogpile.cache.bmemcachedogpile.cache.pymemcacheoslo_cache.memcache_pooldogpile.cache.redisdogpile.cache.redis_sentinel 支持。

tls_cafile
类型:

字符串

默认值:

<None>

建立缓存服务器身份验证所需的 PEM 格式的串联 CA 证书的文件路径。如果 tls_enabled 为 False,则忽略此选项。

tls_certfile
类型:

字符串

默认值:

<None>

包含客户端证书以及建立证书身份验证所需的任何数量的 CA 证书的单个 PEM 格式的文件。只有在需要客户端身份验证时才需要此文件。如果 tls_enabled 为 False,则忽略此选项。

tls_keyfile
类型:

字符串

默认值:

<None>

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

tls_allowed_ciphers
类型:

字符串

默认值:

<None>

设置使用 TLS 上下文创建的套接字的可用密码。它应该是 OpenSSL 密码列表格式的字符串。如果未指定,将提供所有 OpenSSL 启用的密码。目前受 dogpile.cache.bmemcachedogpile.cache.pymemcacheoslo_cache.memcache_pool 支持。

enable_socket_keepalive
类型:

布尔值

默认值:

False

dogpile 的 pymemcache 后端的套接字保活的全局切换

socket_keepalive_idle
类型:

整数

默认值:

1

最小值:

0

连接在开始发送保活探测之前需要保持空闲的时间(秒)。应该是一个大于零的正整数。

socket_keepalive_interval
类型:

整数

默认值:

1

最小值:

0

各个保活探测之间的时间(秒)。应该是一个大于零的正整数。

socket_keepalive_count
类型:

整数

默认值:

1

最小值:

0

TCP 在放弃连接之前应该发送的最大保活探测次数。应该是一个大于零的正整数。

enable_retry_client
类型:

布尔值

默认值:

False

启用重试客户端机制以处理故障。这些机制可用于包装所有类型的 pymemcache 客户端。该包装器允许您定义重试次数以及尝试之间的等待时间。

retry_attempts
类型:

整数

默认值:

2

最小值:

1

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

retry_delay
类型:

浮点数

默认值:

0

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

hashclient_retry_attempts
类型:

整数

默认值:

2

最小值:

1

在 HashClient 的内部机制中,客户端应该尝试的次数,然后将其标记为已死并从池中删除。

hashclient_retry_delay
类型:

浮点数

默认值:

1

HashClient 的内部机制中,重试尝试之间应该经过的秒数。

dead_timeout
类型:

浮点数

默认值:

60

在 HashClient 的内部机制中,在尝试将节点放回池中之前应该经过的时间(秒)。

enforce_fips_mode
类型:

布尔值

默认值:

False

全局切换,用于强制 OpenSSL FIPS 模式。此功能需要 Python 支持。在所有环境中的 Python 3.9 中可用,并且可能已回溯到较旧的 Python 版本。如果使用的 Python 可执行文件不支持 OpenSSL FIPS 模式,将引发异常。目前受 dogpile.cache.bmemcachedogpile.cache.pymemcacheoslo_cache.memcache_pool 支持。

cors

allowed_origin
类型:

列表

默认值:

<None>

指示是否允许与请求“origin”标头中接收到的域共享此资源。格式:“<protocol>://<host>[:<port>]”,不带尾部斜杠。示例:https://horizon.example.com

allow_credentials
类型:

布尔值

默认值:

True

指示实际请求是否可以包含用户凭据

expose_headers
类型:

列表

默认值:

[]

指示哪些标头可以安全地暴露给 API。默认值为 HTTP 简单标头。

max_age
类型:

整数

默认值:

3600

CORS 预检请求的最大缓存时间。

allow_methods
类型:

列表

默认值:

['OPTIONS', 'GET', 'HEAD', 'POST', 'PUT', 'DELETE', 'TRACE', 'PATCH']

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

allow_headers
类型:

列表

默认值:

[]

指示实际请求期间可以使用哪些标头字段名称。

驱动程序

transport
类型:

字符串

默认值:

wsgi

要使用的传输驱动程序。

message_store
类型:

字符串

默认值:

mongodb

用作消息存储的存储驱动程序。

已弃用的变体

Group

名称

驱动程序

storage

management_store
类型:

字符串

默认值:

mongodb

用作管理存储的存储驱动程序。

drivers:management_store:mongodb

ssl_keyfile
类型:

字符串

默认值:

<None>

用于标识与 mongod 连接的私钥文件。如果包含在 certifle 中,则只需要 ssl_certfile

ssl_certfile
类型:

字符串

默认值:

<None>

用于标识与 mongod 连接的证书文件。

ssl_cert_reqs
类型:

字符串

默认值:

CERT_REQUIRED

有效值:

CERT_NONE、CERT_OPTIONAL、CERT_REQUIRED

指定是否需要来自连接另一端的证书,如果提供证书,是否对其进行验证。如果此参数的值不是 CERT_NONE,则 ssl_ca_certs 参数必须指向一个包含 CA 证书的文件。

可能的值

CERT_NONE

忽略证书

CERT_OPTIONAL

不需要证书,但如果提供则进行验证

CERT_REQUIRED

需要并验证证书

ssl_ca_certs
类型:

字符串

默认值:

<None>

ca_certs 文件包含一组串联的“证书颁发机构”证书,用于验证从连接另一端传递的证书。

uri
类型:

字符串

默认值:

<None>

Mongodb 连接 URI。如果启用了 ssl 连接,则需要相应地设置 ssl_keyfilessl_certfilessl_cert_reqsssl_ca_certs

database
类型:

字符串

默认值:

zaqar

数据库名称。

max_attempts
类型:

整数

默认值:

1000

最小值:

0

重试失败操作的最大次数。当前仅用于重试消息发布。

max_retry_sleep
类型:

浮点数

默认值:

0.1

重试之间最大睡眠间隔(实际睡眠时间根据执行的尝试次数线性增加)。

max_retry_jitter
类型:

浮点数

默认值:

0.005

最大抖动间隔,添加到睡眠间隔中,以减少并行请求同时重试的概率。

max_reconnect_attempts
类型:

整数

默认值:

10

由于主节点故障转移而导致操作失败时重试的最大次数。

reconnect_sleep
类型:

浮点数

默认值:

0.02

在主节点故障转移后重连尝试之间的基本睡眠间隔。实际睡眠时间每次重试都会呈指数级增加(2 的幂)。

drivers:management_store:redis

uri
类型:

字符串

默认值:

redis://127.0.0.1:6379

Redis 连接 URI,采用以下三种形式之一。要直接连接到 Redis 服务器,请使用“redis://[:password]@host[:port][?options]”的形式,其中 password 是 redis-server 的密码,当 redis-server 设置密码时,需要设置 password 选项。如果未指定 port,则默认为 6379。要使用 Redis Sentinel 使用 HA 主从 Redis 集群,请使用“redis://[:password]@host1[:port1][,host2[:port2],…,hostN[:portN]][?options]”的形式,其中每个指定的 host 对应于 redis-sentinel 的一个实例。在这种形式中,在 Sentinel 配置中使用的 Redis 主机名必须包含在查询字符串中,即“master=<name>”。最后,要通过 unix 套接字连接到本地 Redis 实例,可以使用“redis://[:password]@/path/to/redis.sock[?options]”的形式。在所有形式中,可以在查询字符串中指定“socket_timeout”选项。其值以秒为单位。如果未提供,则“socket_timeout”默认为 0.1 秒。Redis 数据库中有多个数据库实例,例如在 /etc/redis/redis.conf 中,如果参数是“database 16”,则有 16 个数据库实例。默认情况下,数据存储在 db = 0 数据库中,如果要使用 db = 1 数据库,可以使用以下形式:“redis://host[:port][?dbid=1]”。

max_reconnect_attempts
类型:

整数

默认值:

10

由于 redis 节点故障转移而导致操作失败时重试的最大次数。

reconnect_sleep
类型:

浮点数

默认值:

1.0

在 redis 节点故障转移后重连尝试之间的基本睡眠间隔。

drivers:management_store:sqlalchemy

uri
类型:

字符串

默认值:

sqlite:///:memory

一个 sqlalchemy URL

drivers:message_store:mongodb

ssl_keyfile
类型:

字符串

默认值:

<None>

用于标识与 mongod 连接的私钥文件。如果包含在 certifle 中,则只需要 ssl_certfile

ssl_certfile
类型:

字符串

默认值:

<None>

用于标识与 mongod 连接的证书文件。

ssl_cert_reqs
类型:

字符串

默认值:

CERT_REQUIRED

有效值:

CERT_NONE、CERT_OPTIONAL、CERT_REQUIRED

指定是否需要来自连接另一端的证书,如果提供证书,是否对其进行验证。如果此参数的值不是 CERT_NONE,则 ssl_ca_certs 参数必须指向一个包含 CA 证书的文件。

可能的值

CERT_NONE

忽略证书

CERT_OPTIONAL

不需要证书,但如果提供则进行验证

CERT_REQUIRED

需要并验证证书

ssl_ca_certs
类型:

字符串

默认值:

<None>

ca_certs 文件包含一组串联的“证书颁发机构”证书,用于验证从连接另一端传递的证书。

uri
类型:

字符串

默认值:

<None>

Mongodb 连接 URI。如果启用了 ssl 连接,则需要相应地设置 ssl_keyfilessl_certfilessl_cert_reqsssl_ca_certs

database
类型:

字符串

默认值:

zaqar

数据库名称。

max_attempts
类型:

整数

默认值:

1000

最小值:

0

重试失败操作的最大次数。当前仅用于重试消息发布。

max_retry_sleep
类型:

浮点数

默认值:

0.1

重试之间最大睡眠间隔(实际睡眠时间根据执行的尝试次数线性增加)。

max_retry_jitter
类型:

浮点数

默认值:

0.005

最大抖动间隔,添加到睡眠间隔中,以减少并行请求同时重试的概率。

max_reconnect_attempts
类型:

整数

默认值:

10

由于主节点故障转移而导致操作失败时重试的最大次数。

reconnect_sleep
类型:

浮点数

默认值:

0.02

在主节点故障转移后重连尝试之间的基本睡眠间隔。实际睡眠时间每次重试都会呈指数级增加(2 的幂)。

partitions
类型:

整数

默认值:

2

消息数据分区在多个数据库中的数量,以减少写入程序锁定的百分比。请勿在初始部署后更改此设置。它必须保持静态。此外,即使在 SSD 存储上部署 MongoDB,也不需要大量的分区来提高性能。

drivers:message_store:redis

uri
类型:

字符串

默认值:

redis://127.0.0.1:6379

Redis 连接 URI,采用以下三种形式之一。要直接连接到 Redis 服务器,请使用“redis://[:password]@host[:port][?options]”的形式,其中 password 是 redis-server 的密码,当 redis-server 设置密码时,需要设置 password 选项。如果未指定 port,则默认为 6379。要使用 Redis Sentinel 使用 HA 主从 Redis 集群,请使用“redis://[:password]@host1[:port1][,host2[:port2],…,hostN[:portN]][?options]”的形式,其中每个指定的 host 对应于 redis-sentinel 的一个实例。在这种形式中,在 Sentinel 配置中使用的 Redis 主机名必须包含在查询字符串中,即“master=<name>”。最后,要通过 unix 套接字连接到本地 Redis 实例,可以使用“redis://[:password]@/path/to/redis.sock[?options]”的形式。在所有形式中,可以在查询字符串中指定“socket_timeout”选项。其值以秒为单位。如果未提供,则“socket_timeout”默认为 0.1 秒。Redis 数据库中有多个数据库实例,例如在 /etc/redis/redis.conf 中,如果参数是“database 16”,则有 16 个数据库实例。默认情况下,数据存储在 db = 0 数据库中,如果要使用 db = 1 数据库,可以使用以下形式:“redis://host[:port][?dbid=1]”。

max_reconnect_attempts
类型:

整数

默认值:

10

由于 redis 节点故障转移而导致操作失败时重试的最大次数。

reconnect_sleep
类型:

浮点数

默认值:

1.0

在 redis 节点故障转移后重连尝试之间的基本睡眠间隔。

drivers:message_store:swift

auth_url
类型:

字符串

默认值:

http://127.0.0.1:5000/v3/

发现 Swift 的 Keystone 端点的 URI

uri
类型:

字符串

默认值:

swift://demo:nomoresecrete@/demo

描述 swift 连接的自定义 URI。

insecure
类型:

布尔值

默认值:

False

不检查 SSL 证书

project_domain_id
类型:

字符串

默认值:

<None>

包含项目的域 ID

project_domain_name
类型:

字符串

默认值:

默认值

包含项目的域名称

user_domain_id
类型:

字符串

默认值:

<None>

用户域 ID

user_domain_name
类型:

字符串

默认值:

默认值

用户的域名称

region_name
类型:

字符串

默认值:

<None>

区域名称

interface
类型:

字符串

默认值:

publicURL

用于端点 URL 发现的默认接口。

drivers:transport:websocket

bind
类型:

主机地址

默认值:

127.0.0.1

自托管服务器将侦听的地址。

port
类型:

端口号

默认值:

9000

最小值:

0

最大值:

65535

自托管服务器将侦听的端口。

external_port
类型:

端口号

默认值:

<None>

最小值:

0

最大值:

65535

向用户提供服务的端口。

notification_bind
类型:

主机地址

默认值:

<None>

通知服务器将侦听的地址。

notification_port
类型:

端口号

默认值:

0

最小值:

0

最大值:

65535

通知服务器将侦听的端口。

drivers:transport:wsgi

bind
类型:

主机地址

默认值:

127.0.0.1

自托管服务器将侦听的地址。

port
类型:

端口号

默认值:

8888

最小值:

0

最大值:

65535

自托管服务器将侦听的端口。

keystone_authtoken

www_authenticate_uri
类型:

字符串

默认值:

<None>

完整的“公共”身份 API 端点。此端点不应是“admin”端点,因为它应可供所有最终用户访问。未经身份验证的客户端将被重定向到此端点以进行身份验证。虽然此端点理想情况下应该是未版本化的,但实际客户端支持各不相同。如果您在此处使用版本化的 v2 端点,则不应与服务用户用于验证令牌的端点相同,因为普通最终用户可能无法访问该端点。

已弃用的变体

Group

名称

keystone_authtoken

auth_uri

auth_uri
类型:

字符串

默认值:

<None>

完整的“公共”身份 API 端点。此端点不应是“admin”端点,因为它应可供所有最终用户访问。未经身份验证的客户端将被重定向到此端点以进行身份验证。虽然此端点理想情况下应该是未版本化的,但实际客户端支持各不相同。如果您在此处使用版本化的 v2 端点,则不应与服务用户用于验证令牌的端点相同,因为普通最终用户可能无法访问该端点。此选项已被弃用,以支持 www_authenticate_uri,并且将在 S 版本中删除。

警告

此选项已弃用以供删除,自 Queens 以来。其值将来可能会被默默地忽略。

原因:

auth_uri 选项已被弃用,以支持 www_authenticate_uri,并且将在 S 版本中删除。

auth_version
类型:

字符串

默认值:

<None>

身份 API 端点的 API 版本。

interface
类型:

字符串

默认值:

internal

用于身份 API 端点的接口。有效值为“public”、“internal”(默认)或“admin”。

delay_auth_decision
类型:

布尔值

默认值:

False

不在中间件中处理授权请求,而是将授权决策委托给下游 WSGI 组件。

http_connect_timeout
类型:

整数

默认值:

<None>

与 Identity API 服务器通信的请求超时值。

http_request_max_retries
类型:

整数

默认值:

3

与 Identity API 服务器通信时,我们尝试重新连接多少次。

cache
类型:

字符串

默认值:

<None>

请求环境键,其中存储了 Swift 缓存对象。当 auth_token 中间件与 Swift 缓存一起部署时,使用此选项与 swift 共享缓存后端。否则,请改用 memcached_servers 选项。

certfile
类型:

字符串

默认值:

<None>

如果身份服务器需要客户端证书,则需要

keyfile
类型:

字符串

默认值:

<None>

如果身份服务器需要客户端证书,则需要

cafile
类型:

字符串

默认值:

<None>

在验证 HTTPS 连接时使用的 PEM 编码的证书颁发机构。默认值为系统 CA。

insecure
类型:

布尔值

默认值:

False

验证 HTTPS 连接。

region_name
类型:

字符串

默认值:

<None>

可以找到身份服务器的区域。

memcached_servers
类型:

列表

默认值:

<None>

可选地指定要用于缓存的 memcached 服务器列表。如果未定义,则令牌将改为在进程内缓存。

已弃用的变体

Group

名称

keystone_authtoken

memcache_servers

token_cache_time
类型:

整数

默认值:

300

为了防止花费过多的精力来验证令牌,中间件将先前看到的令牌缓存配置的时间(以秒为单位)。设置为 -1 以完全禁用缓存。

memcache_security_strategy
类型:

字符串

默认值:

有效值:

None, MAC, ENCRYPT

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

memcache_secret_key
类型:

字符串

默认值:

<None>

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

memcache_tls_enabled
类型:

布尔值

默认值:

False

(可选) 与缓存服务器通信时 TLS 使用的全局切换。

memcache_tls_cafile
类型:

字符串

默认值:

<None>

(可选) 建立缓存服务器身份所需的 PEM 格式的串联 CA 证书的文件路径。如果 tls_enabled 为 False,则忽略此选项。

memcache_tls_certfile
类型:

字符串

默认值:

<None>

(可选) 包含客户端证书以及建立证书身份所需的任何数量的 CA 证书的单个 PEM 格式的文件路径。仅当需要客户端身份验证时才需要此文件。如果 tls_enabled 为 False,则忽略此选项。

memcache_tls_keyfile
类型:

字符串

默认值:

<None>

(可选) 包含客户端私钥的单个文件。否则,私钥将从 tls_certfile 中指定的 文件中获取。如果 tls_enabled 为 False,则忽略此选项。

memcache_tls_allowed_ciphers
类型:

字符串

默认值:

<None>

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

memcache_pool_dead_retry
类型:

整数

默认值:

300

(可选) memcached 服务器被认为已死并在重试之前的时间(以秒为单位)。

memcache_pool_maxsize
类型:

整数

默认值:

10

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

memcache_pool_socket_timeout
类型:

整数

默认值:

3

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

memcache_pool_unused_timeout
类型:

整数

默认值:

60

(可选) 连接在池中未使用的时间(以秒为单位),然后将其关闭。

memcache_pool_conn_get_timeout
类型:

整数

默认值:

10

(可选) 操作等待从池中获取 memcached 客户端连接的时间(以秒为单位)。

memcache_use_advanced_pool
类型:

布尔值

默认值:

True

(可选) 使用高级(eventlet 安全)memcached 客户端池。

include_service_catalog
类型:

布尔值

默认值:

True

(可选) 指示是否设置 X-Service-Catalog 标头。如果为 False,中间件不会要求在令牌验证时获取服务目录,也不会设置 X-Service-Catalog 标头。

enforce_token_bind
类型:

字符串

默认值:

permissive

用于控制令牌绑定使用和类型。可以设置为:“disabled”以不检查令牌绑定。“permissive”(默认)如果绑定类型是服务器已知的一种形式,则验证绑定信息,如果不是则忽略它。“strict”类似于“permissive”,但如果绑定类型未知,则拒绝该令牌。“required”需要任何形式的令牌绑定才能被允许。最后,是必须出现在令牌中的绑定方法的名称。

service_token_roles
类型:

列表

默认值:

['service']

服务令牌中必须存在的一组角色选择。服务令牌允许请求可以使用过期的令牌,因此此检查应严格控制只有实际的服务才能发送此令牌。此处的角色作为 ANY 检查应用,因此列表中任何角色都必须存在。出于向后兼容的原因,这目前仅影响 allow_expired 检查。

service_token_roles_required
类型:

布尔值

默认值:

False

出于向后兼容的原因,我们必须允许通过 service_token_roles 检查但未通过有效服务令牌。将此设置为 true 将在未来的版本中成为默认设置,如果可能,应启用它。

service_type
类型:

字符串

默认值:

<None>

服务目录中出现的服务的名称或类型。这用于验证具有受限访问规则的令牌。

memcache_sasl_enabled
类型:

布尔值

默认值:

False

如果 SASL_enable 为 true,则启用 SASL(简单身份验证和安全层),否则禁用。

memcache_username
类型:

字符串

默认值:

''

SASL 的用户名

memcache_password
类型:

字符串

默认值:

''

SASL 的用户名密码

auth_type
类型:

未知类型

默认值:

<None>

要加载的身份验证类型

已弃用的变体

Group

名称

keystone_authtoken

auth_plugin

auth_section
类型:

未知类型

默认值:

<None>

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

通知

smtp_mode
类型:

字符串

默认值:

third_part

有效值:

third_part、self_local

可以选择两个值:third_part 或 self_local。third_part 表示 Zaqar 将使用 config 选项 smtp_commnd 中的工具。self_local 表示将使用 smtp python 库。

smtp_host
类型:

主机地址

默认值:

<None>

电子邮件系统的 host IP。当 smtp_mode 设置为 self_local 时,应设置它。

smtp_port
类型:

端口号

默认值:

<None>

最小值:

0

最大值:

65535

电子邮件系统的端口。当 smtp_mode 设置为 self_local 时,应设置它。

smtp_user_name
类型:

字符串

默认值:

<None>

登录电子邮件系统所需的用户名。当 smtp_mode 设置为 self_local 时,应设置它。

smtp_user_password
类型:

字符串

默认值:

<None>

用于登录电子邮件系统的用户密码。当 smtp_mode 设置为 self_local 时,应设置此项。

smtp_command
类型:

字符串

默认值:

/usr/sbin/sendmail -t -oi

发送电子邮件的 smtp 命令。格式为“command_name arg1 arg2”。

max_notifier_workers
类型:

整数

默认值:

10

通知工作者的最大数量。

require_confirmation
类型:

布尔值

默认值:

False

在发送通知之前,是否需要确认 http/https/email 订阅。

external_confirmation_url
类型:

字符串

默认值:

<None>

在电子邮件订阅确认之前将使用的确认页面 URL。

subscription_confirmation_email_template
类型:

dict

默认值:

{'topic': 'Zaqar 通知 - 订阅确认', 'body': '您已选择订阅队列: {0}。 此队列属于项目: {1}。 要确认此订阅,请点击或访问以下链接: {2}', 'sender': 'Zaqar 通知 <no-reply@openstack.org>'}

定义订阅确认电子邮件的内容,包括主题、正文和发件人。正文中存在映射关系:{0} -> 队列名称,{1} ->项目 ID,{2}-> 确认 URL。用户可以使用这三个值中的任何一个。但他们不能使用超过三个。

unsubscribe_confirmation_email_template
类型:

dict

默认值:

{'topic': 'Zaqar 通知 - 取消订阅确认', 'body': '您已成功取消订阅队列: {0}。 此队列属于项目: {1}。 要重新订阅此订阅,请点击或访问以下链接: {2}', 'sender': 'Zaqar 通知 <no-reply@openstack.org>'}

定义取消订阅确认电子邮件的内容,包括主题、正文和发件人。正文中存在映射关系:{0} -> 队列名称,{1} ->项目 ID,{2}-> 确认 URL。用户可以使用这三个值中的任何一个。但他们不能使用超过三个。

oslo_messaging_kafka

kafka_max_fetch_bytes
类型:

整数

默认值:

1048576

Kafka 消费者最大获取字节数

kafka_consumer_timeout
类型:

浮点数

默认值:

1.0

Kafka 消费者的默认超时时间(秒)

consumer_group
类型:

字符串

默认值:

oslo_messaging_consumer

Kafka 消费者的组 ID。同一组中的消费者将协调消息消费

producer_batch_timeout
类型:

浮点数

默认值:

0.0

KafkaProducer 批量处理延迟的上限(秒)

producer_batch_size
类型:

整数

默认值:

16384

生产者异步发送的批处理大小

compression_codec
类型:

字符串

默认值:

none

有效值:

none, gzip, snappy, lz4, zstd

生产者生成的所有数据的压缩编解码器。如果未设置,则不使用压缩。请注意,允许的值取决于 kafka 版本

enable_auto_commit
类型:

布尔值

默认值:

False

启用异步消费者提交

max_poll_records
类型:

整数

默认值:

500

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

security_protocol
类型:

字符串

默认值:

PLAINTEXT

有效值:

PLAINTEXT, SASL_PLAINTEXT, SSL, SASL_SSL

用于与代理通信的协议

sasl_mechanism
类型:

字符串

默认值:

PLAIN

安全协议为 SASL 时的机制

ssl_cafile
类型:

字符串

默认值:

''

用于验证服务器证书的 CA 证书 PEM 文件

ssl_client_cert_file
类型:

字符串

默认值:

''

用于身份验证的客户端证书 PEM 文件。

ssl_client_key_file
类型:

字符串

默认值:

''

用于身份验证的客户端密钥 PEM 文件。

ssl_client_key_password
类型:

字符串

默认值:

''

用于身份验证的客户端密钥密码文件。

oslo_messaging_notifications

driver
类型:

多值

默认值:

''

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

transport_url
类型:

字符串

默认值:

<None>

用于通知的消息驱动程序的 URL。如果未设置,我们将回退到用于 RPC 的相同配置。

topics
类型:

列表

默认值:

['notifications']

用于 OpenStack 通知 AMQP 主题。

retry
类型:

整数

默认值:

-1

由于可恢复错误而未能传递的通知消息重试的最大次数。0 - 不重试,-1 - 无限

oslo_messaging_rabbit

amqp_durable_queues
类型:

布尔值

默认值:

False

在 AMQP 中使用持久队列。如果启用了 rabbit_quorum_queue,则队列将是持久的,并且此值将被忽略。

amqp_auto_delete
类型:

布尔值

默认值:

False

在 AMQP 中自动删除队列。

rpc_conn_pool_size
类型:

整数

默认值:

30

最小值:

1

RPC 连接池的大小。

conn_pool_min_size
类型:

整数

默认值:

2

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

conn_pool_ttl
类型:

整数

默认值:

1200

池中空闲连接的生存时间(秒)

ssl
类型:

布尔值

默认值:

False

通过 SSL 连接。

ssl_version
类型:

字符串

默认值:

''

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

ssl_key_file
类型:

字符串

默认值:

''

SSL 密钥文件(仅在启用 SSL 时有效)。

ssl_cert_file
类型:

字符串

默认值:

''

SSL 证书文件(仅在启用 SSL 时有效)。

ssl_ca_file
类型:

字符串

默认值:

''

用于验证服务器证书的 SSL 证书颁发机构文件(仅在启用 SSL 时有效)。

ssl_enforce_fips_mode
类型:

布尔值

默认值:

False

全局切换以强制执行 OpenSSL FIPS 模式。此功能需要 Python 支持。这在所有环境中的 Python 3.9 中可用,并且可能已回溯到旧版本的 Python。如果使用的 Python 可执行文件不支持 OpenSSL FIPS 模式,将引发异常。

heartbeat_in_pthread
类型:

布尔值

默认值:

False

(已弃用) 建议不再使用此选项。默认情况下,通过本机 python 线程运行健康检查心跳线程。如果此选项等于 False,则心跳将继承父进程的执行模型。例如,如果父进程通过使用 eventlet/greenlet 猴子补丁了 stdlib,则心跳将通过绿色线程运行。仅当使用 eventlet 作为核心服务框架的服务时,才应将此选项设置为 True。

警告

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

原因:

该选项与即将删除的 Eventlet 相关。此外,这从未像预期那样与使用 eventlet 作为核心服务框架的服务一起工作。

kombu_reconnect_delay
类型:

浮点数

默认值:

1.0

最小值:

0.0

最大值:

4.5

响应 AMQP 消费者取消通知后重新连接的等待时间(秒)。

kombu_reconnect_splay
类型:

浮点数

默认值:

0.0

最小值:

0.0

响应 AMQP 消费者取消通知后重新连接时随机等待时间。

kombu_compression
类型:

字符串

默认值:

<None>

实验性:可能的值是:gzip、bz2。如果未设置,则不使用压缩。此选项可能在未来版本中不可用。

kombu_missing_consumer_retry_timeout
类型:

整数

默认值:

60

在放弃向其发送回复之前等待缺失客户端的时间。此值不应大于 rpc_response_timeout。

已弃用的变体

Group

名称

oslo_messaging_rabbit

kombu_reconnect_timeout

kombu_failover_strategy
类型:

字符串

默认值:

round-robin

有效值:

round-robin, shuffle

确定在当前连接的 RabbitMQ 节点不可用时如何选择下一个 RabbitMQ 节点。仅当配置中提供多个 RabbitMQ 节点时才生效。

rabbit_login_method
类型:

字符串

默认值:

AMQPLAIN

有效值:

PLAIN, AMQPLAIN, EXTERNAL, RABBIT-CR-DEMO

RabbitMQ 登录方法。

rabbit_retry_interval
类型:

整数

默认值:

1

最小值:

1

与 RabbitMQ 重新连接的频率。

rabbit_retry_backoff
类型:

整数

默认值:

2

最小值:

0

在连接到 RabbitMQ 时重试之间的回退时间。

rabbit_interval_max
类型:

整数

默认值:

30

最小值:

1

RabbitMQ 连接重试的最大间隔。

rabbit_ha_queues
类型:

布尔值

默认值:

False

尝试在 RabbitMQ 中使用 HA 队列(x-ha-policy:all)。如果您更改此选项,则必须擦除 RabbitMQ 数据库。在 RabbitMQ 3.0 中,队列镜像不再由声明队列时的 x-ha-policy 参数控制。如果您只想确保所有队列(不包括具有自动生成名称的队列)在所有节点上镜像,请运行:“rabbitmqctl set_policy HA ‘^(?!amq.).*’ ‘{“ha-mode”: “all”}’ “

rabbit_quorum_queue
类型:

布尔值

默认值:

False

在 RabbitMQ 中使用 quorum 队列(x-queue-type:quorum)。quorum 队列是 RabbitMQ 的一种现代队列类型,它实现了一个基于 Raft 共识算法的持久、复制的 FIFO 队列。它从 RabbitMQ 3.8.0 开始可用。如果设置此选项,它将与 HA 队列(rabbit_ha_queues)即镜像队列冲突,换句话说,应禁用 HA 队列。Quorum 队列默认情况下也是持久的,因此启用此选项时会忽略 amqp_durable_queues 选项。

rabbit_transient_quorum_queue
类型:

布尔值

默认值:

False

在 RabbitMQ 中为瞬态队列使用 quorum 队列。启用此选项将确保这些队列也使用 quorum 类型的 rabbit 队列,这些队列默认情况下是 HA。

rabbit_quorum_delivery_limit
类型:

整数

默认值:

0

每次将消息重新传递给消费者时,都会递增计数器。一旦重新传递计数超过传递限制,该消息将被丢弃或死信(如果配置了 DLX 交换机)。仅当启用 rabbit_quorum_queue 时使用,默认值为 0,表示不设置限制。

rabbit_quorum_max_memory_length
类型:

整数

默认值:

0

默认情况下,所有消息都保存在内存中。如果 quorum 队列增长,可能会给集群带来内存压力。此选项可以限制 quorum 队列中的消息数量。仅当启用 rabbit_quorum_queue 时使用,默认值为 0,表示不设置限制。

rabbit_quorum_max_memory_bytes
类型:

整数

默认值:

0

默认情况下,所有消息都保存在内存中。如果 quorum 队列增长,可能会给集群带来内存压力。此选项可以限制 quorum 队列使用的内存字节数。仅在启用 rabbit_quorum_queue 时使用,默认值为 0,表示不设置限制。

rabbit_transient_queues_ttl
类型:

整数

默认值:

1800

最小值:

0

表示队列 TTL(x-expires)的秒数(正整数)。对于达到 TTL 持续时间的未使用的队列,将自动删除。该参数仅影响回复和扇出队列。将值设置为 0 将禁用 x-expires。如果这样做,请确保您拥有一个 rabbitmq 策略来删除队列,否则您的部署会随着时间的推移创建无限数量的队列。如果将 rabbit_stream_fanout 设置为 True,此选项将控制扇出队列中消息的数据保留策略(x-max-age),而不是队列持续时间本身。因此,一旦达到 TTL,流队列中最旧的数据将被丢弃。将设置为 0 将禁用流的 x-max-age,从而使流无限增长并填满磁盘空间

rabbit_qos_prefetch_count
类型:

整数

默认值:

0

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

heartbeat_timeout_threshold
类型:

整数

默认值:

60

如果心跳的 keep-alive 失败,则 Rabbit broker 被认为已关闭的时间(秒)。(0 禁用心跳)。

heartbeat_rate
类型:

整数

默认值:

3

在 heartbeat_timeout_threshold 期间检查心跳的频率。

direct_mandatory_flag
类型:

布尔值

默认值:

True

(已弃用)启用/禁用直接发送的 RabbitMQ mandatory 标志。直接发送用作回复,因此如果客户端队列不存在,则会引发 MessageUndeliverable 异常。MessageUndeliverable 异常将用于超时循环,以便让发送者有机会恢复。此标志已弃用,并且不再可以禁用此功能

警告

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

原因:

Mandatory 标志不再可以禁用。

enable_cancel_on_failover
类型:

布尔值

默认值:

False

启用 x-cancel-on-ha-failover 标志,以便 rabbitmq 服务器在队列关闭时取消并通知消费者

use_queue_manager
类型:

布尔值

默认值:

False

我们应该使用一致的队列名称还是随机名称

hostname
类型:

字符串

默认值:

node1.example.com

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

队列管理器使用的主机名。默认值为 socket.gethostname() 返回的值。

processname
类型:

字符串

默认值:

nova-api

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

队列管理器使用的进程名称

rabbit_stream_fanout
类型:

布尔值

默认值:

False

在 RabbitMQ 中使用流队列(x-queue-type: stream)。流是 RabbitMQ 3.9.0 及更高版本中一种新的持久化和复制的数据结构(“队列类型”),它模拟了一个仅追加日志,具有非破坏性消费者语义。如果设置此选项,将用单个流队列替换所有扇出队列。

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 的策略检查的超时时间(秒)

oslo_reports

log_dir
类型:

字符串

默认值:

<None>

创建文件的日志目录的路径

file_event_handler
类型:

字符串

默认值:

<None>

监视文件更改以触发报告的路径,而不是信号。设置此选项会禁用报告的信号触发器。如果应用程序作为 WSGI 应用程序运行,建议使用此方法而不是信号。

file_event_handler_interval
类型:

整数

默认值:

1

当设置 file_event_handler 时,轮询之间的秒数

pooling:catalog

enable_virtual_pool
类型:

布尔值

默认值:

False

如果启用,message_store 将用作虚拟池的存储。

profiler

enabled
类型:

布尔值

默认值:

False

启用此节点上所有服务的分析。

默认值为 False(完全禁用分析功能)。

可能的值

  • True:启用该功能

  • False:禁用该功能。无法通过此项目操作启动分析。如果分析由另一个项目触发,则此项目部分将为空。

已弃用的变体

Group

名称

profiler

profiler_enabled

trace_sqlalchemy
类型:

布尔值

默认值:

False

在服务中启用 SQL 请求分析。

默认值为 False(SQL 请求不会被跟踪)。

可能的值

  • True:启用 SQL 请求分析。每个 SQL 查询都将成为跟踪的一部分,并可以分析花费的时间。

  • False:禁用 SQL 请求分析。花费的时间仅在较高层次的操作上显示。无法以这种方式分析单个 SQL 查询。

trace_requests
类型:

布尔值

默认值:

False

启用 python requests 包分析。

支持的驱动程序:jaeger+otlp

默认值为 False。

可能的值

  • True:启用请求分析。

  • False:禁用请求分析。

hmac_keys
类型:

字符串

默认值:

SECRET_KEY

用于加密性能分析上下文数据的密钥。

此字符串值应具有以下格式:<key1>[,<key2>,…<keyn>],其中每个密钥都是一些随机字符串。通过 REST API 触发分析的用户必须在 REST API 调用中设置这些密钥之一,才能将此节点的分析结果包含到该特定项目中。

应设置“enabled”标志和“hmac_keys”配置选项才能启用分析。此外,为了生成所有服务之间的正确分析信息,至少有一个密钥需要在 OpenStack 项目之间保持一致。这确保了客户端可以使用它来生成包含所有可能资源的跟踪。

connection_string
类型:

字符串

默认值:

messaging://

通知后端连接字符串。

默认值为 messaging://,它将通知程序设置为 oslo_messaging。

可能的示例值

  • messaging:// - 使用 oslo_messaging 驱动程序发送跨度。

  • redis://127.0.0.1:6379 - 使用 redis 驱动程序发送跨度。

  • mongodb://127.0.0.1:27017 - 使用 mongodb 驱动程序发送跨度。

  • elasticsearch://127.0.0.1:9200 - 使用 elasticsearch 驱动程序发送跨度。

  • jaeger://127.0.0.1:6831 - 使用 jaeger 跟踪作为驱动程序发送跨度。

es_doc_type
类型:

字符串

默认值:

notification

在 elasticsearch 中进行通知索引的文档类型。

es_scroll_time
类型:

字符串

默认值:

2m

此参数是一个时间值参数(例如:es_scroll_time=2m),指示参与搜索的节点将保持相关资源多长时间,以便继续并支持它。

es_scroll_size
类型:

整数

默认值:

10000

Elasticsearch 将大型请求拆分为批处理。此参数定义每个批处理的最大大小(例如:es_scroll_size=10000)。

socket_timeout
类型:

浮点数

默认值:

0.1

Redissentinel 在连接上提供超时选项。此参数定义该超时(例如:socket_timeout=0.1)。

sentinel_service_name
类型:

字符串

默认值:

mymaster

Redissentinel 使用服务名称来标识主 redis 服务。此参数定义该名称(例如:sentinal_service_name=mymaster)。

filter_error_trace
类型:

布尔值

默认值:

False

启用将包含错误/异常的跟踪过滤到单独的位置。

默认值为 False。

可能的值

  • True:启用过滤包含错误/异常的跟踪。

  • False:禁用过滤器。

trace_wsgi_transport
类型:

布尔值

默认值:

False

如果为 False,则不跟踪任何传输请求。请注意,现在它对 websocket 无效。

trace_message_store
类型:

布尔值

默认值:

False

如果为 False,则不跟踪任何消息存储请求。

trace_management_store
类型:

布尔值

默认值:

False

如果为 False,则不跟踪任何管理存储请求。

profiler_jaeger

service_name_prefix
类型:

字符串

默认值:

<None>

将服务名称前缀设置为 Jaeger 服务名称。

process_tags
类型:

dict

默认值:

{}

设置进程跟踪器标签。

profiler_otlp

service_name_prefix
类型:

字符串

默认值:

<None>

将服务名称前缀设置为 OTLP 导出器。

signed_url

secret_key
类型:

字符串

默认值:

<None>

用于加密预签名 URL 的密钥。

storage

queue_pipeline
类型:

列表

默认值:

[]

用于处理队列操作的管道。此管道将在调用存储驱动程序的控制器方法之前被使用。

message_pipeline
类型:

列表

默认值:

[]

用于处理消息操作的管道。此管道将在调用存储驱动程序的控制器方法之前被使用。

claim_pipeline
类型:

列表

默认值:

[]

用于处理声明操作的管道。此管道将在调用存储驱动程序的控制器方法之前被使用。

subscription_pipeline
类型:

列表

默认值:

[]

用于处理订阅操作的管道。此管道将在调用存储驱动程序的控制器方法之前被使用。

topic_pipeline
类型:

列表

默认值:

[]

用于处理主题操作的管道。此管道将在调用存储驱动程序的控制器方法之前被使用。

transport

default_message_ttl
类型:

整数

默认值:

3600

定义消息可访问的时间长度。

default_message_delay
类型:

整数

默认值:

0

定义队列延迟秒的默认值。0 表示关闭延迟队列功能。

default_claim_ttl
类型:

整数

默认值:

300

定义消息处于已声明状态的时间长度。

default_claim_grace
类型:

整数

默认值:

60

定义消息的宽限期,以秒为单位。

default_subscription_ttl
类型:

整数

默认值:

3600

定义订阅的可用时间长度。

max_queues_per_page
类型:

整数

默认值:

20

定义每页的最大队列数。

max_messages_per_page
类型:

整数

默认值:

20

定义每页的最大消息数。

max_subscriptions_per_page
类型:

整数

默认值:

20

定义每页的最大订阅数。

max_messages_per_claim_or_pop
类型:

整数

默认值:

20

单次请求中可以声明(或弹出)的最大消息数

max_queue_metadata
类型:

整数

默认值:

65536

定义队列中的最大元数据量。

max_messages_post_size
类型:

整数

默认值:

262144

定义消息发布的最大大小。

max_message_ttl
类型:

整数

默认值:

1209600

消息可用的最大时间量。

max_message_delay
类型:

整数

默认值:

900

消息可以被声明的最大延迟秒数。

max_claim_ttl
类型:

整数

默认值:

43200

消息处于已声明状态的最大长度。

max_claim_grace
类型:

整数

默认值:

43200

定义消息的最大宽限期,以秒为单位。

subscriber_types
类型:

列表

默认值:

['http', 'https', 'mailto', 'trust+http', 'trust+https']

定义支持的订阅者类型。

max_flavors_per_page
类型:

整数

默认值:

20

定义每页的最大风味数。

max_pools_per_page
类型:

整数

默认值:

20

定义每页的最大池数。

client_id_uuid_safe
类型:

字符串

默认值:

strict

有效值:

strict, off

定义客户端 ID 的格式。

可能的值

strict

仅接受有效的 UUID

关闭

接受任何字符串

min_length_client_id
类型:

整数

默认值:

10

定义客户端 ID 的最小长度。仅当 client_id_uuid_safe 为 off 时使用。

max_length_client_id
类型:

整数

默认值:

36

定义客户端 ID 的最大长度。仅当 client_id_uuid_safe 为 off 时使用。

message_delete_with_claim_id
类型:

布尔值

默认值:

False

启用删除消息必须带有声明 ID。这将提高消息的安全性,避免在消息被声明和处理之前删除消息。

message_encryption_algorithms
类型:

字符串

默认值:

AES256

有效值:

AES256, RSA

定义消息的加密算法,当前值为“AES256”。

message_encryption_key
类型:

字符串

默认值:

AES256

定义算法的加密密钥。