Deploy Django with Nginx, uWSGI, Celery, and Supervisor

This is a Fabric script to automatically deploy a Django app with uWSGI and Nginx. It also installs Supervisor and Celery, but feel free to comment those portions out if you're not using them.

I wrote this on Ubuntu 14.04, but it should work on Red Hat and its variants with minimal changes.

Step 1: Install Fabric on your local machine

pip install fabric

Step 2: Install Fabtools on your local machine

pip install fabtools

Step 3: Clone this git repo

git clone https://github.com/rajbala/Deploy-Django-Nginx-uWSGI.git

Step 4: Setup a few paramters in configuration.py with the location of your server, etc. Minimally, you'll need to set the HOSTS constant with location of your deployment target which could be your local machine. You can use your own Django app, but you may need to change the paths if you already have a WSGI file, etc.

Step 5: CD into the directory of the repo you just cloned where fabfile.py is located. Build and deploy.

fab build

The script assumes that you're logging in as the root user intially to get started, but certainly change that if your user is some other user with root privileges.

You'll be prompted a few times for the password of the newly created operating system user. The default password, which is set in configuration.py, is setarealpassword. As the password implies you should really consider setting a real password.

When you run fab build it calls the build() function in fabfile.py which in turn calls a number of other functions to install system packages, creates a user, installs virtualenv, etc.

The majority of your changes should be in configuration.py unless you're deploying on something other than Ubuntu/Debian or perhaps you don't want to install and configure a specific component such as Celery or Supervisor.

Here's a list of everything the script does and configures in order:

• Runs apt-get update
• Creates a new operating system user called django
• Switches execution to this new django user
• Installs the necessary operating system packages with apt-get
• Creates a project path and a static files path
• Clones a git repo containing a Django project
• Creates a pip requirements file
• Installs the requirements in a newly created virtualenv
• Configures a Postgres user, password, and database
• Creates an nginx and uwsgi conf file pointing to the newly cloned Django app
• Creates a WSGI file in the project's directory if one doesn't already exist
• Runs syncdb collectstatic to copy static files into the newly created static files path
• Creates supervisor and celery conf files
• Restarts nginx, uwsgi, and supervisor

When you want to update the server with changes from git simply run fab update_from_git and it will git pull from the repository and restart nginx and uwsgi.