diff options
author | Sean Mooney <work@seanmooney.info> | 2022-11-08 15:00:22 +0000 |
---|---|---|
committer | Balazs Gibizer <gibi@redhat.com> | 2022-12-07 12:36:32 +0100 |
commit | 73fe84fa0ea6f7c7fa55544f6bce5326d87743a6 (patch) | |
tree | b9bbcc2b2eb315cf911f5359372f5076811f5fa0 /doc/source | |
parent | c97507dfcd57cce9d76670d3b0d48538900c00e9 (diff) | |
download | nova-73fe84fa0ea6f7c7fa55544f6bce5326d87743a6.tar.gz |
Support multiple config file with mod_wsgi
Unlike uwsgi, apache mod_wsgi does not support passing
commandline arguments to the python wsgi script it invokes.
As a result while you can pass --config-file when hosting the
api and metadata wsgi applications with uwsgi there is no
way to use multiple config files with mod_wsgi.
This change mirrors how this is supported in keystone today
by intoducing a new OS_NOVA_CONFIG_FILES env var to allow
operators to optional pass a ';' delimited list of config
files to load.
This change also add docs for this env var and the existing
undocumented OS_NOVA_CONFIG_DIR.
Closes-Bug: 1994056
Change-Id: I8e3ccd75cbb7f2e132b403cb38022787c2c0a37b
Diffstat (limited to 'doc/source')
-rw-r--r-- | doc/source/user/wsgi.rst | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/doc/source/user/wsgi.rst b/doc/source/user/wsgi.rst index 6b314b4832..63f949df1a 100644 --- a/doc/source/user/wsgi.rst +++ b/doc/source/user/wsgi.rst @@ -8,10 +8,16 @@ as Apache_ or nginx_). The nova project provides two automatically generated entry points that support this: ``nova-api-wsgi`` and ``nova-metadata-wsgi``. These read -``nova.conf`` and ``api-paste.ini`` and generate the required module-level -``application`` that most WSGI servers require. If nova is installed using pip, -these two scripts will be installed into whatever the expected ``bin`` -directory is for the environment. +``nova.conf`` and ``api-paste.ini`` by default and generate the required +module-level ``application`` that most WSGI servers require. +If nova is installed using pip, these two scripts will be installed into +whatever the expected ``bin`` directory is for the environment. + +The config files and config directory can be overridden via the +``OS_NOVA_CONFIG_FILES`` and ``OS_NOVA_CONFIG_DIR`` environment variables. +File paths listed in ``OS_NOVA_CONFIG_FILES`` are relative to +``OS_NOVA_CONFIG_DIR`` and delimited by ``;``. + The new scripts replace older experimental scripts that could be found in the ``nova/wsgi`` directory of the code repository. The new scripts are *not* |