Build Light 
Build Light is a daemon, designed to run on single-board/development-board computers, that regularly polls your continuous integration server and reports build status through GPIO connected devices. It is primarily intended to control a modified traffic light through a relay module although it can also control LEDs connected directly to your board.
- Red - One or more builds has failed.
- Yellow - One or more jobs is currently building.
- Green - All jobs have successful builds.
Supported Environments
Build Light is known to work with the following software and hardware:
Continuous Integration Servers
Hardware
Operating Systems
Installation & Usage
Installation
Installation is managed through npm:
npm install build-light -gConfiguration
Configuration is controlled through environment variables (following the twelve-factor methodology). You should adjust the following environment variables to meet your needs:
Continuous Integration Server
| Variable | Description | Default Value |
|---|---|---|
JENKINS_BASE_URL |
The base URL of your Jenkins CI server. | https://builds.apache.org |
CHECK_INTERVAL |
The polling interval, in seconds. | 900 (15 minutes) |
GPIO Pin Wiring
You can configure which GPIO pins control each color light for your setup. (The default values have been selected for easy wiring on a Raspberry Pi Rev. 2.)
| Variable | Description | Default Value |
|---|---|---|
PIN_NUMBER_RED |
The GPIO pin that will be used to control the red light. | 17 |
PIN_NUMBER_YELLOW |
The GPIO pin that will be used to control the yellow light. | 27 |
PIN_NUMBER_GREEN |
The GPIO pin that will be used to control the green light. | 22 |
Pin On/Off Values
The default configuration for GPIO pin on/off values is designed to work with an active low relay card. If you are using LEDs or an active high relay you may wish to change these values:
| Variable | Description | Default Value |
|---|---|---|
PIN_VALUE_ON |
The value that will be output to GPIO pins to turn a light on. | 0 |
PIN_VALUE_OFF |
The value that will be output to GPIO pins to turn a light off. | 1 |
Usage
Once installed and configured, build-light can be run as follows:
build-lightIf you would like to run without global environment variables (or to override global variables) you can use env to run with a modified environment:
env JENKINS_BASE_URL=https://ci.example.com CHECK_INTERVAL=5 build-lightOn supported operating systems, you can use the systemd service manager to setup the environment, manage when the application is started, and monitor the process to keep it running. This can be done with a system file like the one below:
[Unit]Description=Toolhouse Build Light [Service]ExecStart=/usr/bin/build-lightRestart=alwaysUser=rootStandardOutput=syslogStandardError=syslogSyslogIdentifier=build-lightEnvironment=JENKINS_BASE_URL=https://ci.example.comEnvironment=CHECK_INTERVAL=5 [Install]WantedBy=multi-user.targetIn the wild
The following build-light installation at Toolhouse is used to monitor
approximately 30 different projects at any given time:
