Zuul is a tool used to gate source code repositories and only allow changes to be merged if tests pass. It facilitates running tests and automated tasks in response to code changes. Zuul uses a trigger, cloner, launcher and reporter architecture. It integrates with Jenkins using the Gearman plugin to pass parameters between them. Zuul can be run on multi-node infrastructures and bare metal using configuration playbooks and by replacing DevStack scripts. It is used by OpenStack Kolla to deploy OpenStack in Docker containers during gating.

1. Vikram Hosakote
Sr. Software Engineer, Cisco Systems
OpenStack Summit, Austin
April 25 2016
Multi-node ZUUL gate for
bare-metal and Docker

2. Agenda
1. What is Zuul ?
2. Zuul for OpenStack Gating
3. Zuul Architecture
4. Zuul-Jenkins Integration
5. Zuul with multi-node and bare-metal
6. Zuul with Docker containers
7. Q&A

3. What is Zuul ?

4. In the movie
Ghostbusters, Zuul
is the demigod and
gatekeeper of
Gozer, the
destructor.
What is Zuul ?

5. Program used to gate the source code
repository of a project so that changes
are only merged if they pass tests.
What is Zuul ?

6. Zuul for OpenStack Gating

7. • Zuul is a pipeline-oriented project
gating system
• Facilitates running tests and
automated tasks in response to Gerrit
events
Zuul for OpenStack Gating

8. Zuul Architecture

9. • Connections (Gerrit, SMTP)
• Triggers (Gerrit, Timer, Zuul)
• Reporters (Gerrit, SMTP)
• Zuul Cloner
• Launchers (Gearman Jenkins Plugin)
• Statsd reporting (Metrics)
• Zuul Client
Zuul Architecture

12. Zuul-Jenkins Integration

13. • The Gearman Jenkins Plugin makes it easy to use Jenkins
with Zuul by providing an interface between Jenkins and
Gearman
• https://wiki.jenkins-ci.org/display/JENKINS/Gearman+Plugin
• Gearman Plugin passes Zuul Parameters as Jenkins build
parameters.
• http://docs.openstack.org/infra/zuul/launchers.html#zuul-
parameters
Zuul-Jenkins Integration

14. • Example Jenkins Git SCM plugin configuration
Source Code Management:
Git
Repositories:
Repository URL: <your Gerrit or Zuul repository URL>
Advanced:
Refspec: ${Zuul_REF}
Branches to build:
Branch Specifier: ${Zuul_COMMIT}
Advanced:
Clean after checkout: True
Zuul-Jenkins Integration

15. Zuul with multi-node and
bare-metal

16. • Zuul v3 supports multi-node
• Example multi-node playbook
### openstack-infra/zuul-playbooks/zuul-multinode.yaml
---
hosts: controller
roles:
- zuul-controller
---
hosts: compute
roles:
- zuul-compute
Zuul with multi-node and bare-metal

17. • Replace devstack-vm-gate-wrap.sh with bare-metal
orchestration
• https://git.openstack.org/cgit/openstack-infra/devstack-
gate/tree/devstack-vm-gate-wrap.sh
• Can be integrated with OpenStack Ironic
• https://wiki.openstack.org/wiki/Ironic
Zuul with multi-node and bare-metal

18. Zuul with Docker containers

19. OpenStack Kolla deploys OpenStack cloud in Docker
containers in gate using Zuul.
https://wiki.openstack.org/wiki/Kolla
https://github.com/openstack-infra/project-
config/blob/master/jenkins/jobs/kolla.yaml
Zuul with Docker containers

20. https://github.com/openstack-infra/zuul/tree/master
http://status.openstack.org/zuul/
http://docs.openstack.org/infra/zuul/
https://github.com/openstack-infra/project-
config/tree/master
https://jenkins.io
Useful Links

21. Q&A