Deprecate previousStageJobs from GraphQL API

Deprecation Summary

The previousStageJobs field in the GraphQL CiJob type is deprecated and will be removed in GitLab 20.0. No server-side alternative is required. Previous stage jobs can be derived from the pipeline stage data on the client side.

Migration guidelines

No migration is required. The previousStageJobs field returns jobs from the previous pipeline stage for stage-based scheduling. This data can be derived from the pipeline stage data on the client side.

Note: previousStageJobs and needs are fundamentally different concepts. previousStageJobs is for stage-based scheduling, while needs is for DAG-based explicit dependencies. They are not interchangeable.

Background

This is a follow-up from !213750 (merged), which moved the previousStageJobs computation from the backend GraphQL field to the frontend. The field is no longer queried by the GitLab frontend.

Breaking Change?

Yes

Affected Customers

  • GitLab.com
  • Self-managed
  • Dedicated

What pricing tiers are impacted?

  • GitLab Free
  • GitLab Premium
  • GitLab Ultimate

Deprecation Milestone

This deprecation is being announced in milestone: 19.2

Planned Removal Milestone

20.0

Edited by Oleg Yakovenko