ReleaseEngineering/Contribute

This page should help people on how to set themselves up and contribute to Release Engineering.

Introduction

In release engineering we run different types of jobs for developers and releases. When a developer makes a change to the source code we create builds and against those builds we run unit tests and performance tests (a.k.a talos jobs).

To tell the different machines what type of job to run we use buildbot which is installed on the master machines. Those master machines tell the different machines (a.k.a. slaves) which jobs to do.

To make sure that all of our machines are setup the same way we use puppet and OPSI most places.

We also have to make sure that our machines are staying up by installing nagios.

If you want to know more you can go to our documentation page.

Setup a machine to run different jobs

To run a build or a test job we setup our machines with tools like python, mercurial and wget. If you go to the Reference Platforms page you can find the steps taken to set each one of our machines up. The problem right now is that reading the instructions has too much setup work for managing the slaves rather than just getting the jobs to run.

As a way to help people check that their machine can run certain types of jobs we are running this experimental project that gets the packages you need and install it.

Run jobs

How to run a build job

Right now this is not easy for you to discover as the steps followed are intertwined inside of our buildbot custom libraries.

At some point we will have some scripts for you to run on mozharness but until then you can reach the build pages and figure it out there.

How to run a unit test or performance job

Right now this is not easy for you to discover as the steps followed are intertwined inside of our buildbot custom libraries.

At some point we will have some scripts for you to run on mozharness but until then you can read this wiki page.

How to run an L10n repackage

Right now this is not easy for you to discover as the steps followed are intertwined inside of our buildbot custom libraries.

At some point we will have some scripts for you to run on mozharness but until then you can read this wiki page.

Buildbot

Setup a buildbot master

This page is currently the best information we have right now.