Mark Step as failed
Mark a step as failed during pipeline execution to abort it and trigger failure strategies.
You can manually mark a specific step as failed during pipeline execution. When you mark a step as failed, Harness aborts the running step and triggers configured failure strategies.
This action is useful when you have multiple steps running in a parallel step group and you need to stop a specific running step while allowing other steps to continue.
What you will learn from this topic
How to configure a failure strategy for manually marked step failures.
How to mark a step as failed during pipeline execution.
Before you begin
Pipeline permissions: You must have Execute permissions on pipelines to mark a step as failed. For more information, refer to Manage roles.
Account setting enabled: You must enable Allow users to mark a running Step as failure in your Harness account's default settings.
Configure failure strategy
Failure strategies define the actions to take when a step fails. You can configure failure strategies for different failure conditions.
If a step marked as failed has no specified failure strategy, Harness uses the default failure strategy.
Perform the following steps to configure a failure strategy for manual step failure:
In your pipeline, select the step where you want to configure a failure strategy.
Click the Advanced tab.
Under Failure Strategy, click Add.
For On failure of type, select User Marked Failure.
For Perform Action, select the desired action to take when the step is marked as failed, such as Rollback or Retry.
Click Save.
Mark a step as failed
Perform the following steps to mark a step as failed during pipeline execution:
Go to the execution details for a currently-running pipeline.
Select the step you want to mark as failed, and click Mark Step As Failed.
Click Confirm.
In the execution history, the step's Error Summary reports User Initiated Failure, and the step's failure type is USER_MARKED_FAILURE.
Next steps
Define a failure strategy on stages and steps: Configure automated failure handling strategies for different error conditions.
Mark stage as failed: Mark an entire stage as failed instead of a single step.
Last updated
Was this helpful?