后端驱动

请参考 oslo_config.sources

已知的后端驱动

远程文件

remote_file 后端驱动是 oslo.config 实现的第一个驱动。它扩展了之前仅访问本地文件的限制,引入了一种可以通过网络访问配置数据的新场景。remote_file 驱动基于 requests 模块,能够通过 HTTPHTTPS 访问远程文件。

远程文件配置数据源的定义可以像这样简单:

[DEFAULT]
config_source = external_config_group

[external_config_group]
driver = remote_file
uri = http://mydomain.com/path/to/config/data.conf

或者像这样完整:

[DEFAULT]
config_source = external_config_group

[external_config_group]
driver = remote_file
uri = https://mydomain.com/path/to/config/data.conf
ca_path = /path/to/server/ca.pem
client_key = /path/to/my/key.pem
client_cert = /path/to/my/cert.pem

在接下来的章节中,您可以找到有关此驱动程序的类及其选项的更多信息。

驱动程序类

class oslo_config.sources._uri.URIConfigurationSourceDriver

通过 http[s] 提供服务的远程文件的后端驱动。

必需的选项
  • uri: 包含文件位置的 URI。

非必需的选项
  • ca_path: CA_BUNDLE 文件或包含

    受信任 CA 证书的目录的路径。

  • client_cert: 客户端证书,作为单个文件路径

    包含证书本身或私钥和证书。

  • client_key: 客户端私钥,如果指定了 client_cert

    但未包含私钥。

配置源类

class oslo_config.sources._uri.URIConfigurationSource(uri, ca_path=None, client_cert=None, client_key=None, timeout=60)

通过 http[s] 提供服务的远程文件的配置源。

参数:
  • uri – 要检索的配置的统一资源标识符。

  • ca_path – CA_BUNDLE 文件或包含受信任 CA 证书的目录的路径。

  • client_cert – 客户端证书,作为单个文件路径,包含证书本身或私钥和证书。

  • client_key – 客户端私钥,如果指定了 client_cert 但未包含私钥。

环境

environment 后端驱动提供了一种访问环境变量中配置数据的方法。它默认启用,无需额外配置即可使用。在命令行选项之后,但在配置文件之前检查环境。

环境变量会检查任何配置数据。变量名称采用以下形式:

  • 前缀为 OS_

  • 组名,大写

  • __(双下划线)分隔

  • 后跟名称

对于在通常的 INI 格式中看起来像这样的选项:

[placement_database]
connection = sqlite:///

相应的环境变量将是 OS_PLACEMENT_DATABASE__CONNECTION

驱动程序类

class oslo_config.sources._environment.EnvironmentConfigurationSourceDriver

环境变量的后端驱动。

此配置源默认可用,无需特殊配置即可使用。示例配置会自动生成,但不是必需的。

配置源类

class oslo_config.sources._environment.EnvironmentConfigurationSource

环境中选项的配置源。