bamboo-status-svg

A library and/or service that produces SVG badges for Bamboo build plans.

Example

As a Library

bamboo-status-svg is available in the NPM registry: (bamboo-status-svg).

Example library usage:

var status = require('bamboo-status-svg');
var options = {
    bamboo : 'https://bamboo.asterisk.org',
    port : 3001
};
 
status.start(options, function(err) {
    console.log('Running.');
});

Configuration Options:
bamboo
The bamboo instance URL to connect to.
Example: https://bamboo.example.org/

port
The port to start the server on.
Defaults to the PORT environment variable.

index
If true, requests for / return a JSON description

As a Service

Out of the box, you can run bamboo-status-svg as a standalone service:

# get the code: 
git clone [e-mail]:developit/bamboo-status-svg.git
cd bamboo-status-svg
 
# install dependencies 
npm install
 
# run the server 
PORT=8080 BAMBOO=bamboo.example.org npm start

Supported Environment Variables:
BAMBOO
The bamboo instance URL to connect to. Example: bamboo.example.org

PORT
The port to start the server on.

INDEX
If true, requests for / return a JSON description

Deploy

You can easily deploy bamboo-status-svg as an app without modifying it at all.

# get the code: 
git clone [e-mail]:developit/bamboo-status-svg.git
cd bamboo-status-svg
 
# set up a heroku app: 
heroku login
heroku create
 
# Configure the bamboo instance to point to 
heroku config:set BAMBOO=bamboo.example.org
 
# Deploy 
git push heroku master

Status Image URLs

Once running/deployed, you can get a Bamboo plan status image by passing the required information in the URL like:
http://HOST:PORT/status/[PLAN_NAME]
Example:
http://bamboo-status-svg.herokuapp.com/status/BAM-BO0

Tip: Check Travis-CI's documentation on status images for placing these badges into a README.

Credits

bamboo-status-svg was originally based on bamboo-status, by Christophe Hamerling.

License

MIT