Setup Job-Runner

Note

By default the settings in job_runner.settings.env.development are used. These settings should work out-of-the box for local development (using Sqlite as a database back-end). Use the --settings argument of manage.py to use different settings.

  1. Make sure you have all requirements installed (the exact package names can vary per distribution, these are for Ubuntu).:

    • python-dev
    • virtualenvwrapper
    • build-essential
    • libmysqlclient-dev
  2. Clone the project:

    $ git clone git@github.com:spilgames/job-runner.git
  3. Create a Virtualenv (http://virtualenvwrapper.readthedocs.org/en/latest/), to make sure all requirements are installed in an isolated environment. This is not required, but it will keep your system clean :)

    $ mkvirtualenv job-runner
  4. Install the Job-Runner (which will fetch all Python requirements as well):

    # OPTION 1: Install package in development mode.  Any changes you make
    # will be reflected immediately without having to do an install again.
    $ python setup.py develop
    $ pip install -r test-requirements.txt
    
    # OPTION 2: Just install (you will have to do a new install if you have
    # changed the code).
    $ python setup.py install
  5. Initialize the database and run the migations:

    $ manage.py syncdb
    $ manage.py migrate
    $ manage.py collectstatic
  6. Run manage.py runserver. This will start a development server with the default development settings.

  7. Run manage.py broadcast_queue. This will start the queue broadcaster.

Project Versions

Previous topic

Welcome to Job-Runner’s documentation!

Next topic

Getting started

This Page