Skip to main content

Rebuilding a failed Pipeline

When a Pipeline build fails you have two options:

Rebuilding unsuccessful Workflows

When you have a failed or aborted Workflow in your Pipeline build, you can opt to modify that failed or aborted Workflow and rebuild it and subsequent Workflows without the need to rebuild your entire Pipeline. The new attempt will start from the first failed or aborted Workflow. If that Workflow is successful this time, the build will continue with subsequent Workflows.

Stages with always run enabled

This new attempt will trigger a Stage with always run enabled again, if that stage comes after the first failed or aborted Workflow of a Pipeline.

rebuild_always_run.png

This can be great if you have one or more failed or aborted Workflows in your Pipeline and you don’t want to rebuild the entire Pipeline.

These are examples of how you can modify your Workflows in a Pipeline build:

  • Add a new Step to a Workflow.

  • Remove a Step from a Workflow.

  • Update a Step in a Workflow.

  • Change Step input orders in a Workflow.

  • Change Step orders in a Workflow.

Rebuilding unsuccessful Workflows in a Pipeline build

You can use the Rebuild unsuccessful Workflows action to partially rebuild a Pipeline.

To use the Rebuild unsuccessful Workflows action:

  1. Open your app on Bitrise.

  2. Select the Pipeline build you would like to rebuild.

  3. On the top right, click on the Rebuild drop-down menu.

  4. Select Rebuild unsuccessful Workflows.

    Rebuild unsuccessful Workflows action limitations

    Some of the Build Pipeline configurations make it impossible to use the Rebuild unsuccessful Workflows action. See Limitations of the Rebuild unsuccessful Workflows action for more information.

    rebuilding_unsuccessful_workflows.png

Limitations of the Rebuild unsuccessful Workflows action

Some of the Build Pipeline configurations make it impossible to use the Rebuild unsuccessful Workflows action. In this case, you still have the option to Rebuild the entire Pipeline with the new configuration.

rebuild_6.png

You will not be able to use Rebuild unsuccessful Workflows action, if you:

  • Remove a Stage from the Pipeline build.

  • Add a new Stage to the Pipeline build.

  • Add a new Workflow to a Stage.

  • Remove a Workflow from a Stage.

  • Created the initial Pipeline build more than 30 days ago.

rebuild_olderthan30.png

Rebuilding entire Pipelines

The Rebuild entire Pipeline action can be useful, when you want to create a new Pipeline build with a new build number, or when you changed something in your BuIld Pipeline configuration, which makes it impossible to use the Rebuild unsuccessful Workflows action.

When you have a failed or aborted Workflow during a Build Pipeline run, you can rebuild the entire Pipeline which will create a new Build Pipeline build, and start the Pipeline from the first Stage

rebuild_5.png

To use the Rebuild entire Pipeline action:

  1. Open your app on Bitrise.

  2. Select the Pipeline build you would like to rebuild.

  3. On the top right, click on the Rebuild drop-down menu.

  4. Select Rebuild entire Pipeline.

    rebuilding_entire_pipelines.png
In this section:

A Workflow is a collection of Steps, Environment Variables, and other configurations. When Bitrise starts a build, it runs one or more Workflows according to the configuration defined in the bitrise.yml file.

A Bitrise Pipeline is the top level of the Bitrise CI/CD configuration. Pipelines can be used to organize the entire CI/CD process and to set up advanced configurations with multiple different tasks running parallel and/or sequentially.

A Stage is a collection of Workflows. Stages are the top-level building blocks of Pipelines. A Stage can contain multiple Workflows, which all run in parallel in the same Stage. If all Workflows are successful in a Stage, the Pipeline moves on to the next Stage. If any of the Workflows fail, the Pipeline ends without running the other Stages unless you configure a given Stage to always run.