summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMayra Cabrera <mcabrera@gitlab.com>2018-04-13 08:05:41 +0000
committerAchilleas Pipinellis <axil@gitlab.com>2018-04-13 08:05:41 +0000
commit3bd5d53181cbda3ae3f3b6390c372bc13f71fedb (patch)
treea4a8414be52479ec2df961b6c43cc38dedbd53fa /doc
parent46302c8c7def714a5bc45e19c53680eb8ff51952 (diff)
downloadgitlab-ce-3bd5d53181cbda3ae3f3b6390c372bc13f71fedb.tar.gz
Add missing documentation about failure reason
Diffstat (limited to 'doc')
-rw-r--r--doc/ci/img/job_failure_reason.pngbin0 -> 5346 bytes
-rw-r--r--doc/ci/pipelines.md16
2 files changed, 16 insertions, 0 deletions
diff --git a/doc/ci/img/job_failure_reason.png b/doc/ci/img/job_failure_reason.png
new file mode 100644
index 00000000000..a60ce1fb21c
--- /dev/null
+++ b/doc/ci/img/job_failure_reason.png
Binary files differ
diff --git a/doc/ci/pipelines.md b/doc/ci/pipelines.md
index 301cccc80a3..f14e0527998 100644
--- a/doc/ci/pipelines.md
+++ b/doc/ci/pipelines.md
@@ -73,6 +73,21 @@ cancel the job, retry it, or erase the job trace.
![Pipelines example](img/pipelines.png)
+## Seeing the failure reason for jobs
+
+> [Introduced][ce-5742] in GitLab 10.7.
+
+When a pipeline fails or is allowed to fail, there are several places where you
+can quickly check the reason it failed:
+
+- **In the pipeline graph** present on the pipeline detail view.
+- **In the pipeline widgets** present in the merge requests and commit pages.
+- **In the job views** present in the global and detailed views of a job.
+
+In any case, if you hover over the failed job you can see the reason it failed.
+
+![Pipeline detail](img/job_failure_reason.png)
+
## Pipeline graphs
> [Introduced][ce-5742] in GitLab 8.11.
@@ -263,4 +278,5 @@ runners will not use regular runners, they must be tagged accordingly.
[ce-6242]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/6242
[ce-7931]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/7931
[ce-9760]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9760
+[ce-17782]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/17782
[regexp]: https://gitlab.com/gitlab-org/gitlab-ce/blob/2f3dc314f42dbd79813e6251792853bc231e69dd/app/models/commit_status.rb#L99