PingOne

Rolling back a promotion (early access)

If a promotion causes issues in your target environment, you can roll it back, which restores the environment to its state immediately before the promotion. You can roll back both successful and failed promotions. A rollback undoes all changes made by the promotion.

Limitations and considerations

  • You can roll back only the most recent promotion to the target environment, and all promoted resources are rolled back. You can’t select a subset of resources to roll back. You also can’t roll back a rollback.

  • A promotion can sometimes affect resources that weren’t part of the promotion plan. For example, if you promote the deletion of a policy that was assigned to an application, the promotion also deletes the association between the application and the policy in the target environment. To restore the target environment to its previous state, a rollback must not only restore the deleted policy, but also restore the association between the policy and the application. In this case, the application is considered an indirectly affected resource, and is included in the rollback.

  • If you make manual changes to promoted resources in the target environment after the initial promotion and before the rollback, those changes might be overwritten during the rollback.

Steps

  1. In the PingOne admin console for your source environment, go to Promote > Promotions.

  2. In the list of promotions, locate the most recent promotion, click the More Options (⋮) icon, and select Roll Back.

  3. On the Review Rollback page, review the summary and add release notes.

    A screen capture of the Review Rollback page showing the Rollback tab and listing two resources that will be rolled back.

  4. (Optional) To review the details of the promotion you are rolling back, click the Previous Promotion tab.

    This tab shows details about the configuration resources that were promoted and will be rolled back, including any dependencies.

    A screen capture of the Review Rollback page showing the Previous Promotion tab with details about the promotion that is being rolled back.

  5. Click Roll Back Promotion.

Result

You’re returned to the Promotions page. The rollback shows a status of In Progress. After a couple of minutes, refresh the page. The status changes to Success for a successful rollback.

The promotion you rolled back now shows a status of Rolled Back.

A screenshot of the Promotions list showing a promotion with a status of Rolled Back and a rollback with a status of Success.

Verifying the rollback

To verify the results of the rollback, first confirm the details of the rollback in the source environment, then check the target environment and ensure that it matches what you expect.

Steps

  1. In the PingOne admin console for your source environment, go to Promote > Promotions.

  2. Locate the rollback in the list, click the More Options icon (⋮), and select View.

    Overview tab

    The Overview tab shows information about when the rollback was started and completed, the source and target environments, the status of the rollback, and any release notes that were added.

    A screenshot of the Rollback tab of the rollback details panel.
    Rolled Back Resources tab

    The Rolled Back Resources tab shows the details about the resources that were rolled back.

    A screen capture of the Rolled Back Resources tab of the rollback details panel showing the resources that were included in the promotion that you rolled back.

  3. On the Overview tab, click the link to the target environment in the Original Promotion Environment field.

Result

You’re taken to the PingOne admin console for the target environment so that you can confirm that the results of the rollback match what you expect.