diff options
author | Grzegorz Bizon <grzesiek.bizon@gmail.com> | 2018-05-15 15:41:20 +0300 |
---|---|---|
committer | Grzegorz Bizon <grzesiek.bizon@gmail.com> | 2018-05-15 15:51:10 +0300 |
commit | 73aee958e2f4f7428a961c3c63323a7b782599bf (patch) | |
tree | 44e943a871a5f94f455f1c1e3195c6acfde33ada /doc/ci | |
parent | c1377c6cf0647cccd04bc6fb65d745a2e446f827 (diff) |
Add docs on pattern matching syntax in variables expression
Diffstat (limited to 'doc/ci')
-rw-r--r-- | doc/ci/variables/README.md | 7 | ||||
-rw-r--r-- | doc/ci/yaml/README.md | 13 |
2 files changed, 19 insertions, 1 deletions
diff --git a/doc/ci/variables/README.md b/doc/ci/variables/README.md index 42367bf13f7..cbd2ab979f4 100644 --- a/doc/ci/variables/README.md +++ b/doc/ci/variables/README.md @@ -530,6 +530,13 @@ Below you can find supported syntax reference: `$STAGING` value needs to a string, with length higher than zero. Variable that contains only whitespace characters is not an empty variable. +1. Pattern matching _(added in 11.0)_ + + > Example: `$VARIABLE =~ /^content.*/` + + It is possible perform pattern matching against a variable and regular + expression. Expression like this evaluates to truth if matches are found. + ### Unsupported predefined variables Because GitLab evaluates variables before creating jobs, we do not support a diff --git a/doc/ci/yaml/README.md b/doc/ci/yaml/README.md index 2a17a51d7f8..3e77a6f58b7 100644 --- a/doc/ci/yaml/README.md +++ b/doc/ci/yaml/README.md @@ -344,10 +344,11 @@ job: kubernetes: active ``` -Example of using variables expressions: +Examples of using variables expressions: ```yaml deploy: + script: cap staging deploy only: refs: - branches @@ -356,6 +357,16 @@ deploy: - $STAGING ``` +Another use case is exluding jobs depending on a commit message _(added in 11.0)_: + +```yaml +end-to-end: + script: rake test:end-to-end + except: + variables: + - $CI_COMMIT_MESSAGE =~ /skip-end-to-end-tests/ +``` + Learn more about variables expressions on [a separate page][variables-expressions]. ## `tags` |