hubot-gitlab
Hubot Script for providing webhooks for Gitlab
Installation
For this script to take effect first install it with:
npm install --save hubot-gitlab-hooks
For this script to track your system events put this URL in as system hook:
http://<HUBOT_URL>/gitlab/system
For each Repository which should be tracked through the system use this URL as your web hook:
Put http://<HUBOT_URL>/gitlab/web
Configuration
There are different options for configuration:
Via Environment- variables or via query params:
ENV
GITLAB_URL
The URL of your GitLab installation: http://git.example.com/
GITLAB_CHANNEL
The Room to which the gitlab messages get published. Use like this:
For HipChat
GITLAB_CHANNEL="xxxxxx_roomName@conf.hipchat.com"
For Let's Chat
GITLAB_CHANNEL="40b29e6ef217d12b00b8feff,86d1ce6ef217d61b00b8ab12"
GITLAB_DEBUG
Switches on debugging mode. Simply outputs more stuff :)
GITLAB_BRANCHES
Which branches should be pushed to chat.
Note: All push events are pushed to hubot but then the not required ones are discarded. If this is unset, all branch activity in the repo will be pushed to chat.
GITLAB_BRANCHES="master,develop"
GITLAB_SHOW_COMMITS_LIST
If the commits should be listed when code is pushed.
GITLAB_SHOW_COMMITS_LIST=0
GITLAB_SHOW_MERGE_DESCRIPTION
If the the merge request hook should also show the description. Useful for adapters like IRC where long descriptions can spam the channel
GITLAB_SHOW_MERGE_DESCRIPTION=0
Query Params
targets
Same as ENV GITLAB_CHANNEL
?targets=%23room1,%23room2
Sampleurl
http://hubot.mydomain.com/gitlab/web?targets=%23room1,%23room2
branches
?branches=master,develop
Sampleurl
http://hubot.mydomain.com/gitlab/web?branches=develop,master
Contributors
- omribahumi (original author)
- spruce
License
hubot-gitlab-hooks is MIT Licensed.