.. django-fab-deploy documentation master file, created by sphinx-quickstart on Fri Feb 4 18:39:09 2011. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. django-fab-deploy documentation =============================== django-fab-deploy is a collection of `fabric`_ scripts for deploying and managing django projects on Debian/Ubuntu servers. Design overview --------------- * django projects are isolated with `virtualenv`_; * requirements are managed using `pip`_; * server interactions are automated and repeatable (the tool is `fabric`_ here); Server software: * Debian Lenny, Debian Squeeze and Ubuntu 10.10 are supported; * the project is deployed with `Apache`_ + `mod_wsgi`_ for backend and `nginx`_ in front as a reverse proxy; Several projects can be deployed on the same VPS using django-fab-deploy. One project can be deployed on several servers. Projects are isolated and deployments are repeatable. .. _virtualenv: http://virtualenv.openplans.org/ .. _pip: http://pip.openplans.org/ .. _fabric: http://fabfile.org/ .. _Apache: http://httpd.apache.org/ .. _mod_wsgi: http://code.google.com/p/modwsgi/ .. _nginx: http://nginx.org/ .. toctree:: :maxdepth: 2 guide customization fabfile reference testing related Make sure you've read the following document if you are upgrading from previous versions of django-fab-deploy: .. toctree:: :maxdepth: 1 CHANGES Bug tracker =========== If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://bitbucket.org/kmike/django-fab-deploy/issues/new Contributing ============ Development of django-fab-deploy happens at Bitbucket: https://bitbucket.org/kmike/django-fab-deploy/ You are highly encouraged to participate in the development of django-fab-deploy. If you don’t like Bitbucket or Mercurial (for some reason) you’re welcome to send regular patches. .. toctree:: :maxdepth: 1 AUTHORS License ======= Licensed under a MIT license. Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search`