metadata_agent.ini

默认值

metadata_proxy_socket

类型:

字符串

默认值:

$state_path/metadata_proxy

Metadata Proxy UNIX 域套接字的位置。

metadata_proxy_user

类型:

字符串

默认值:

''

初始化后运行 metadata proxy 的用户（uid 或名称）（如果为空：agent 的有效用户）。

metadata_proxy_group

类型:

字符串

默认值:

''

初始化后运行 metadata proxy 的组（gid 或名称）（如果为空：agent 的有效组）。

auth_ca_cert

类型:

字符串

默认值:

<None>

用于 ssl 的证书颁发机构公钥（CA 证书）文件。

nova_metadata_host

类型:

主机地址

默认值:

127.0.0.1

Nova metadata 服务器的 IP 地址或 DNS 名称。

nova_metadata_port

类型:

端口号

默认值:

8775

最小值:

0

最大值:

65535

Nova metadata 服务器使用的 TCP 端口。

metadata_proxy_shared_secret

类型:

字符串

默认值:

''

在代理 metadata 请求时，Neutron 会使用共享密钥对 Instance-ID 标头进行签名，以防止欺骗。您可以选择任何字符串作为密钥，但它必须与 Nova metadata 服务器配置中使用的密钥匹配。注意：Nova 使用相同的配置键，但位于 [neutron] 部分。

nova_metadata_protocol

类型:

字符串

默认值:

http

有效值:

http, https

访问 Nova metadata 的协议，http 或 https。

nova_metadata_insecure

类型:

布尔值

默认值:

False

允许执行不安全的 SSL (https) 请求到 Nova metadata。

nova_client_cert

类型:

字符串

默认值:

''

Nova metadata api 服务器的客户端证书。

nova_client_priv_key

类型:

字符串

默认值:

''

客户端证书的私钥。

metadata_proxy_socket_mode

类型:

字符串

默认值:

deduce

有效值:

deduce, user, group, all

Metadata Proxy UNIX 域套接字模式，允许 4 个值：‘deduce’：从 metadata_proxy_user/group 值推断模式，‘user’：将 metadata proxy 套接字模式设置为 0o644，用于 metadata_proxy_user 是 agent 有效用户或 root 时，‘group’：将 metadata proxy 套接字模式设置为 0o664，用于 metadata_proxy_group 是 agent 有效组或 root 时，‘all’：将 metadata proxy 套接字模式设置为 0o666，用于其他情况。

metadata_workers

类型:

整数

默认值:

<num_of_cpus> / 2

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

metadata 服务器的单独工作进程数量（在使用 ML2/OVN 时默认为 0，使用其他后端驱动程序时为 CPU 数量的一半）。

metadata_backlog

类型:

整数

默认值:

4096

配置 metadata 服务器套接字的回溯请求数量。

rpc_response_max_timeout

类型:

整数

默认值:

600

等待 RPC 调用响应的最大秒数。

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

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

agent

report_interval

类型:

浮点数

默认值:

30

节点向服务器报告状态的秒数；应小于 agent_down_time，最好是 agent_down_time 的一半或更少。

log_agent_heartbeats

类型:

布尔值

默认值:

False

记录 agent 心跳。

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.memcached 或 oslo_cache.memcache_pool 并且给定的主机引用 IPv6 或给定的域名引用 IPv6，则应使用地址族 (inet6) (例如 inet6:[::1]:11211, inet6:[fd12:3456:789a:1::1]:11211, inet6:[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.bmemcache、dogpile.cache.pymemcache、oslo_cache.memcache_pool、dogpile.cache.redis 和 dogpile.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.bmemcache、dogpile.cache.pymemcache 和 oslo_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.bmemcache、dogpile.cache.pymemcache 和 oslo_cache.memcache_pool 支持。