Rollback
Rollback (or rolling back) is the process of reverting changes in either Salesforce, your Remote Git Repository, or both. Rollbacks are useful if you need to revert a bad deployment or change. You can rollback to any Snapshot for a given environment that has not been deleted.
Performing a rollback
Rollbacks are performed with the env:rollback command. You will need to know the target snapshot's number in order to rollback; you can use the env:snapshot:list command to list all the available snapshots for a given environment.
By default, a rollback will:
- Revert the Environment State to match the state as recorded in the snapshot.
- Revert the environment's Backing Git Branch to how it looked at the time that the snapshot was taken.
- Revert any changes in your Salesforce org since the snapshot was taken by performing a Flow Out with the metadata in your Git branch as it looked at the time that the snapshot was taken.
- Delete any snapshots that have been rolled back. For example, if the most recent snapshot number for an environment is
10
, and you rollback to snapshot number4
, then snapshots5
to10
(inclusive) will be deleted.