django-fab-deploy

django-fab-deploy is intended to be an easy deployment and management solution for Django projects using Mercurial, fabric, virtualenv, nginx, pip and apache with mod_wsgi. The supported OS is Debian Lenny.

This software is very opinionated. It is a collection of fabric scripts that work well together for my projects.

Several projects can be deployed on the same VPS using django-fab-deploy. One project can be deployed on several servers. Projects are isolated with virtualenv.

Please don't use OpenVZ or Virtuozzo VPS's for deployment! Use XEN or KVM or real servers instead. OpenVZ has very serious issues with memory management (VIRT is counted and limited instead of RSS or something) so apache (and a lot of other software like mysql's InnoDB engine) is totally unusable on OpenVZ while being memory-wise and performant on XEN.

Documentation: http://pypi.python.org/pypi/django-fab-deploy/

What is new in this release:

• root_password argument for mysql_create_db (thanks Michael Brown).

What is new in version 0.7.4:

• django-fab-deploy now is compatible with fabric 1.4 (and require fabric 1.4);
• nginx and wsgi scripts are now compatible with upcoming django 1.4; example of django 1.4 project configuration is added to guide;
• shortcut for passing env defaults in define_host decorator;
• Ubuntu 10.04 apache restarting fix;
• config_templates/hgrc is removed;
• tests are updated for fabtest >= 0.1;
• apache_is_running function.

What is new in version 0.7.3:

• permanent redirect from www.domain.com to domain.com is added to the default nginx config. Previously they were both available and this leads to e.g. authorization issues (user logged in at www.domain.com was not logged in at domain.com with default django settings regarding cookie domain).

What is new in version 0.7.2:

• Ubuntu 10.04 (lucid) initial support (this needs more testing);
• backports for Ubuntu 10.04 and 10.10;
• docs are now using default theme;
• remote django management command errors are no longer silinced;
• invoking create_linux_account with non-default username is fixed;
• define_host decorator for easier host definition;
• default DB_USER value ('root') is deprecated;
• default nginx config uses INSTANCE_NAME for logs.
• In order to upgrade please set DB_USER to 'root' explicitly in env.conf if it was omitted.

What is new in version 0.7.1:

• DB_ROOT_PASSWORD handling is fixed

What is new in version 0.6.1:

• verify_exists argument of fab_deploy.utils.upload_config_template function was renamed to skip_unexistent;
• fab_deploy.utils.upload_config_template now passes all extra kwargs directly to fabric's upload_template (thanks Vladimir Mihailenco);
• fab_deploy.virtualenv.pip_setup_conf command for uploading pip.conf (thanks Vladimir Mihailenco);
• fab_deploy.deploy.push no longer calls 'synccompress' management command;
• fab_deploy.deploy.push accepts 'before_restart' keyword argument - that's a callable that will be executed just before code reload;
• fixed regression in fab_deploy.deploy.push command: 'notest' argument was incorrectly renamed to 'test';
• customization docs are added.

Requirements:

• Python
• Django
• Jinja2
• South is used for migrations
• Debian Lenny server or VPS with ssh access. I don't have other servers so e.g. Ubuntu is untested but it will possibly work with some small changes.
• Optional: django-compress is used for css and js bundling
• Fabric
• Your project is stored in Mercurial repository