Configuration Options from oslo.config

When loading values from the sources defined by the following options, the precedence is as follows:

  1. Command Line
  2. Environment Variables
  3. Config Files from --config-dir [1]
  4. Config Files from --config-file
  5. Pluggable Config Sources

If a value is specified in multiple locations, the location used will be the one higher in the list. For example, if a value is specified both on the command line and in an environment variable, the value from the command line will be the one returned.

[1]Files in a config dir are parsed in alphabetical order. Later files take precedence over earlier ones.

DEFAULT

config_file
Type:list of filenames
Default:~/.project/project.conf,~/project.conf,/etc/project/project.conf,/etc/project.conf

Path to a config file to use. Multiple config files can be specified, with values in later files taking precedence. Defaults to the value above. This option must be set from the command-line.

config_dir
Type:list of directory names
Default:~/.project/project.conf.d/,~/project.conf.d/,/etc/project/project.conf.d/,/etc/project.conf.d/

Path to a config directory to pull *.conf files from. This file set is sorted, so as to provide a predictable parse order if individual options are over-ridden. The set is parsed after the file(s) specified via previous –config-file, arguments hence over-ridden options in the directory take precedence. This option must be set from the command-line.

config_source
Type:list
Default:''

Lists configuration groups that provide more details for accessing configuration settings from locations other than local files.

sample_remote_file_source

Example of using a remote_file source

remote_file: A backend driver for remote files served through http[s].

Required options:
  • uri: URI containing the file location.
Non-required options:
  • ca_path: The path to a CA_BUNDLE file or directory with
    certificates of trusted CAs.
  • client_cert: Client side certificate, as a single file path
    containing either the certificate only or the private key and the certificate.
  • client_key: Client side private key, in case client_cert is
    specified but does not includes the private key.
driver
Type:string
Default:remote_file

This option has a sample default set, which means that its actual default value may vary from the one documented above.

The name of the driver that can load this configuration source.

uri
Type:URI
Default:https://example.com/my-configuration.ini

This option has a sample default set, which means that its actual default value may vary from the one documented above.

Required option with the URI of the extra configuration file’s location.

ca_path
Type:string
Default:/etc/ca-certificates

This option has a sample default set, which means that its actual default value may vary from the one documented above.

The path to a CA_BUNDLE file or directory with certificates of trusted CAs.

client_cert
Type:string
Default:/etc/ca-certificates/service-client-keystore

This option has a sample default set, which means that its actual default value may vary from the one documented above.

Client side certificate, as a single file path containing either the certificate only or the private key and the certificate.

client_key
Type:string
Default:<None>

Client side private key, in case client_cert is specified but does not includes the private key.