zuul
/
zuul
Code Issues Proposed changes

Merge "docs: add build status documentation"

This commit is contained in:
Zuul 2018-04-16 21:28:36 +00:00 committed by Gerrit Code Review
parent f288b8a345 241dcf7889
commit 35c2059e19
1 changed files with 18 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/source/user/jobs.rst
View File

@ -575,3 +575,21 @@ precedence than any other type of variable in Zuul, so be sure their
names are not shared by any job variables. If more than one parent
job returns the same variable, the value from the later job in the job
graph will take precedence.
.. _build_status:
Build Status
------------
A job build may have the following status:
* SUCCESS/FAILURE: nominal job execution.
* RETRY_LIMIT: the ``pre-run`` playbook failed more than the maximum number of
retry ``attempts``.
* POST_FAILURE: the ``post-run`` playbook failed.
* SKIPPED: one of the build dependencies failed and this job was not executed.
* NODE_FAILURE: the test instance provider was unable to fullfill the nodeset
request.
Note: this can happen if the Nodepool quota is exceeding the provider
capacity, resulting in ERROR server creation: "No valid host found".