配置选项¶
oslo.service 使用 oslo.config 来定义和管理配置选项，以便部署者可以控制应用程序如何使用此库。
周期性任务¶
这些选项适用于使用 oslo.service 的周期性任务功能的服务。
默认值¶
- run_external_periodic_tasks¶
- 类型:
布尔值
- 默认值:
True
某些周期性任务可以在单独的进程中运行。我们是否应该在这里运行它们？
服务¶
这些选项适用于使用基本服务框架的服务。
默认值¶
- backdoor_port¶
- 类型:
字符串
- 默认值:
<None>
启用 eventlet 后门。可接受的值为 0、<端口> 和 <开始>:<结束>，其中 0 将导致监听随机 tcp 端口号；<端口> 将导致监听指定的端口号（如果该端口正在使用则不启用后门）；<开始>:<结束> 将导致监听指定端口号范围内未使用的最小端口号。所选端口将显示在服务的日志文件中。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘backdoor_port’ 选项已弃用，将在未来的版本中删除。
- backdoor_socket¶
- 类型:
字符串
- 默认值:
<None>
启用 eventlet 后门，使用提供的路径作为可以接收连接的 unix 套接字。此选项与 ‘backdoor_port’ 互斥，即只能提供一个。如果同时提供两者，则此选项的存在优先于该选项的使用。在路径内部，{pid} 将被替换为当前进程的 PID。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘backdoor_socket’ 选项已弃用，将在未来的版本中删除。
- log_options¶
- 类型:
布尔值
- 默认值:
True
启用或禁用在服务启动时（DEBUG 级别）记录所有已注册选项的值。
- graceful_shutdown_timeout¶
- 类型:
整数
- 默认值:
60
指定优雅关闭服务器在退出之前等待的超时时间。值为零表示无限期等待。
sslutils¶
这些选项适用于使用 SSL 工具模块的服务。
ssl¶
- ca_file¶
- 类型:
字符串
- 默认值:
<None>
用于验证连接客户端的 CA 证书文件。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘ca_file’ 选项已弃用，将在未来的版本中删除。
- cert_file¶
- 类型:
字符串
- 默认值:
<None>
在安全启动服务器时使用的证书文件。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘cert_file’ 选项已弃用，将在未来的版本中删除。
- key_file¶
- 类型:
字符串
- 默认值:
<None>
在安全启动服务器时使用的私钥文件。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘key_file’ 选项已弃用，将在未来的版本中删除。
- version¶
- 类型:
字符串
- 默认值:
<None>
要使用的 SSL 版本（仅在启用 SSL 时有效）。有效值为 TLSv1 和 SSLv23。某些发行版上可能可用 SSLv2、SSLv3、TLSv1_1 和 TLSv1_2。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘version’ 选项已弃用，将在未来的版本中删除。
- ciphers¶
- 类型:
字符串
- 默认值:
<None>
设置可用的密码列表。该值应为 OpenSSL 密码列表格式的字符串。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘ciphers’ 选项已弃用，将在未来的版本中删除。
wsgi¶
这些选项适用于使用 WSGI（Web 服务网关接口）模块的服务。
默认值¶
- api_paste_config¶
- 类型:
字符串
- 默认值:
api-paste.ini
api 服务的 paste.deploy 配置文件名
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘api_paste_config’ 选项已弃用，将在未来的版本中删除。
- wsgi_log_format¶
- 类型:
字符串
- 默认值:
%(client_ip)s "%(request_line)s" 状态: %(status_code)s 长度: %(body_length)s 时间: %(wall_seconds).7f
用于生成日志行的 python 格式字符串。以下值可以格式化到其中：client_ip、date_time、request_line、status_code、body_length、wall_seconds。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘wsgi_log_format’ 选项已弃用，将在未来的版本中删除。
- tcp_keepidle¶
- 类型:
整数
- 默认值:
600
为每个服务器套接字设置 TCP_KEEPIDLE 的值（以秒为单位）。不支持在 OS X 上。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘tcp_keepidle’ 选项已弃用，将在未来的版本中删除。
- wsgi_default_pool_size¶
- 类型:
整数
- 默认值:
100
wsgi 使用的绿线程池的大小
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘wsgi_default_pool_size’ 选项已弃用，将在未来的版本中删除。
- max_header_line¶
- 类型:
整数
- 默认值:
16384
接受的消息标头的最大行大小。当使用大型令牌时（通常是在配置为使用 PKI 令牌和大型服务目录的 keystone 时），可能需要增加 max_header_line。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘max_header_line’ 选项已弃用，将在未来的版本中删除。
- wsgi_keep_alive¶
- 类型:
布尔值
- 默认值:
True
如果为 False，则显式关闭客户端套接字连接。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘wsgi_keep_alive’ 选项已弃用，将在未来的版本中删除。
- client_socket_timeout¶
- 类型:
整数
- 默认值:
900
客户端连接套接字操作的超时时间。如果传入连接处于空闲状态的时间超过此秒数，则将关闭该连接。值为“0”表示无限期等待。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘client_socket_timeout’ 选项已弃用，将在未来的版本中删除。
- wsgi_server_debug¶
- 类型:
布尔值
- 默认值:
False
如果为 True，服务器将在 500 错误时将异常堆栈跟踪发送给客户端。如果为 False，服务器将用空主体响应。
警告
此选项已弃用，将来可能会被静默忽略。
- 原因:
‘wsgi_server_debug’ 选项已弃用，将在未来的版本中删除。
