Skip to main content

Rebuilding a failed build

Abstract

If a Bitrise build fails, you can rebuild any time to quickly recover from any errors. You can rebuild either single Workflows or an entire Pipeline.

If a build fails, you can rebuild any time to quickly recover from any errors. You can rebuild either single Workflows or an entire Pipeline. A rebuild always uses the current configuration YAML file: if a build fails and then you modify your configuration and rebuild, the rebuild will run with the new configuration.

Rerunning a failed Workflow build

You can rebuild a failed Workflow at any time. Rebuilding means immediately launching a new build with the current configuration YAML file.

  1. Open Bitrise CI and find your project's build page.

  2. On the top right corner, click Rebuild.

    Remote access

    You can also rebuild with remote access: click the downward arrow to open the dropdown menu and click Rebuild with Remote Access. To find out more: Remote access

Rebuilding a failed Pipeline

You can rebuild an entire Pipeline or certain parts of it at any time. The Pipeline build page shows the status of every Workflow in your Pipeline when a build is running. If a Workflow fails, you can save time by re-running the failed Workflow instead of the whole Pipeline.

Rebuilding a failed Pipeline

You can rebuild a Pipeline either in full or its unsuccessful Workflows with the click of a button:

  1. Open Bitrise CI.

  2. Click a finished Pipeline build for your project.

  3. On the Pipeline summary screen, click Rebuild to bring up the rebuild dropdown menu.

  4. Select an option:

    • Rebuild unsuccessful Workflows: This option only rebuilds the Workflows that failed.

    • Rebuild the entire Pipeline: This option rebuilds the entire Pipeline from start to finish.

    • Rebuild unsuccessful Workflows with remote access: Remote access allows you to access the build machine remotely while the build is running: Remote access.

    • Rebuild entire Pipeline with remote access: See above.

Rebuilding a Pipeline from a failed Workflow

You can rebuild a Pipeline from a specific failed Workflow. This will rebuild all Workflows that come after the failed Workflow in the Pipeline.

  1. Open Bitrise CI.

  2. Click a finished Pipeline build for your project.

  3. Scroll down to the graph of the Pipeline.

  4. Find the failed Workflow and hover over it on the right of the card.

  5. Click the Rebuild from here button.

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.

The bitrise.yml file stores your entire build configuration for an app. It specifies your stack and the build triggers, and defines the Workflows of the app. When you make changes on the graphical UI of our Workflow Editor, you actually modify the bitrise.yml file.

OSZAR »