Skip to content

snu-breeze/event-billing-2016

Repository files navigation

Dance event registration and ticketing app.

https://travis-ci.org/littleweaver/django-brambling.svg?branch=master

Naming

The name of this software is django-brambling. The name for use within the content of the application and for marketing purposes is Dancerfly.

Development

Prerequisites

The installation instructions below assume you have the following software on your machine:

Installation instructions

If you are using virtualenv or virtualenvwrapper, create and activate an environment. E.g.,

mkvirtualenv brambling # Using virtualenvwrapper.

Then, to install:

# Clone django-brambling to a location of your choice.
git clone https://github.com/littleweaver/django-brambling.git

# Install django-brambling.
pip install --no-deps -e django-brambling

# Install python requirements. This may take a while.
pip install -r django-brambling/test_project/requirements.txt

Get it running

cd django-brambling/test_project
python manage.py syncdb    # Create/sync the database.
python manage.py runserver # Run the server!

Then, navigate to http://127.0.0.1:8000/ in your favorite web browser!

Join the chat at https://gitter.im/littleweaver/django-brambling

Deploying to a server

First, set up an ubuntu server on whatever service and set up your ssh config appropriately. Once that's done, install fabric (if you don't have it already): pip install fabric

Then, all you need to do is run fab -H name-of-server deploy:branch-name. This does the following:

  • Installs our server configuration tool, salt, which will handle most of the heavy lifting for you. This only happens if salt isn't installed yet.
  • Syncs your local pillar data with the remote version using rsync.
  • Deploys the specified branch from Github.
  • Runs salt.
  • Runs migrations.
  • Collects static files.

Each of these steps can also be run individually. Run fab with no arguments to see a full list of commands, or check out fabfile.py.