Restore an earlier version of a pipeline
Do this when a change to a project's pipeline went wrong and you want the setup it had before. Every save of the pipeline is kept in History, newest first, with who saved it, when, and what it changed.
Who can do this: anyone who may edit the project, on a plan that includes Custom pipelines. The custom pipeline shows in Settings › CI Pipeline only on a project with a repository and its own pipeline. People who can't edit the project see History but no Restore.
- In the sidebar, select Directory, then the Projects tab, and select the project's name.
- In Settings, select CI Pipeline and scroll past the custom pipeline's Save to History. Each row names who saved, when, and lists what that save changed.
- If the save you want isn't listed, select Show more below the list until it is.
- If you have unsaved changes on the tab, select Save or Discard first. Until you do, Restore is greyed out, and hovering it reads Save or discard your changes first.
- Select Restore on the save you want to go back to. The newest row has none: it is what the tab shows now.
- In Restore this save?, select Restore. Stages, steps and freezes return to how that save left them.
- Check History. The restore is a new save at the top, marked · Restored. The saves after the one you restored stay in the list, so you can restore any of them later.
A restore is a save like any other. If a release is running, it keeps the settings it started with, and the restored ones apply from the next run.
Related
- What the stages, steps and freezes are: Set up a project's pipeline.
- How a project's pipeline fits with its repositories and worktrees: How projects work.
- Copy a whole pipeline from a preset or another project instead: Start a pipeline from a preset or another project.