diff options
author | Felix Edel <felix.edel@bmw.de> | 2020-03-04 15:37:28 +0100 |
---|---|---|
committer | Felix Edel <felix.edel@bmw.de> | 2020-05-12 16:48:16 +0200 |
commit | 07cf1e1a6e11181b1abebc35067a9aa20bef4e47 (patch) | |
tree | 3d267d373e0ba4bc70f644d077b8c2c84e74ece0 /doc | |
parent | 98a8ebe8901909cc4f5faba8ec2a21300fb297b9 (diff) | |
download | zuul-07cf1e1a6e11181b1abebc35067a9aa20bef4e47.tar.gz |
Allow check runs to be configured as required status in pipeline config
Although commit checks and statuses can only be retrieved via their
respective APIs, Github does not differentiate between both in terms of
branch protection and in the status section (below the comments of a
PR).
To mimic this behaviour in Zuul, one can now configure a check run as
required status in the pipeline config.
Change-Id: Ia5757c476bcee6082991928ab7c1743d0200d04a
Diffstat (limited to 'doc')
-rw-r--r-- | doc/source/reference/drivers/github.rst | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/source/reference/drivers/github.rst b/doc/source/reference/drivers/github.rst index 474c8ac82..c2c085eca 100644 --- a/doc/source/reference/drivers/github.rst +++ b/doc/source/reference/drivers/github.rst @@ -499,6 +499,21 @@ enqueued into the pipeline. request. The syntax is ``user:status:value``. This can also be a regular expression. + Zuul does not differentiate between a status reported via + status API or via checks API (which is also how Github behaves + in terms of branch protection and `status checks`__). + Thus, the status could be reported by a + :attr:`pipeline.<reporter>.<github source>.status` or a + :attr:`pipeline.<reporter>.<github source>.check`. + + When a status is reported via the status API, Github will add + a ``[bot]`` to the name of the app that reported the status, + resulting in something like ``user[bot]:status:value``. For a + status reported via the checks API, the app's slug will be + used as is. + + .. __: https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-status-checks#types-of-status-checks-on-github + .. attr:: label A string value indicating that the pull request must have the |