Add new glance.wsgi module

This allows deployment tooling to easily switch from passing a binary
path to passing a Python module path. We'll use it shortly.

Change-Id: Ia67d3b1b2e80b8b2096cb86ba85f47047e89a3d2
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
This commit is contained in:
Stephen Finucane 2024-10-18 13:41:44 +01:00 committed by Rajat Dhasmana
parent 704b24fd67
commit abc5a8838a
3 changed files with 46 additions and 0 deletions
doc/source
glance/wsgi
releasenotes/notes

@ -52,6 +52,8 @@ apidoc_excluded_paths = [
'hacking',
'tests/*',
'tests',
'glance/wsgi/*',
'glance/wsgi',
'db/sqlalchemy/*',
'db/sqlalchemy']
apidoc_separate_modules = True

22
glance/wsgi/api.py Normal file

@ -0,0 +1,22 @@
# Licensed under the Apache License, Version 2.0 (the "License"); you may
# not use this file except in compliance with the License. You may obtain
# a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations
# under the License.
"""WSGI application entry-point for Glance API."""
import threading
from glance.common import wsgi_app
application = None
with threading.Lock():
if application is None:
application = wsgi_app.init_app()

@ -0,0 +1,22 @@
---
features:
- |
A new file, ``glance/wsgi/api.py``, has been added as a place to hold a
WSGI ``application`` object. This is intended to ease deployment by
providing a consistent location for these objects. For example, if using
uWSGI then instead of:
.. code-block:: ini
[uwsgi]
wsgi-file = /bin/glance-wsgi-api
You can now use:
.. code-block:: ini
[uwsgi]
module = glance.wsgi.api:application
This also simplifies deployment with other WSGI servers that expect module
paths such as gunicorn.