summaryrefslogtreecommitdiff
path: root/doc/ci/yaml/README.md
diff options
context:
space:
mode:
authorJason Roehm <jasonr@3db-labs.com>2016-03-15 09:46:09 -0400
committerJason Roehm <jasonr@3db-labs.com>2016-03-15 09:46:09 -0400
commitb6ede127294fd0df63facb9a65791c018067db9f (patch)
tree41610b2abe1c0aaa8882c8bf98ce4ed024d6a9a3 /doc/ci/yaml/README.md
parent6c1badbd108a12d1217596a3319f9bd3ca7319b8 (diff)
downloadgitlab-ce-b6ede127294fd0df63facb9a65791c018067db9f.tar.gz
add some documentation for `triggers` keyword [ci skip]
Diffstat (limited to 'doc/ci/yaml/README.md')
-rw-r--r--doc/ci/yaml/README.md13
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/ci/yaml/README.md b/doc/ci/yaml/README.md
index 5158e3c387c..510fab7340a 100644
--- a/doc/ci/yaml/README.md
+++ b/doc/ci/yaml/README.md
@@ -286,7 +286,7 @@ There are a few rules that apply to the usage of refs policy:
* `only` and `except` are inclusive. If both `only` and `except` are defined
in a job specification, the ref is filtered by `only` and `except`.
* `only` and `except` allow the use of regular expressions.
-* `only` and `except` allow the use of special keywords: `branches` and `tags`.
+* `only` and `except` allow the use of special keywords: `branches`, `tags`, and `triggers`.
* `only` and `except` allow to specify a repository path to filter jobs for
forks.
@@ -303,6 +303,17 @@ job:
- branches
```
+In this example, `job` will run only for refs that are tagged, or if a build is explicitly requested
+via an API trigger.
+
+```yaml
+job:
+ # use special keywords
+ only:
+ - tags
+ - triggers
+```
+
The repository path can be used to have jobs executed only for the parent
repository and not forks: