GitLab Documentation

Multi-project pipeline graphs

Introduced in GitLab Enterprise Edition Premium 9.3.

When you set up GitLab CI/CD across multiple projects, you can visualize the entire pipeline, including all multi-project stages.

Overview

GitLab CI/CD is a powerful continuous integration tool built-in GitLab. GitLab CI works not only per project, but also across projects. When you configure GitLab CI for your project, you can visualize the stages of your jobs on a chart called pipeline graph.

Multi-project pipeline graph

For areas where the pipeline mini-graph is present, when hovering or clicking (mobile) they will expand and be shown next to each other.

Multi-project mini graph

Multi-project pipeline graphs are useful for larger projects, especially those adopting a microservices architecture, that often have a set of interdependent components which form the complete product.

Use cases

Let's assume you deploy your web app from different projects in GitLab:

With Multi-Project Pipeline Graphs, you can visualize the entire pipeline in a beautiful and clear chart, including all stages of builds and tests for the three projects.

How it works

Using the CI_JOB_TOKEN when triggering pipelines, GitLab recognizes the source of the job token, and thus internally ties these pipelines together which makes it easy to start visualizing their relationships.

Those relationships are displayed in the pipeline graph by showing inbound and outbound connections for upstream and downstream pipeline dependencies.