Roll Back Application Version Promotion CLI
Roll back an application version's latest promotion using the JFrog CLI.
Description: Rolls back the latest promotion of the specified application version to its previous stage. This action removes the promotion record, but the audit log will retain a history of the rollback. The behavior of the rollback on the artifacts in the application version depends on the original promotion type:
- Copy promotion: Artifacts in the current stage's repositories are deleted.
- Move promotion: Artifacts are removed from the current stage's repositories and restored to the previous stage's repositories from a secure internal repository.
Note
Rollback can be performed from the PROD stage, if needed.
Command:
jfrog apptrust version-rollback <app-key> <version> <from-stage>Alias command: jf at vrb
Command Parameters
| Argument | Required/Optional | Type | Description |
|---|---|---|---|
<app-key> | required | string | The application key of the application version to roll back. |
<version> | required | string | The version number of the version to be rolled back. |
<from-stage> | required | string | The name of the stage from which to roll back the application version. |
--sync | optional | boolean | Default is true (synchronous). Pass --sync=false to return as soon as the request is accepted, without waiting for the operation to complete. |
Sample command:
jf apptrust version-rollback myapp-001 1.1.2 QAFrequently Asked Questions
Common questions about rolling back an application version promotion.
FAQs
Q: How do I roll back an application version's latest promotion using the JFrog CLI?
A: Run jf apptrust version-rollback <app-key> <version> <from-stage> (alias jf at vrb) with the application key, version, and the stage to roll back from.
Q: What happens to artifacts after a rollback if the original promotion was a copy?
A: Artifacts in the current stage's repositories are deleted, since a copy promotion left the source artifacts in place at the previous stage.
Q: What happens to artifacts after a rollback if the original promotion was a move?
A: Artifacts are removed from the current stage's repositories and restored to the previous stage's repositories from a secure internal repository.
Q: Can I roll back a promotion from the PROD stage?
A: Yes. Rollback can be performed from the PROD stage if needed.
Q: Does rolling back an application version promotion erase its audit history?
A: No. Rollback removes the promotion record, but the audit log retains a history of the rollback.
Related Topics
Updated 2 days ago