Victoria 系列发布说明¶
8.3.4¶
错误修复¶
添加缺失的
HostDomain配置选项。 之前此可用类型无法导入，因为未定义相关的配置选项。
8.3.3¶
新特性¶
添加
HostDomain以处理带有下划线的地址。 根据 RFC1033 [1][2][3]，下划线允许在域名中使用。
8.0.0¶
升级说明¶
已停止对 Python 2.7 的支持。 现在支持的 Python 的最低版本是 Python 3.6。
7.0.0¶
升级说明¶
位置参数默认情况下现在是必需的，以匹配 argparse 的默认行为。 要恢复此行为（并保持可选的位置参数），需要显式指定
positional=True, required=False作为选项定义的一部分。
错误修复¶
在命令行上，oslo.config 现在从 argparse 返回命令用法信息（而不是转储回溯），当缺少必需的参数时。
6.10.0¶
新特性¶
oslo-config-validator工具现在有一个新的选项，--exclude-group，允许部署者忽略某些组，这些组可能不会出现在示例配置数据中，可能是因为组的名称取决于其他配置值。 这样，验证器仍然可以用于已知的组。
6.7.0¶
新特性¶
支持通过环境后端驱动程序访问环境变量中的配置数据，默认启用。 在命令行选项之后，但在配置文件之前检查环境。
环境变量会检查任何配置数据。变量名称采用以下形式：
前缀为
OS_组名，大写
用 __（双下划线）分隔
后跟名称
对于在通常的 INI 格式中看起来像这样的选项：
[placement_database] connection = sqlite:///
相应的环境变量将是
OS_PLACEMENT_DATABASE__CONNECTION。
6.6.0¶
新特性¶
现在提供了一个用于配置文件的验证器。 在针对配置文件运行时，它将报告文件中存在的任何未在服务中定义的选项的错误，并报告文件中任何已弃用的选项的警告。 为了发现服务的可用选项，它可以选择使用示例配置生成器配置文件或在其他地方生成的机器可读的示例配置。
6.3.0¶
新特性¶
oslo.config 现在支持 oslo.log 中的 fatal-deprecations 选项。 仅当安装了 oslo.log 时才启用此行为，但 oslo.log 仍然不是硬性要求，以避免循环依赖。
升级说明¶
由于本版本中添加了对 fatal-deprecations 的支持，因此具有启用 fatal-deprecations 且使用已弃用配置选项的用户（之前这不是问题，因为 oslo.config 不尊重 fatal-deprecations 选项）需要在升级之前解决该问题，否则服务可能无法启动。
5.2.0¶
新特性¶
String、Number、Integer、Float 和 Port 现在支持在为 choice 参数提供的 iterable 中使用 value-description 元组。 保留仅 value 定义的支持。
StringOpt 和 PortOpt 现在支持在为 choice 参数提供的 iterable 中使用 value-description 元组。 保留仅 value 定义的支持。
oslo-config-generator 和 Sphinx 扩展现在将输出提供选项选择的描述。 这将影响依赖于前者 yaml 和 json 输出的工具。
4.3.0¶
新特性¶
示例配置生成器现在可以生成示例配置数据的机器可读格式。 这可以被部署工具使用以自动生成包含传统示例配置中所有信息的配置文件。
4.1.0¶
新特性¶
当使用已弃用的选项时，警告该选项已弃用的消息现在包含弃用原因（如果提供了）。
3.22.0¶
序言¶
配置选项类型 HostAddressOpt 添加为接受和验证 IP 地址和主机名。 请参阅 features 部分了解更多信息。
新特性¶
配置选项类型
HostAddressOpt添加为接受有效的 IP 地址（IPv4 和 IPv6）值以及主机名。HostAddressOpt将接受 IPv4 和 IPv6 地址，并确保对 IP 版本进行严格检查。 此选项类型还将接受并准确验证主机名，确保没有无效的 IP 作为有效的hostname通过验证。
3.20.0¶
新特性¶
如果命令行上没有给出 –config-dir 选项，则添加默认的 config-dir 路径。 这类似于 oslo.config 已经支持的默认 config-file 处理。 如果没有给出 –config-dir 选项，oslo.config 现在会在几个目录中搜索配置文件片段（取决于给定的项目名称）。 目录不存在时会被简单跳过。 如果没有给出项目名称，目录是
~/${prog}.conf.d/
/etc/${prog}.conf.d/
只有第一个目录可用时才使用。 如果给出了项目，搜索的目录会更复杂。 搜索 2 个目录，第一次搜索是针对与项目相关的目录
~/.${project}/${project}.conf.d/
~/${project}.conf.d/
/etc/${project}/${project}.conf.d/
/etc/${project}.conf.d/
然后，对于与程序名称相关的配置，搜索以下目录
~/.${project}/${prog}.conf.d/
~/${prog}.conf.d/
/etc/${project}/${prog}.conf.d/
/etc/${prog}.conf.d/
升级说明¶
与 ‘default_config_files’ 类似，‘default_config_dirs’ 不再是允许的配置键。 如果使用该键，将引发 ValueError()。
其他说明¶
添加一些默认的 config-dirs 使即使在 wsgi 环境（如 Apache）中也可以使用 config dir 片段，在这些环境中，很难将命令行参数传递给 wsgi 应用程序。
3.16.0¶
新特性¶
Integer 和 Float 现在支持 min、max 和 choices。 Choices 必须尊重 min 和 max（如果提供）。
添加 Port 类型作为闭区间 [0, 65535] 中的 Integer。
3.14.0¶
新特性¶
为 FloatOpt 添加了最小值和最大值限制。
3.9.0¶
其他说明¶
开始使用 reno 来管理发布说明。
