Commit 36b9cc3f authored by Achilleas Pipinellis's avatar Achilleas Pipinellis

Add allow_failure CI documentation

parent 479814b2
...@@ -13,34 +13,36 @@ If you want a quick introduction to GitLab CI, follow our ...@@ -13,34 +13,36 @@ If you want a quick introduction to GitLab CI, follow our
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)* **Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
- [.gitlab-ci.yml](#gitlab-ci-yml) - [.gitlab-ci.yml](#gitlab-ci-yml)
- [image and services](#image-and-services) - [image and services](#image-and-services)
- [before_script](#before_script) - [before_script](#before_script)
- [after_script](#after_script) - [after_script](#after_script)
- [stages](#stages) - [stages](#stages)
- [types](#types) - [types](#types)
- [variables](#variables) - [variables](#variables)
- [cache](#cache) - [cache](#cache)
- [cache:key](#cache-key) - [cache:key](#cache-key)
- [Jobs](#jobs) - [Jobs](#jobs)
- [script](#script) - [script](#script)
- [stage](#stage) - [stage](#stage)
- [only and except](#only-and-except) - [only and except](#only-and-except)
- [job variables](#job-variables) - [job variables](#job-variables)
- [tags](#tags) - [tags](#tags)
- [when](#when) - [allow_failure](#allow_failure)
- [environment](#environment) - [when](#when)
- [artifacts](#artifacts) - [Manual actions](#manual-actions)
- [artifacts:name](#artifactsname) - [environment](#environment)
- [artifacts:when](#artifactswhen) - [artifacts](#artifacts)
- [artifacts:expire_in](#artifactsexpire_in) - [artifacts:name](#artifacts-name)
- [dependencies](#dependencies) - [artifacts:when](#artifacts-when)
- [before_script and after_script](#before_script-and-after_script) - [artifacts:expire_in](#artifacts-expire_in)
- [dependencies](#dependencies)
- [before_script and after_script](#before_script-and-after_script)
- [Git Strategy](#git-strategy) - [Git Strategy](#git-strategy)
- [Shallow cloning](#shallow-cloning) - [Shallow cloning](#shallow-cloning)
- [Hidden jobs](#hidden-jobs) - [Hidden jobs](#hidden-jobs)
- [Special YAML features](#special-yaml-features) - [Special YAML features](#special-yaml-features)
- [Anchors](#anchors) - [Anchors](#anchors)
- [Validate the .gitlab-ci.yml](#validate-the-gitlab-ciyml) - [Validate the .gitlab-ci.yml](#validate-the-gitlab-ci-yml)
- [Skipping builds](#skipping-builds) - [Skipping builds](#skipping-builds)
- [Examples](#examples) - [Examples](#examples)
...@@ -473,6 +475,39 @@ job: ...@@ -473,6 +475,39 @@ job:
The specification above, will make sure that `job` is built by a Runner that The specification above, will make sure that `job` is built by a Runner that
has both `ruby` AND `postgres` tags defined. has both `ruby` AND `postgres` tags defined.
### allow_failure
`allow_failure` is used when you want to allow a build to fail without impacting
the rest of the CI suite. Failed builds don't contribute to the commit status.
When enabled and the build fails, the pipeline will be successful/green for all
intents and purposes, but a "CI build passed with warnings" message will be
displayed on the merge request or commit or build page. This is to be used by
builds that are allowed to fail, but where failure indicates some other (manual)
steps should be taken elsewhere.
In the example below, `job1` and `job2` will run in parallel, but if `job1`
fails, it will not stop the next stage from running, since it's marked with
`allow_failure: true`:
```yaml
job1:
stage: test
script:
- execute_script_that_will_fail
allow_failure: true
job2:
stage: test
script:
- execute_script_that_will_succeed
job3:
stage: deploy
script:
- deploy_to_staging
```
### when ### when
`when` is used to implement jobs that are run in case of failure or despite the `when` is used to implement jobs that are run in case of failure or despite the
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment