Skip to content

osrf/buildfarm-tools

Repository files navigation

Buildfarm Tools

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

Getting Started

To set up the project locally, please follow the instructions below:

  1. Clone the repository to your local machine.
    git clone https://github.com/osrf/buildfarm-tools.git
  2. Install the dependencies of the project:
    • Ruby Installation
    • Install python requirements: python3 -m pip install -r requirements.txt
  3. Test the scripts
    • You can test your installation by running:
      cd database/scripts
      ./check_buildfarm.rb
    • Wait for the script to run (around 1 minute) and check the buildfarm issues that are happening in the buildfarms
  4. Read Tools usage section for a quickstart or check Buildfarmer Playbook to see all the tools available.

Tools usage

If 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:

FAQ

How can I check if an error is a known issue or a flaky problem?

You can check the Is an error a known issue or a flaky problem? play.

How can I check historical data of a test regression?

You can check the Check historical data of a test regression play.

How can I look for build regression statistics?

You can check the Look for build regression statistics play.

Contributing

Check the CONTRIBUTING.md to get started!

Useful links

Buildfarm links:

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Languages