djpcms.contrib.jdep

Django module for managing deployment of applications using fabric, virtualenv and pip.

Currently the only server configuration available is nginx + apache with mod_wsgi.

It works on linux servers, no idea about windows.

Requirements

On the developer machine

• fabric
• pip

On the server side

• virtualenv
• pip

Usage

An example on how to use the package is in the examples\djpcms-site directory. The directory structure of your site, which we call greatsite looks like this:

greatsite-project/
  greatsite/
  __init__.py
  requirements.txt
  fabfile.py

The fabfile.py is needed by fabric and should, at least, contain:

from djpcms.contrib.jdep.fabtool import *
utils.project('greatsite','greatsite.com')

The requirement.txt is needed by pip to install your site required pacakges.

Then run:

fab --list

and you will have a list of possible commands. Type:

fab -H your.host.com deploy

to deploy your site.

After deploy hook

There is the possibility of registering function to call once the deployment has been performed. To register a function, your fabfile.py could be:

    from djpcms.contrib.jdep.fabtool import *
utils.project('greatsite','greatsite.com')

def myhook1():
    #do some clever stuff here
    return

utils.after_deploy_hook.append(myhook1)