后端驱动¶
已知的后端驱动¶
远程文件¶
remote_file 后端驱动是 oslo.config 实现的第一个驱动。它扩展了之前仅访问本地文件的限制,引入了一种可以通过网络访问配置数据的新场景。remote_file 驱动基于 requests 模块,能够通过 HTTP 或 HTTPS 访问远程文件。
远程文件配置数据源的定义可以像这样简单:
[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¶
环境中选项的配置源。