Notifies about Jenkins build errors via Jenkins Notification Plugin
- Install the module:
npm install --save hubot-jenkins-notifier
- Add it
hubot-jenkins-notifier
to your external-scripts.json file in your hubot directory - Add hubot's endpoint to jenkins jobs: (see Screenshot)
- Configure it to be JSON, HTTP and either "All events", "Job started" or "Job finalized". "Job completed" will be ignored.
- To send to a room:
http://<hubot-host>:<hubot-port>/hubot/jenkins-notify?room=<room>
- To send to a user:
http://<hubot-host>:<hubot-port>/hubot/jenkins-notify?user=<username>
- Add log lines if you want to
As url parameters the following can be used:
room
: The room name to send the message to. Mutually exlusive withuser
user
: The user name to send the private message to. Mutually exlusive withroom
onStart
/onFinished
: ** Notification strategy: [Ff][Ss] which stands for "Failure" and "Success". ** Capitalized letter means: notify always. ** Small letter means: notify only if buildstatus has changed ** Default: onStart=, onFinished=Fstrace
: add a bunch of runtime console.log's
Environment variable:
- JENKINS_NOTIFIER_TRACE: set this environment variable to 1 to enable tracing for diagnostics
1.1.0 - 2017-04-25
- Treat unstable as failure - #19
1.0.0 - 2016-10-07
- Added parameter
user
,trace
- Updated documentation to reflect changes in jenkins notification plugin
- Big rewrite, clearer testing, code, etc
0.1.5 - 2014-09-18
- Tweak configs to work with newer versions of npm / fix for travis-ci
- Support jenkins 1.577 (Now passes FINALIZED instead of FINISHED) - Jenkins Notifier Commit
0.1.4 - 2014-02-23
- Brought in recent changes from github/hubot-scripts
- Upgraded json parsing to handle/fail gracefully
- Handle jenkins not providing full url (for now not handled well, but better than undefined)
- Added screenshots to configuration
0.1.3 - 2013-08-05
- support hubot-irc adapter
0.1.2 - 2013-07-23
- allow
always_notify=1
cgi parameter to always notify a room even on success
0.1.1 - 2013-07-22
- Fixed up .npmignore file so the proper files were being packaged up
0.1.0 - Initial Release - 2013-07-20
- Based heavily on the github/hubot-scripts version which broke in our infrastructure
Copyright (c) 2013 Gavin Mogan Licensed under the MIT license.