Trigger a downstream multi-project GitLab CI pipeline and block on its result using strategy depend

domain: docs.gitlab.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. In the upstream .gitlab-ci.yml, add a trigger job: `trigger: project: <GROUP>/<DOWNSTREAM_PROJECT>` (optionally add `branch: <REF>` to target a specific branch or tag).
  2. Add `strategy: mirror` (GitLab's current recommendation) or the older `strategy: depend` under `trigger:` so the trigger job blocks until the downstream pipeline finishes and reflects its final status, instead of passing as soon as the downstream pipeline is created.
  3. Confirm the user or token triggering the upstream pipeline can start pipelines in the downstream project, and add the downstream project to the upstream project's job token scope allowlist if using CI_JOB_TOKEN.
  4. To pull artifacts back from the downstream pipeline in a later job, use `needs: - project: <GROUP>/<DOWNSTREAM_PROJECT> job: <JOB_NAME> ref: <REF> artifacts: true`.
  5. Gate downstream-only job behavior with `rules: - if: $CI_PIPELINE_SOURCE == "pipeline"`, since multi-project pipelines set CI_PIPELINE_SOURCE to "pipeline" (parent-child pipelines use "parent_pipeline" instead).

Known gotchas

Related routes

Configure GitLab CI parent-child pipelines where a parent pipeline dynamically generates a child pipeline YAML based on changed paths and triggers it with the artifact strategy
GitLab CI · 6 steps · unrated
Trigger a GitLab pipeline via pipeline trigger token API
docs.gitlab.com · 5 steps · unrated
Implement a GitLab CI pipeline with dynamic child pipelines generated from changed paths using rules and the artifact strategy
docs.gitlab.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans