Service Shields

License

MPL 2.0

OpenMRS Shields

A tool that uses Shields.io to generate badges for the status of OpenMRS Bamboo plans.

Technical Details

Repository: openmrs-contrib-shields

A node-based application that uses Shields.io badges to easily generate badges for OpenMRS Bamboo plans. The repo is automatically built into a docker container on any commit and this is used by OpenMRS infrastructure to host at shields.openmrs.org.

Testing

You can test if shields is working with a call like https://shields.openmrs.org/plan/TRUNK/MASTER (should display a small graphical box with status of TRUNK plan build).

Troubleshooting

Shields are grey and show status unknown

This is happening all too frequently. The underlying node-based bamboo-api library is old and depends on a deprecated request library (also used by shields directly) that occasionally will begin failing and return all requests as unreachable even when the specific URLs are still reachable from inside the container. Until the shields app is updated, this will continue to happen. It can be fixed by restarting the shields container.

sudo docker restart $(sudo docker ps -f name=shields -q)