summaryrefslogtreecommitdiff
path: root/doc/ci/pipelines/downstream_pipelines.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ci/pipelines/downstream_pipelines.md')
-rw-r--r--doc/ci/pipelines/downstream_pipelines.md16
1 files changed, 10 insertions, 6 deletions
diff --git a/doc/ci/pipelines/downstream_pipelines.md b/doc/ci/pipelines/downstream_pipelines.md
index 6c17c23552d..1ada4c4fac1 100644
--- a/doc/ci/pipelines/downstream_pipelines.md
+++ b/doc/ci/pipelines/downstream_pipelines.md
@@ -244,21 +244,25 @@ To trigger a child pipeline as a [merge request pipeline](merge_request_pipeline
```
1. Configure the child pipeline jobs to run in merge request pipelines with [`rules`](../yaml/index.md#rules)
- or [`workflow:rules`](../yaml/index.md#workflowrules). For example, with `rules`
- in a child pipeline's configuration file:
+ or [`workflow:rules`](../yaml/index.md#workflowrules).
+ For example, with `rules` in a child pipeline's configuration file:
```yaml
job1:
- script: ...
+ script: echo "Child pipeline job 1"
rules:
- - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+ - if: $CI_MERGE_REQUEST_ID
job2:
- script: ...
+ script: echo "Child pipeline job 2"
rules:
- - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+ - if: $CI_MERGE_REQUEST_ID
```
+ In child pipelines, `$CI_PIPELINE_SOURCE` always has a value of `parent_pipeline`
+ and cannot be used to identify merge request pipelines. Use `$CI_MERGE_REQUEST_ID`
+ instead, which is always present in merge request pipelines.
+
### Specify a branch for multi-project pipelines
You can specify the branch to use when triggering a multi-project pipeline. GitLab uses