arno/isso
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Merge pull request #447 from tribut/wsgi-docs

Browse Source 
Update docs for mod_wsgi
This commit is contained in:
Benoît Latinier 2018-07-28 23:22:29 +02:00 committed by GitHub
commit 0a7b8ae7df
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 49 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
docs/docs/extras/deployment.rst
View File

@ -99,27 +99,44 @@ To execute Isso, use a command similar to:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
First, create a startup script, called `isso.wsgi`. If Isso is in your system module First, create a startup script, called `isso.wsgi`. If Isso is in your system module
search path, then the script is quite simple: search path, then the script is quite simple. This script is included in the
isso distribution as `run.py`:
.. code-block:: python .. code-block:: python
from isso import make_app from __future__ import unicode_literals
from isso.core import Config
application = make_app(Config.load("/path/to/isso.cfg")) import os
from isso import make_app
from isso import dist, config
application = make_app(
config.load(
os.path.join(dist.location, dist.project_name, "defaults.ini"),
"/path/to/isso.cfg"),
multiprocessing=True)
If you have installed Isso in a virtual environment, then you will have to add the path If you have installed Isso in a virtual environment, then you will have to add the path
of the virtualenv to the site-specific paths of Python: of the virtualenv to the site-specific paths of Python:
.. code-block:: python .. code-block:: python
from __future__ import unicode_literals
import site import site
site.addsitedir("/path/to/isso_virtualenv") site.addsitedir("/path/to/isso_virtualenv")
from isso import make_app import os
from isso.core import Config
application = make_app(Config.load("/path/to/isso.cfg")) from isso import make_app
from isso import dist, config
application = make_app(
config.load(
os.path.join(dist.location, dist.project_name, "defaults.ini"),
"/path/to/isso.cfg",
multiprocessing=True)
Using the aforementioned script will load system modules when available and modules Using the aforementioned script will load system modules when available and modules
from the virtualenv otherwise. Should you want the opposite behavior, where modules from from the virtualenv otherwise. Should you want the opposite behavior, where modules from
@ -127,6 +144,9 @@ the virtualenv have priority over system modules, the following script does the
.. code-block:: python .. code-block:: python
from __future__ import unicode_literals
import os
import site import site
import sys import sys
@ -145,9 +165,13 @@ the virtualenv have priority over system modules, the following script does the
sys.path[:0] = new_sys_path sys.path[:0] = new_sys_path
from isso import make_app from isso import make_app
from isso.core import Config from isso import dist, config
application = make_app(Config.load("/path/to/isso.cfg")) application = make_app(
config.load(
os.path.join(dist.location, dist.project_name, "defaults.ini"),
"/path/to/isso.cfg",
multiprocessing=True)
The last two scripts are based on those given by The last two scripts are based on those given by
`mod_wsgi documentation <https://code.google.com/p/modwsgi/wiki/VirtualEnvironments>`_. `mod_wsgi documentation <https://code.google.com/p/modwsgi/wiki/VirtualEnvironments>`_.