reviewboard

Install and control reviewboard

Scott Wales

saw

9,997 downloads

9,853 latest version

3.4 quality score

Version information

  • 1.0.1 (latest)
  • 1.0.0
released Mar 13th 2014

Start using this module

Documentation

saw/reviewboard — version 1.0.1 Mar 13th 2014

Puppet Reviewboard

Manage an install of Reviewboard

To install include the package 'reviewboard' in your manifest

Optionally you can install the RBtool package for submitting reviews by including 'reviewboard::rbtool'

Pre-Requisites

Puppet module pre-requisites are managed using librarian-puppet

Additionally the following optional prerequisites may be installed:

  • memcached & python-memcached for website caching
  • python bindings for your database (if not installed by the dbprovider)

Usage

Create a reviewboard site based at '/var/www/reviewboard', available at ${::fqdn}/reviewboard:

reviewboard::site {'/var/www/reviewboard':
    vhost    => "${::fqdn}",
    location => '/reviewboard'
}

You can change how the sites are configured with the 'provider' arguments to the reviewboard class.

webprovider:

  • puppetlabs/apache: Use puppetlabs/apache to create an Apache vhost
  • simple: Copy the apache config file generated by reviewboard & set up a basic Apache server
  • none: No web provisioning is done

dbprovider:

  • puppetlabs/postgresql: Use the puppetlabs/postgresql module to create database tables & install bindings
  • none: No DB provisioning is done (note a database is required for the install to work)

The default settings are

class reviewboard {
    webprovider => 'puppetlabs/apache',
    dbprovider  => 'puppetlabs/postgresql'
}

To use a custom web provider set the 'webuser' parameter & subscribe the web service to reviewboard::provider::web<||>:

class reviewboard {
    webprovider => 'none',
    webuser     => 'apache',
}
Reviewboard::Provider::Web<||> ~> Service['apache']

You will then need to manually configure your web server, Reviewboard generates an example Apache config file in ${site}/conf/apache-wsgi.conf.

Other Features

  • RBTool: Reviewboard command-line interface. To install:

     include reviewboard::rbtool
    
  • Trac integration: The traclink Reviewboard plugin posts a notice on a Trac ticket whenever the 'Bug' field is set in a review. To install:

     package {trac: } # Make sure Trac is installed via Puppet
     include reviewboard::traclink
    

    There is also some setup required in your site's trac.ini:

     [ticket-custom]
     reviews = text
     reviews.format = wiki
     [interwiki]
     review = //reviewboard/r/
    

Testing

Integration tests make use of serverspec to check the module is applied properly on a Vagrant VM.

To setup tests

$ gem install bundler
$ bundle install --path vendor/bundle

then to run the tests

$ bundle exec rake

Use vagrant destroy to stop the test VM.