openstack/devstack
Code Issues Proposed changes

doc: Update WSGI section

Browse Source 
Change-Id: Iaefe12e7fdeddb0fb6fe272cd4df3ce46470cc28
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
This commit is contained in:
Stephen Finucane 2024-10-11 15:20:17 +01:00
parent 224938d313
commit e8e3eb6dc9
2 changed files with 12 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
doc/source/configuration.rst
View File

@ -351,26 +351,21 @@ Example disabling RabbitMQ in ``local.conf``::
disable_service rabbit
Apache Frontend
---------------
The Apache web server can be enabled for wsgi services that support
being deployed under HTTPD + mod_wsgi. By default, services that
recommend running under HTTPD + mod_wsgi are deployed under Apache. To
use an alternative deployment strategy (e.g. eventlet) for services
that support an alternative to HTTPD + mod_wsgi set
``ENABLE_HTTPD_MOD_WSGI_SERVICES`` to ``False`` in your
``local.conf``.
The Apache web server is enabled for services that support via WSGI. Today this
means HTTPD and uWSGI but historically this meant HTTPD + mod_wsgi. This
historical legacy is captured by the naming of many variables, which include
``MOD_WSGI`` rather than ``UWSGI``.
Each service that can be run under HTTPD + mod_wsgi also has an
override toggle available that can be set in your ``local.conf``.
Keystone is run under Apache with ``mod_wsgi`` by default.
Example (Keystone)::
KEYSTONE_USE_MOD_WSGI="True"
Some services support alternative deployment strategies (e.g. eventlet). You
can enable these ``ENABLE_HTTPD_MOD_WSGI_SERVICES`` to ``False`` in your
``local.conf``. In addition, each service that can be run under HTTPD +
mod_wsgi also has an override toggle available that can be set in your
``local.conf``. These are, however, slowly being removed as services have
adopted standardized deployment mechanisms and more generally moved away from
eventlet.
Example (Nova)::
@ -388,7 +383,6 @@ Example (Cinder)::
CINDER_USE_MOD_WSGI="True"
Libraries from Git
------------------

2
stackrc
View File

@ -85,7 +85,7 @@ fi
# Global toggle for enabling services under mod_wsgi. If this is set to
# ``True`` all services that use HTTPD + mod_wsgi as the preferred method of
# deployment, will be deployed under Apache. If this is set to ``False`` all
# services will rely on the local toggle variable (e.g. ``KEYSTONE_USE_MOD_WSGI``)
# services will rely on the local toggle variable.
ENABLE_HTTPD_MOD_WSGI_SERVICES=True
# Set the default Nova APIs to enable