Skip to main content

Implement staging in Fabric and recipes for pelican to [local, s3] and Django to Heroku.

Project description

fab_support - Simple Django Deployment Documentation Status Updates

Making deployment of simple Django projects simple to heroku and dokku with fabric. This implement staging so as to make it trivial to test your code eg

fab build_uat

It supports a local .env file importing for storing secrets that you don’t want to store in git.

See the roadmap for current development.


Stages are the different stages of development of an application. So they might go from:

test → dev → uat → production → old production

Use of staging

Different stages of a single project

I have create a which does the heavy lifting of creating, updating and destroying each environment. The aim is that this should be hardly any more than the use of fabric and much simpler than the use of a full featured build Salt or Ansible. This is really only if you fit one of the use cases. Like Ansible this is a simple single master deployment system, unlike Ansible this is an opinated deployment of Django applications.

Suitable use cases:

  • Simple Django to Heroku where you have at a minimum two stages eg UAT and Production.
    • Copes with Postgres database

    • Static data in AWS

  • Deployment of Pelican static website
    • Deployment to local file system for use with a file server

    • Deployment to local for a file based browser

    • Deployment to S3

In the root fabfile create a dictionary like this which documents how to deploy each stage:

from fabric.api import env

# Definition of different environments to deploy to
env['stages'] = {
    'localsite': {
        'comment': 'stage: For serving locally on this computer via mongoose. ',
        'config_file': '',
        'destination': 'C:/Sites/',
        'copy_method': copy_file,
        'SITEURL': 'http://localhost:8042',
    'production': {
        'comment': 'stage: For serving on local file server',
        'destination': '//',
        'config_file': '',
        'copy_method': copy_file,
        'SITEURL': '',

Then the deployment by Pelican is pretty standardised eg build deploy and you have commands such as:

fab localsite deploy

I think it was inspired by BreytenErnsting. This is then reimplemented using the standard env environment and support in Fabric.

Django configuration

The Django configuration includes the following features:
  • deployment to Heroku

  • Celery support with aqmp

  • Log trapping support with Papertrail


Runs on Windows. If it is getting to complex then it should probably be ported to Ansible or Salt.


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template. Thanks Audrey


0.3.0 (2019-11-12)

This is actually a series of major breaking changes.

  • Changing from requirements.txt to pipenv for managing dependencies

  • Changing from predefined tasks to methods which can be used. The destination eg heroku or dokku is abstracted into the definition of the stage.

  • Implementation of dokku alongside Heroku as a deployment platform

.env to config.json

This change is inspired by zappa which has a configuration file zappa.json. Each environment has mostly the same list of environment variables (obviously with different values). A hierachical data structure is a nice way to store these.

Predefined tasks to methods

The previous methods meant that including tasks created lots of verbiage when you did fab –list In order to simplify the output I am now providing tools that need to be selected for your particular use case.

The abstraction of the destination eg heroku or dokku into the stage is meant to make it really easy to use either platforms in a mixed deployment.

Support for dokku

I have started to use dokku for lower cost. Heroku can still scale to a larger intances.

requirements.txt to pipenv

I am using pipenv quite happily and find it easier to bundle up the dependencies and is quite widely supported eg on PyCharm.

0.2.1 (2018-05-11)

  • Updating pelican commands to the parameter method of passing stage.

Note tests were failing to a non obvious cause. This was Heroku CLI needed updating to the latest version. I manually upgraded.

0.2.0 (2018-04-20)

  • Change the way environment variables are passed through.

In version 0.1 only the following variables were considered env variables:


Now there is an ‘ENV’ list of variables that allows any variables to be passed through and also for them to renamed on the way from the file .env

0.1.0 (2018-02-04)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fab-support-0.3.5.tar.gz (207.3 kB view hashes)

Uploaded Source

Built Distribution

fab_support-0.3.5-py2.py3-none-any.whl (16.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page