README.txt
author Dustin J. Mitchell <dustin@mozilla.com>
Wed, 22 Jan 2014 08:36:59 -0500
changeset 232 03dce877d18892baeecdf200da1785a12488412e
parent 224 b60098b51361bce2671dcdf5f12fae68ce8b6545
child 233 909150ceda8f89d1d27e9659cb02816a3719c8f2
permissions -rw-r--r--
Bug 957385: memcached requires keys be bytestrings; r=catlee

Installation and Setup
======================

Install ``buildapi`` using easy_install::

    easy_install buildapi

Then install either redis or memcached:

    easy_install redis
    easy_install python-memcached

Make a config file as follows::

    paster make-config buildapi config.ini

Tweak the config file as appropriate::

    email_to = your email
    port = something available, eg. 6005
    update the sqlalchemy db urls and the carrot info as needed for staging/dev
    # add the following lines to have your url be http://cruncher.build.mozilla.org/~(username)/wsgi
    [filter:proxy-prefix]
    use = egg:PasteDeploy#prefix
    prefix = /~(username)/wsgi

Also set up your cache configuration:

    buildapi.cache = redis:HOSTNAME:PORT

or

    buildapi.cache = memcached:HOSTNAME:PORT,HOSTNAME:PORT,..

Now setup the application::

    paster setup-app config.ini

Edit your config.ini to add to the [app:main] section::

    filter-with = proxy-prefix

Now you can start/stop your application::

    paster serve --daemon config.ini
    paster serve --stop-daemon

You should be able to load pages like http://cruncher.build.mozilla.org/~(username)/wsgi/self-serve

Installing google viz::

    wget http://google-visualization-python.googlecode.com/files/gviz_api_py-1.7.0.tar.gz
    tar -xvf gviz_api_py-1.7.0.tar.gz
    cd gviz_api_py-1.7.0
    python setup.py install
    python setup.py test

Now you should be able to see reports like http://cruncher.build.mozilla.org/~(username)/wsgi/reports/pushes
which use the google visualization library (make sure you have the statusdb set in your config.ini