Added description of artifacts:when
This commit is contained in:
parent
ffe8dbde9b
commit
897bc59761
|
@ -30,6 +30,7 @@ If you want a quick introduction to GitLab CI, follow our
|
||||||
- [when](#when)
|
- [when](#when)
|
||||||
- [artifacts](#artifacts)
|
- [artifacts](#artifacts)
|
||||||
- [artifacts:name](#artifacts-name)
|
- [artifacts:name](#artifacts-name)
|
||||||
|
- [artifacts:when](#artifacts-when)
|
||||||
- [dependencies](#dependencies)
|
- [dependencies](#dependencies)
|
||||||
- [before_script and after_script](#before_script-and-after_script)
|
- [before_script and after_script](#before_script-and-after_script)
|
||||||
- [Hidden jobs](#hidden-jobs)
|
- [Hidden jobs](#hidden-jobs)
|
||||||
|
@ -651,6 +652,32 @@ job:
|
||||||
untracked: true
|
untracked: true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
#### artifacts:when
|
||||||
|
|
||||||
|
>**Note:**
|
||||||
|
Introduced in GitLab 8.9 and GitLab Runner v1.3.0.
|
||||||
|
|
||||||
|
`artifacts:when` is used to upload artifacts on build failure or despite the
|
||||||
|
failure.
|
||||||
|
|
||||||
|
`artifacts:when` can be set to one of the following values:
|
||||||
|
|
||||||
|
1. `on_success` - upload artifacts only when build succeeds. This is the default
|
||||||
|
1. `on_failure` - upload artifacts only when build fails
|
||||||
|
1. `always` - upload artifacts despite the build status
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**Example configurations**
|
||||||
|
|
||||||
|
To upload artifacts only when build fails
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
job:
|
||||||
|
artifacts:
|
||||||
|
when: on_failure
|
||||||
|
```
|
||||||
|
|
||||||
### dependencies
|
### dependencies
|
||||||
|
|
||||||
>**Note:**
|
>**Note:**
|
||||||
|
|
Loading…
Reference in New Issue