[ English | English (United Kingdom) | 中文 (简体, 中国) | Indonesia | 한국어 (대한민국) | español (México) | Deutsch ]

Checking Status in Zuul


This section assumes you have completed Using Gerrit.

This section allows you to:

  • Monitor your patches as they get tested by Zuul

  • Understand the underlying infrastructure and gating processes that OpenStack uses

What is Zuul

Zuul is a tool written and run by the OpenStack Infrastructure team that is used to manage running continuous infrastructure jobs. It provides projects with a way to define test jobs that will run on each proposed commit. These tests are required to pass in order for any proposed patch to merge.

When you push a patch to Gerrit Zuul will automatically trigger jobs to verify the patch functions properly.

Tracking Changes in Zuul status page

You can check the status of those jobs at any time by navigating to: https://zuul.openstack.org/


This will show you the status on all jobs running in Zuul currently. You can expand jobs running on any patch by clicking on the box for a patch.


To find your specific patch in Zuul you can use the search bar and search for the patch number. This will then filter what is displayed to just that patch:


Why do changes go first in the check queue?

The OpenStack project uses what’s called a clean check approach. This is designed to keep flaky changes out of the gate. A change always needs to pass the check before it enters the gate. If it fails in the gate, it re-enters the check pipeline.

  • If your change fails in the gate, then there is an increased chance it is introducing non-deterministic failure behavior. Forcing it to go through check again helps make that more apparent.

  • This avoids approving changes that have no hope of ever passing due to pep8 or other trivial errors.

  • It also helps with approving changes that had been sitting around with a 6-month-old passing check.

Changes in the gate pipeline are prioritised but also serialised. If a change fails, all tests for changes behind that failing change have to be restarted. If restarts after restarts happen, then resources are never freed up for the check pipeline.

Therefore, having a stable gate pipeline is crucial and the clean check requirement will help with the stable jobs.