The Gatekeeper, or a project gating system
Go to file
James E. Blair 9fe8be43a2 Don't treat failed requirement jobs as ready
When we decide whether it's time to request nodes for a job which
requires something from another build, if the job providing the
requirement has failed, we currently say that our job is ready.
This will cause us to submit a node request which we will never
use.

That's because the act of checking whether the requirement is ready
has the side effect of marking our job as failed (since our
requirement failed).  So the next time we go through the loop,
we'll see that failure and ignore the job from then on (never
accepting or returning the requested nodeset).

This can lead to a leak of nodes due to idle node requests.

This situation is not detected in the tests because we used empty
nodesets for these tests, and so no node requests were made for them.

To correct this, use non-empty nodesets in the relevant tests and
also indicate that the requirements are not ready in the case that
the providing job failed.  This will cause us to skip requesting nodes
in the first iteration of the loop, then the resulting failure state
will avoid that in subsequent iterations.

Change-Id: Ib6e7d81f2c7129b78cdba3957c9f5b46939004db
2021-08-31 14:31:12 -07:00
doc Add delete-state command to delete everything from ZK 2021-08-24 10:07:41 -07:00
etc prometheus: add options to start the server and process collector 2021-04-26 14:47:36 +00:00
playbooks Merge "Always report the build page" 2021-07-16 18:07:58 +00:00
releasenotes/notes Add delete-state command to delete everything from ZK 2021-08-24 10:07:41 -07:00
tests Don't treat failed requirement jobs as ready 2021-08-31 14:31:12 -07:00
tools Add ExistingDataWatch class 2021-07-02 15:22:29 -07:00
web web: LogFile: fix severity toggle buttons 2021-08-25 10:50:06 +10:00
zuul Don't treat failed requirement jobs as ready 2021-08-31 14:31:12 -07:00
.coveragerc Revert "Revert "Switch to stestr"" 2018-05-17 08:33:40 -07:00
.dockerignore Add web/node_modules to dockerignore 2019-01-27 11:23:45 +01:00
.gitignore Use ZooKeeper TLS in tests 2021-03-08 06:49:57 -08:00
.gitreview OpenDev Migration Patch 2019-04-19 19:25:28 +00:00
.mailmap Fix pep8 E127 violations 2012-09-26 14:23:10 +00:00
.stestr.conf Revert "Revert "Switch to stestr"" 2018-05-17 08:33:40 -07:00
.zuul.yaml Increase unit test job timeout to 90 minutes 2021-06-24 13:16:11 -07:00
COPYING Update README and add GPL license 2018-03-19 09:25:52 -07:00
Dockerfile Use node image to build javascript 2021-06-04 16:04:06 +00:00
LICENSE Initial commit. 2012-05-29 14:49:32 -07:00
MANIFEST.in Optimize canMerge using graphql 2020-02-28 09:43:56 +01:00
README.rst Support nodes setting 'auto' python-path 2019-09-19 10:28:53 +10:00
TESTING.rst Docs: fix stestr run example 2020-01-21 10:36:07 +01:00
bindep.txt Update bindep for debian bullseye 2021-08-26 17:10:05 -07:00
reno.yaml Add reno configuration settings 2020-07-22 08:45:46 -07:00
requirements.txt Pin gear < 0.16.0 2021-07-29 12:47:05 -07:00
setup.cfg Merge "Include database requirements by default" 2021-03-09 23:24:34 +00:00
setup.py Partial sync with OpenStack requirements. 2013-09-25 15:30:37 -07:00
test-requirements.txt Optimize canMerge using graphql 2020-02-28 09:43:56 +01:00
tox.ini Prepare for SQLAlchemy 2.0 2021-08-12 12:53:40 -07:00

README.rst

Zuul

Zuul is a project gating system.

The latest documentation for Zuul v3 is published at: https://zuul-ci.org/docs/zuul/

If you are looking for the Edge routing service named Zuul that is related to Netflix, it can be found here: https://github.com/Netflix/zuul

If you are looking for the Javascript testing tool named Zuul, it can be found here: https://github.com/defunctzombie/zuul

Getting Help

There are two Zuul-related mailing lists:

zuul-announce

A low-traffic announcement-only list to which every Zuul operator or power-user should subscribe.

zuul-discuss

General discussion about Zuul, including questions about how to use it, and future development.

You will also find Zuul developers in the #zuul channel on Freenode IRC.

Contributing

To browse the latest code, see: https://opendev.org/zuul/zuul To clone the latest code, use git clone https://opendev.org/zuul/zuul

Bugs are handled at: https://storyboard.openstack.org/#!/project/zuul/zuul

Suspected security vulnerabilities are most appreciated if first reported privately following any of the supported mechanisms described at https://zuul-ci.org/docs/zuul/user/vulnerabilities.html

Code reviews are handled by gerrit at https://review.opendev.org

After creating a Gerrit account, use git review to submit patches. Example:

# Do your commits
$ git review
# Enter your username if prompted

Join #zuul on Freenode to discuss development or usage.

License

Zuul is free software. Most of Zuul is licensed under the Apache License, version 2.0. Some parts of Zuul are licensed under the General Public License, version 3.0. Please see the license headers at the tops of individual source files.

Python Version Support

Zuul requires Python 3. It does not support Python 2.

Since Zuul uses Ansible to drive CI jobs, Zuul can run tests anywhere Ansible can, including Python 2 environments.