Deploying Django on Dokku
This Gist: http://is.gd/dokkudjango
Deploy a Droplet on DigitalOcean
Add an SSH key to DigitalOcean before hand to make SSHing into you new box easier and more secure.
- Click "Create"
- Enter hostname, select size and region
- Select Ubuntu 13.04 x64 as the Image
- Select your SSH key
- Click "Create Droplet"
- Add a blank A Record pointing to the IP Address of your new Droplet
- Add a wildcard (*) A Record pointing to the same domain to capture all of the subdomains.
- SSH into your Droplet. Just
ssh firstname.lastname@example.org work if you add an SSH Key. If not, DigitalOcean emailed you a root password.
- Copy and Paste and oneline installer from the Dokku Repo README. Something like this
wget -qO- https://raw.github.com/progrium/dokku/master/bootstrap.sh | sudo bash
- Wait 5 minutes.
- Associate an SSH key with a git user as the installer instruct you to. Something like this
cat ~/.ssh/id_rsa.pub | ssh email@example.com "gitreceive upload-key alex"
- Add domain to
cd /home/git echo yourdomain.com >> VHOST
Install Dokku Postgres Plugin
Install the Postres Plugin. From inside your Droplet:
cd /var/lib/dokku/plugins git clone https://github.com/Kloadut/dokku-pg-plugin dokku plugins-install
Create a new container which contains Postgres. We are going to deploy our Django app to this container in the future.
dokku postgresql:create myapp
Deploy a Django App
Dokku uses Heroku's BuildPack system for deploying applications. Refer to Heroku's Django Docs to figure out how to prepare your app for deployment. This is mainly concerned with Database connection configuration, WSGI configuration and static file serving.
I made a quick Django base project based on Heroku's documentation. You can get it here
Add a new git remote to your project pointed at your new Postgres container on your Dokku instance then push to it.
git remote add dokku firstname.lastname@example.org:myapp git push dokku master
OMG! You can now visit your app!
Running manage.py commands
This is the only hacky part of the process. From inside your Droplet, lets a terminal session inside our container
docker images # See a listing of all of your docker images docker run -i -t app/myapp /bin/bash # Start an interactive terminal inside of your container
Now we need to bootstrap our terminal session with all of the correct paths and environment variables.
export HOME=/app for file in /app/.profile.d/*; do source $file; done hash -r cd /app # This is the folder where django app got deployed
Now you can run your manage.py commands
python manage.py syncdb