Skip to main content

Rollback pipelines

Pipeline rollback is a type of failure strategy. A rollback pipeline failure strategy applies to all steps and stages in a pipeline.

Currently, the Rollback Pipeline failure strategy is available for the following deployment types only:

  • Kubernetes
  • Native Helm
  • Amazon Elastic Container Service (ECS)

Configure a rollback failure strategy​

  1. In your pipeline, go to the step or stage where you want the rollback strategy to be triggered if that step or stage fails.
  2. Go to the Advanced settings for the selected step or stage.
  3. under Failure Strategy, locate On failure of type, and select the error type that you want to trigger the rollback.
  4. Under Perform Action, select Rollback Pipeline.

Here's an example of the YAML for a pipeline rollback failure strategy that triggers on any error.

failureStrategies:
  - onFailure:
      errors:
         - AllErrors
      action:
         type: PipelineRollback

During pipeline execution, if the failure event occurs that triggers the rollback failure strategy, all steps and stages are rolled back accordingly.

warning

If a pipeline uses pipeline chaining (where one or more stages are actually other pipelines), rolling back the parent pipeline does not roll back the child pipeline, because the child pipeline is considered a separate pipeline execution. In such cases, only the deployment stages of the parent pipeline roll back.