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