Failorama is for building reports from Jenkins builds. There are two types of reports:

1. ISO build report

   These type of reports download data from specified upstream jobs and corresponding downstream jobs. The result is is displayed in html table:

   Upstream job #	Downstream job1 #	Downstream job2 #
   1/PASS	14/FAIL	12/PASS
   2/FAIL	N/A	N/A

2. Staging build reports

   Download information about failed builds from specific jobs and crawl linked LP bugs. For each failed build display: build number, linked bug title, bug status, bug assignee, target projects.

Failorama is built on top of Python, Flask and MySQL.

Make sure following dependencies are installed in your system:

• Python 2.7
• MySQL server (for production)
• SQLite (for testing)

1. Install system requirements:

   $ sudo apt-get install build-essential python-dev python-pip
   $ sudo pip install virtualenv
   $ sudo apt-get intsall libxml2-dev libxslt1-dev
   $ sudo apt-get install mysql-server libmysqlclient-dev

2. Install Python requirements:

   $ pip install -r failorama/requirements.txt

Following command creates database jenkins_reporting and grants full privilegies to user reporting identified by password reporting:

$ mysql -u root -p

mysql> CREATE DATABASE jenkins_reporting;
mysql> GRANT ALL PRIVILEGES ON jenkins_reporting.* TO 'reporting'@'localhost' \
            IDENTIFIED BY 'reporting';
mysql> exit;

First, create configuration file /etc/failorama/failorama.conf:

$ mkdir /etc/failorama
$ touch /etc/failorama/failorama.conf

Here is how your /etc/failorama/failorama.conf might look like:

SQLALCHEMY_DATABASE_URI = "mysql://reporting:reporting@127.0.0.1/jenkins_reporting"
PRODUCT_JENKINS = "http://myjenkins_url:8080"
ISO_VERSIONS = ['2.1', '2.0.1', '1.1.2']
IGNORED_ISO_JOBS = ['deploy_iso_on_cachers']
STAGING_JOBS = [
    '2.1.test_staging_mirror',
    '1.1.test_staging_mirror',
]

$ python manage.py syncdb # Creates database tables if they don't exist

$ python manage.py update-iso # Download upstream ISO and corresponding downstream build jobs statuses and update them in the database

$ python manage.py update-staging # Download staging jobs statuses and update them in the database

$ python manage.py devserver [PORT] # Run development web server instance listening on [PORT]

Apache License Version 2.0 http://www.apache.org/licenses/LICENSE-2.0