Deploying to heroku

in five ten minutes

Brenton Cleeland
@sesh // brntn.me

Why Heroku?

  • Cheap during development and testing (reasonable after that)
  • Quick and easy to get started
  • Scales really well
  • git based workflow
  • Release management and rollback

Packages We'll Use

  • Heroku Toolkit
  • dj-database-url
  • whitenoise
  • gunicorn
  • Django
  • (virtualenv)
  • (gibo)

Heroku toolkit

> heroku --help

Usage: heroku COMMAND [--app APP] [command-specific-options]

Primary help topics, type "heroku help TOPIC" for more details:

  addons    #  manage addon resources
  apps      #  manage apps (create, destroy)
  auth      #  authentication (login, logout)
  config    #  manage app config vars
  domains   #  manage custom domains
  logs      #  display logs for an app
  ps        #  manage dynos (dynos, workers)
  releases  #  manage app releases
  run       #  run one-off commands (console, rake)
  sharing   #  manage collaborators on an app

https://toolbelt.heroku.com/

Configuring: dj-database-url

# settings.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
    }
}

import dj_database_url
DATABASES = {
    'default': dj_database_url.config(default='sqlite:///{}'.format(
        DATABASES['default']['NAME'])
    )
}

https://github.com/kennethreitz/dj-database-url

Configuring: whitenoise

# wsgi.py

from django.core.wsgi import get_wsgi_application
from whitenoise.django import DjangoWhiteNoise

application = DjangoWhiteNoise(get_wsgi_application())
# settings.py

STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

https://github.com/evansd/whitenoise

Configuring: gunicorn

# Procfile

web: gunicorn melbdjangoheroku.wsgi --log-file -

http://gunicorn.org

Configuring: django

# settings.py

DEBUG = os.uname()[0] == 'Darwin'
TEMPLATE_DEBUG = DEBUG

ALLOWED_HOSTS = ['.herokuapp.com']

Configuring: requirements.txt

# requirements.txt

Django==1.7.4
dj-database-url==0.3.0
gunicorn==19.2.1
whitenoise==1.0.6
psycopg2==2.6

http://slides.com/brntn/managing-your-django-requirements/#/

Actually deploying

  • Commit your configuration
  • run heroku create
  • git push heroku master
  • heroku looks after:
    • installing (and removing) requirements
    • collectstatic
  • heroku run python manage.py migrate
  • heroku run python manage.py createsuperuser

HANDY LINKS

  • Django deployment checklist: https://docs.djangoproject.com/en/1.7/howto/deployment/checklist/
     
  • Heroku Django template:
    https://github.com/heroku/heroku-django-template

Deploying to heroku in 5 minutes

By Brenton Cleeland

Deploying to heroku in 5 minutes

  • 986
Loading comments...

More from Brenton Cleeland