Nestor Build Light
Nestor Build Light is a CLI for Jenkins build light notifier.
This is handy for monitoring Jenkins build status on a Delcom USB Visual Indicator device.
Installation
npm install -g nestor-buildlight
Usage
Monitor build status and notify build light device:
nestor-buildlight run
Monitor build status of a job:
nestor-buildlight run --job <job>
Monitor build status of a view with custom usbled path:
nestor-buildlight run --view <view> --usbled /sys/bus/usb/drivers/usbled/2-1.5:1.0
For build light with non-RGB colour scheme, specify custom colour scheme:
nestor-buildlight run --scheme red,green,yellow
To customise status-colour map:
nestor-buildlight run --scheme red,blue,yellow --map FAIL=yellow,OK=blue,WARN=red
If your team keeps ignoring failure notifications, you can blink the build light on failure (WARNING: this will annoy your team, and someone will either go berserk or fix the build a.s.a.p):
nestor-buildlight run --blink-on-failure
Configuration
Set Jenkins URL in JENKINS_URL environment variable (defaults to http://localhost:8080):
(*nix)
export JENKINS_URL=http://user:pass@host:port/path
(Windows)
set JENKINS_URL=http://user:pass@host:port/path
As an alternative to password, you can use Jenkins API token instead. Jenkins API token can be found on Jenkins user configuration page.
Colophon
Build reports:
- Code complexity report
- Unit tests report
- Test coverage report
- Integration tests report
- API Documentation
Related Projects:
- nestor - Jenkins CLI and node.js client
- nestor-lifx - CLI for Jenkins LIFX notifier
- nestor-ninjablocks - CLI for Jenkins Ninja Blocks notifier