2.9 KiB
Running Mogan API using uWSGI
The recommended way to deploy Mogan is have a web server such as Apache or nginx to handle http requests and proxy these requests to Mogan WSGI app running in uWSGI. Mogan comes with some configuration templates on how to deploy the api service with Apache and uWSGI.
app.wsgi
The mogan/api/app.wsgi
file contains a WSGI application
of Mogan API service. This file is installed with Mogan application
code.
apache-mogan.template
The mogan/etc/apache-mogan.template
file contains a copy
of Apache configuration file for Mogan API used by devstack.
mogan-uwsgi.ini.sample
The mogan/etc/mogan-uwsgi.ini.sample
file is a sample
configuration file for uWSGI server. Update the file to match your
system configuration.
Steps to use these sample configuration files:
- Enable mod_proxy_uwsgi module
- On Ubuntu install required uwsgi package
sudo apt-get install libapache2-mod-proxy-uwsgi
; enable usingsudo a2enmod proxy
,sudo a2enmod proxy_uwsgi
. - On Fedora the required package is mod_proxy_uwsgi; enable by
creating a file
/etc/httpd/conf.modules.d/11-proxy_uwsgi.conf
containingLoadModule proxy_uwsgi_module modules/mod_proxy_uwsgi.so
On deb-based systems copy or symlink the file
apache-mogan.template
to/etc/apache2/sites-available/mogan.conf
. For rpm-based systems the file should go into/etc/httpd/conf.d/mogan.conf
. uWSGI need a socket file to connect between apache proxy and uWSGI web server, it usually is under/var/run/uwsgi
, but/var/run
will be empty on after system reboot, so we can use systemd-temptiles to automatically create a socket dir:$ sudo mkdir -p /etc/tmpfiles.d/ $ echo "d /var/run/uwsgi 0755 <STACK_USER> root" | sudo tee/etc/tmpfiles.d/uwsgi.conf $ sudo systemd-tmpfiles --create /etc/tmpfiles.d/uwsgi.conf
Enable Mogan site. On deb-based systems:
$ a2ensite mogan $ service apache2 reload
On rpm-based systems:
$ service httpd reload
Copy mogan/etc/mogan-uwsgi.ini.sample to /etc/mogan/mogan-uwsgi.ini.
Start Mogan api using uWSGI:
$ sudo pip install uwsgi $ uwsgi --ini /etc/mogan/mogan-uwsgi.ini