Welcome to the Buildfarm Tools Repository!
The buildfarmer team is in charge of maintaining build results on the ROS and Gazebo buildfarms. You can look at the dashboards to inspect the status of all tracked jobs:
This repo contains all the tools to get information from the ROS and Gazebo buildfarms.
Note If you're interested in what tools we have available and how to use them, check the Tools usage section
To set up the project locally, please follow the instructions below:
git clone https://github.com/osrf/buildfarm-tools.gitpython3 -m pip install -r requirements.txtcd database/scripts
./check_buildfarm.rbIf you are a ROS or Gazebo developer interested in getting information about errors you're getting in CI or if you want to gather statistics of tests and errors in the buildfarms you can check the FAQ section.
Remember that the buildfarmer database is open to anyone who wants to inspect it (binary file: buildfarmer.db). You can use SQLite Browser to run personalized queries and filters.
If you are a buildfarmer team member, or you are interested in learning how we triage buildfarm issues and use these tools, you can check our workflow in the Buildfarmer Playbook:
You can check the Is an error a known issue or a flaky problem? play.
You can check the Check historical data of a test regression play.
You can check the Look for build regression statistics play.
Check the CONTRIBUTING.md to get started!