====== Rollback ======

[[dido:99_annexes:annex-b-terms-and-definitions:start|Go to Terms and Definitions]]

===== Discussion =====

Rollback is a recovery operation that reverses the effects of an identified change by restoring the affected subject to a previously valid state.

The affected subject may include:

  * An [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_environment|Infrastructure Environment]]
  * An [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_resource|Infrastructure Resource]]
  * A [[dido:99_annexes:annex-b-terms-and-definitions:v:virtual_machine|Virtual Machine]]
  * A [[dido:99_annexes:annex-b-terms-and-definitions:k:kubernetes_cluster|Kubernetes Cluster]]
  * A [[dido:99_annexes:annex-b-terms-and-definitions:c:containerized_workload|Containerized Workload]]
  * A [[dido:99_annexes:annex-b-terms-and-definitions:p:platform_service|Platform Service]]
  * An [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_configuration|Infrastructure Configuration]]
  * An [[dido:99_annexes:annex-b-terms-and-definitions:i:image|Image]]
  * A database
  * Another operational subject

The prior valid state may be identified through:

  * A prior [[dido:99_annexes:annex-b-terms-and-definitions:r:revision|Revision]]
  * A prior [[dido:99_annexes:annex-b-terms-and-definitions:b:baseline|Baseline]]
  * A recorded configuration
  * A checkpoint
  * A snapshot
  * A prior [[dido:99_annexes:annex-b-terms-and-definitions:i:image|Image]]
  * Another identified state representation

Rollback differs from recovery:

  * Rollback restores an identified prior valid state by reversing a change
  * Recovery restores an acceptable operational condition and may use rollback, repair, replacement, restoration, or another mechanism

Rollback differs from restoration:

  * Rollback reverses the effects of an identified change
  * Restoration reconstructs a subject or its information from a preserved representation

Rollback differs from redeployment:

  * Rollback restores an identified prior state
  * Redeployment performs a deployment operation again

===== Definition =====

//recovery operation that reverses the effects of an identified change by restoring the affected subject to an identified prior valid state//

===== Source =====

Dido Solutions, Inc. and Jackrabbit Consulting, Inc.

===== Note =====

Rollback does not necessarily:

  * Restore external state
  * Restore information modified outside the controlled change
  * Reverse irreversible operations
  * Recover all dependent subjects
  * Occur automatically after a failure

Applicable requirements should identify:

  * The affected subject
  * The change being reversed
  * The prior valid state
  * The rollback initiation condition
  * The rollback result
  * State that cannot be reversed
  * Required [[dido:99_annexes:annex-b-terms-and-definitions:e:evidence|Evidence]]

===== Example =====

After an unsuccessful configuration change, Crucible performs Rollback by restoring the affected Infrastructure Environment to the identified Infrastructure Configuration Revision used before the change.

----

<WRAP centeralign>
© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.
</WRAP>