Dashbozu User Manual¶
Dashbozu is an integration service of all dashboards of the world!
Supported services are
- Jenkins
- git
- Redmine
- heroku
Requirements¶
- Play 2.0 or later
- PostgreSQL 8 or later
Contents¶
Setup¶
Setup Play 2.0 or later¶
- Documentation: Installing Playframework (http://www.playframework.org/documentation/2.0/Installing)
Setup PostgreSQL¶
Install PostgreSQL by your package system(e.g. homebrew). And type following command:
$ cd /path/to/db
$ initdb .
$ postgres -D .
And type at other terminal:
$ createdb dashbozu
Run Dashbozu¶
Type below commands.
$ play stage
$ target/start -Dconfig.resource=prod.conf
And access [http://localhost:9000](http://localhost:9000)
(Optional) Realtime update¶
Signup(or login) http://pusher.com/ and add new App. And update prod.conf
:
pusher.enable=true
pusher.id=<pusher_id>
pusher.key=<key>
pusher.secret=<secret>
(Optional) Push notification to iPhone¶
Signup(or login) http://boxcar.com and add new service. And update prod.conf
:
boxcar.enable=true
boxcar.key=<key>
boxcar.secret=<secret>
And install boxcar App to your iPhone/iPad.
Install hooks¶
Jenkins¶
Add following command to your job:
curl "http://dashbozu.example.com/hook/jenkins?url=[jenkins url]&project=[project name]"
Git¶
Copy to script to your git repository.
cp $DASHBOZU_HOME/script/gitbozuhook.rb /path/to/gitdir/hooks
And add post-receive
:
#! /bin/sh
read oldrev newrev refname
ruby /path/to/gitdir/hooks/gitbozuhook.rb $oldrev $newrev $refname [dashbozu url]/hook/git
Redmine¶
Install psot script plugin:
$ cd $RAILS_ROOT/vender/plugins
$ git clone git://github.com/suer/redmine_post_script.git
Update $RAILS_ROOT/vender/plugins/redmine_post_script/bin/post_script.rb
:
require 'open-uri'
open("http://dashbozu.example.com/hook/redmine?url=https://example.com/redmine/activity.atom?key=[API key]") {|_|}
Heroku¶
Install deployhook addon:
$ heroku addons:add deployhooks:http --url=http://dashbozu.example.com/hook/heroku