Define a Failure Strategy on Stages and Steps

Updated 4 months ago by Michael Cretzman

Currently, only the All Errors Failure Type is supported.

A failure strategy defines how your stages and steps handle different failure conditions.

The failure strategy contains error conditions that must occur for the strategy to apply, and actions to take when the conditions occur.

Failure strategies are a critical pipeline design component that determine what fails a step or stage and what to do when the failure occurs.

You can apply a failure strategy to the following:

  • Step
  • Step Group
  • Stage
For details on strategy options and how strategies work, see Step and Stage Failure Strategy Settings.

In this topic:

Before You Begin

Visual Summary

Here's a quick video of how to set up failure strategies:

Here is what a Manual Intervention action looks like when a failure occurs:

You can select an option or, if the Manual Intervention exceeds its Timeout setting, select the Post Timeout Action that will happen automatically.

Step: Add a Stage Failure Strategy

The stage failure strategy applies to all steps in the stage that do not have their own failure strategy configured.

In a stage, click Advanced.

In Failure Strategy, you can see the default stage strategy:

On all errors other than those specified in failure strategies defined here, perform action

This default cannot be removed, but it can be edited. You can choose a new Action, Timeout, and Post timeout action.

To add an additional stage failure strategy, click Add.

Select the following:

Currently, only All Errors is supported.
  • Action: select one of the available actions. See Step and Stage Failure Strategy Settings.
  • Timeout and Post timeout action: these are available if you selected Manual Intervention in Action. Enter the timeout for the failure strategy and the subsequent action to perform.
  • Retry Count and Retry Intervals: these are available if you selected Retry in Action. Enter the number of times to retry the step, and the retries intervals.

Step: Add a Step Failure Strategy

By default, steps do not have a failure strategy. Steps follow the stage failure strategy.

When you add a step failure strategy, you are overriding the stage failure strategy.

In a step, click Advanced.

Click Failure Strategy and click Add.

Select the following:

Currently, only All Errors is supported.
  • Action: select one of the available actions. See Step and Stage Failure Strategy Settings.
  • Timeout and Post timeout action: these are available if you selected Manual Intervention in Action. Enter the timeout for the failure strategy and the subsequent action to perform.
  • Retry Count and Retry Intervals: these are available if you selected Retry in Action. Enter the number of times to retry the step, and the retries intervals.

See Also


Please Provide Feedback