Rollback strategies in Jenkins - Step-by-Step Execution

Process Flow - Rollback strategies

Detect failure in deployment

↓

Decide rollback needed?

No→Continue monitoring

Yes↓

Choose rollback method

↓

Revert to

↓

previous

↓

version

↓

Verify rollback success

↓

Resume normal operations

This flow shows how Jenkins detects deployment failure, decides to rollback, chooses a rollback method, and verifies success before resuming.

Execution Sample

Jenkins

pipeline {
  agent any
  stages {
    stage('Deploy') {
      steps {
        sh 'deploy.sh || exit 1'
      }
    }
    stage('Rollback') {
      when { failure() }
      steps {
        sh 'rollback.sh'
      }
    }
  }
}

A Jenkins pipeline that deploys an app and runs rollback if deployment fails.

Process Table

Step	Action	Condition	Result	Next Step
1	Run deploy.sh	N/A	Fails with error	Go to rollback stage
2	Check failure()	Deployment failed	True	Execute rollback.sh
3	Run rollback.sh	N/A	Rollback to previous version	Verify rollback
4	Verify rollback	Rollback success?	Success	Resume normal operations
5	End	N/A	Deployment stable	Pipeline complete

💡 Rollback successful, deployment restored to stable version

Status Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	Final
deployment_status	not started	failed	failed	rolled back	stable
rollback_needed	false	false	true	true	false

Key Moments - 2 Insights

Why does the rollback stage run only after deployment fails?

Because the 'when { failure() }' condition in the Jenkins pipeline triggers rollback only if the deploy stage fails, as shown in execution_table row 2.

What happens if rollback.sh also fails?

The pipeline would stop or report failure; this example assumes rollback.sh succeeds (row 3). Handling rollback failure requires additional error steps.

Visual Quiz - 3 Questions

Look at the execution table, what is the deployment_status after step 3?

A failed

B rolled back

C stable

D not started

💡 Hint

Check variable_tracker column 'After Step 3' for deployment_status

At which step does Jenkins decide to run rollback.sh?

A Step 2

B Step 1

C Step 4

D Step 5

💡 Hint

Look at execution_table row 2 where failure() condition triggers rollback

If deploy.sh succeeds, what happens to the rollback stage?

A Rollback runs anyway

B Pipeline fails

C Rollback stage is skipped

D Rollback runs after verification

💡 Hint

Recall 'when { failure() }' means rollback runs only on failure (see key_moments 1)

Concept Snapshot

Jenkins rollback strategies:
- Detect deployment failure
- Use 'when { failure() }' to trigger rollback stage
- Rollback methods: revert, redeploy, or backup
- Verify rollback success before continuing
- Ensures stable deployment state

Full Transcript

This Jenkins rollback strategy pipeline runs a deployment script. If deployment fails, Jenkins detects failure and triggers the rollback stage using the 'when { failure() }' condition. The rollback stage runs a rollback script to restore the previous stable version. After rollback, the pipeline verifies success and resumes normal operations. Variables track deployment status and rollback need. This flow ensures deployments can be safely reverted if errors occur.