Skip to content

What Zuul is

Zuul is an open-source CI and gating system that keeps changes in a state where they can be merged. It was born in the development of OpenStack.

What it does

Ordinary CI verifies the change itself. Zuul looks one step ahead: it verifies the state after the change is merged, and merges only the changes that pass. The branch you merge into therefore always stays in a verified state.

  • It receives changes and manages the verification queues
  • It prepares execution environments and runs jobs
  • It collects the results and merges the changes that passed, in order

Where it runs

  • One Zuul can serve many projects and teams (tenants)
  • Changes arrive through the code-review system you already use, such as GitHub or Gerrit
  • Aether Build is built on Zuul. Every check and delivery in this guide runs on top of it