Deployment

As Pyroutes is a WSGI-based framework, we have several methods of deploying our applications. The most common is to use mod_wsgi and Apache.

Apache2.2 and mod_wsgi

As this web framework is based on WSGI, we’ll use mod_wsgi as our way of deploying our project behind the Apache webserver.

Let’s start by setting up our base requirements (assuming you have pyroutes installed).

Debian based systems:

sudo aptitude install apache2 libapache2-modwsgi
sudo a2enmod wsgi
sudo /etc/init.d/apache2 reload

Other

• Install apache from www.apache.com

• Install mod_wsgi from http://code.google.com/p/modwsgi

• Enable mod_wsgi and restart apache (might be different on your platform):

  sudo a2enmod wsgi
  sudo apache2ctl restart

Once you have that installed we’re going to need a VirtualHost for our project. Use this configuration as an example. More configuration options are available at mod_wsgi’s website.:

<VirtualHost *>
        ServerName example.pyroutes.com
        ServerAdmin klette@pyroutes.com
        DocumentRoot /home/klette/dev/myproject/webroot

        WSGIScriptAlias / /home/klette/dev/myproject/handler.py
</VirtualHost>

The most important line here is the WSGIScriptAlias line. In the example we declare that every path under / should be handled by that python file. When using pyroutes this is the file where you do:

from pyroutes import application

and import all files and modules declaring routes.

If WSGIScriptAlias is set to a different path, e.g. /projects/wiki, Redirect responses starting with a slash are made relative to this path.

That should be about it, and your project should be running smoothly behind apache.