The Gatekeeper, or a project gating system
Go to file
James E. Blair 750ff54717 Add a github graphql query for branch protection
The only way to find out if a branch is locked is by using a graphql
query for branch protection rules.  This change adds a such a query.
Because neither our graphql client nor our fake graphql server fully
implemented pagination, and we expect to routinely have more than 100
branches, this change also handles pagination.

And since this in graphql, it handles nested pagination.

The word "Fake" is removed from the fake graphql server classes because
graphene introspects them to determine their object type names.  Using
their real names makes the object types match which is now important
since one of our new queries specifies an object type.

The github connection class is updated to use this query for protected
branches.  Locking support will come in a future change.

Change-Id: I2633332396b79280984f0ebfa64a955d24fb7bae
2024-05-14 10:53:29 -07:00
doc Refactor branch cache to support more queries 2024-05-14 10:53:27 -07:00
etc Remove "sql connection" backwards compatability for database 2022-01-25 16:07:08 -08:00
playbooks Add an upgrade test 2024-05-14 10:53:22 -07:00
releasenotes/notes gerrit: Add `approval-change` trigger 2024-05-03 15:39:46 -07:00
tests Add a github graphql query for branch protection 2024-05-14 10:53:29 -07:00
tools Add script to generate openapi spec 2024-03-09 11:25:40 -08:00
web Merge "Web UI: substring search for builds, buildsets" 2024-03-27 10:27:49 +00:00
zuul Add a github graphql query for branch protection 2024-05-14 10:53:29 -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 Add noxfile and switch to nox 2022-12-20 08:57:53 -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 Run the upgrade test job 2024-05-14 10:53:24 -07:00
COPYING Update README and add GPL license 2018-03-19 09:25:52 -07:00
Dockerfile Build a new skopeo for the zuul-executor container image 2024-03-21 12:48:32 -07: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 Update README to point to Matrix, not IRC 2022-11-08 22:25:10 -08:00
TESTING.rst Update unit test container setup and instructions 2022-08-05 21:00:02 +00:00
bindep.txt Add python 3.12 testing to Zuul 2024-03-20 09:17:19 -07:00
noxfile.py Add an upgrade test 2024-05-14 10:53:22 -07:00
reno.yaml Add reno configuration settings 2020-07-22 08:45:46 -07:00
requirements.txt Pin kazoo to 2.9.0 2024-02-15 16:18:15 -08:00
setup.cfg Add python 3.12 testing to Zuul 2024-03-20 09:17:19 -07:00
setup.py Partial sync with OpenStack requirements. 2013-09-25 15:30:37 -07:00
test-requirements.txt Add AWS Kinesis support 2023-07-25 11:04:19 -07:00
tox.ini Fix zk host env var for tests 2023-04-05 14:01:08 +02: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 on Matrix <https://matrix.to/#/#zuul:opendev.org>.

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 us on Matrix 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.