Overspill.io

List overflow talks for conferences

Getting started

To run the site locally:

If you haven't already, install Vagrant and Ansible on your system
Clone the repo to a directory on your desktop
From that directory, run vagrant up
To run the development server, type ./devserver
Visit http://192.168.60.110:8000/ in your browser

Running management commands

You can run management commands on behalf of the web console by simply typing ./run <command> <args>. The command name and args are piped through Vagrant's SSH utility to the project's manage.py file, via a shortcut script that is pre-loaded with all the necessary environment variables and the settings file.

This makes it ideal for things like generating schema migrations:

./run makemigrations

Thing is, I suck at Unix, so you can't put more than one argument after ~/run at the moment.

Running tests

The development servers are spun up with testing in-place, and there's a shortcut function for testing the apps within Overspill. From the project directory, just run ./test <app-name> and the tests should run; you should also get a coverage.py report back.

To run the site remotely:

Create 3 DigitalOcean droplets: one for web, one for the database, and one for the worker
Copy provisioning/digitalocean.sample to provisioning/digitalocean
Replace the IP addresses with the ones you setup in step 1