diff --git a/placement/wsgi.py b/placement/wsgi/__init__.py similarity index 100% rename from placement/wsgi.py rename to placement/wsgi/__init__.py diff --git a/placement/wsgi/api.py b/placement/wsgi/api.py new file mode 100644 index 000000000..dc8e7a11f --- /dev/null +++ b/placement/wsgi/api.py @@ -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 Placement API.""" + +import threading + +from placement import wsgi + + +application = None +with threading.Lock(): + if application is None: + application = wsgi.init_application() diff --git a/releasenotes/notes/add-placment-wsgi-module-ae42938ebe0258cb.yaml b/releasenotes/notes/add-placment-wsgi-module-ae42938ebe0258cb.yaml new file mode 100644 index 000000000..c1e5ee86c --- /dev/null +++ b/releasenotes/notes/add-placment-wsgi-module-ae42938ebe0258cb.yaml @@ -0,0 +1,22 @@ +--- +features: + - | + A new module, ``placement.wsgi``, has been added as a place to gather WSGI + ``application`` objects. 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/placement-api + + You can now use: + + .. code-block:: ini + + [uwsgi] + module = placement.wsgi.api:application + + This also simplifies deployment with other WSGI servers that expect module + paths such as gunicorn.