helm rollback: Command Reference for CI/CD

Revert a release to a known-good revision.

helm rollback reverts a release to an earlier revision recorded in its history. With --atomic on upgrade it usually happens automatically, but explicit rollback is the manual escape hatch. This reference covers it and helm history.

Common flags and usage

• rollback <release>: revert to the immediately previous revision
• rollback <release> <revision>: revert to a specific revision number
• helm history <release>: list revisions to pick a target
• --wait: block until the rolled-back release is Ready
• --timeout 5m: bound the wait

Example

helm history web --namespace prod
helm rollback web 4 --namespace prod --wait --timeout 5m

In CI

When you cannot use --atomic (for example a multi-step deploy), wire helm rollback into the failure branch. Read helm history to choose the target revision; a rollback itself creates a new revision, so the history grows forward rather than rewinding.

Key takeaways

• rollback reverts to the previous revision, or a specific one you name.
• helm history shows the revisions to roll back to.
• A rollback creates a new revision; history moves forward, not back.

Related guides