PingOne

Scenario 3: Promotion of a PingOne DaVinci flow (early access)

The goal of this scenario is for you to promote a PingOne DaVinci flow so that you can understand how flow versioning is handled during promotion.

In this scenario, you’ll promote a DaVinci flow named Test Registration, Password Reset, and Recovery from the Promotion-Source environment to the Promotion-Target environment. This flow has four versions in the source environment, and Version 3 is the deployed version.

A screenshot of the Test Registration, Password Reset, and Recovery flow in the Promotion-Source environment showing that there are four versions of the flow and Version 3 is the deployed version.

No versions of the flow exist in the target environment.

A screenshot of the Promotion-Target environment showing that there are no versions of the Test Registration, Password Reset, and Recovery flow.

Configure and run the promotion in the source environment

To configure the promotion, you’ll confirm the target environment, select the resource to promote (the Test Registration, Password Reset, and Recovery flow), and determine whether the resource should be created as new in the target environment or mapped to an existing resource. Then you’ll run the promotion.

Steps

  1. In the PingOne admin console for the Promotion-Source environment, go to Promote > Promotions.

  2. Click Run a Promotion.

  3. On the Confirm Target Environment modal, ensure that Promotion-Target is selected in the Target Environment list.

  4. Select The correct environment is selected and I want to continue and click Confirm.

    A screenshot of the Confirm Target Environment modal with Promotion-Target selected in the Target Environment list and the confirmation checkbox selected.

    After you confirm the target environment, PingOne takes snapshots of both environments, compares configuration resources, and lists the resources that you can promote.

    A screenshot of the Select Resources to Promote page without anything selected.

  5. On the Select Resources to Promote page, search for the Test Registration, Password Reset, and Recovery flow and select it.

    A screenshot of the Select Resources to Promote page showing the Test Registration, Password Reset, and Recovery flow.

  6. Click Next.

    The Map Resources page displays. Because no versions of the flow exist in the target environment, the promotion service indicates that the flow will be created as a new resource.

    A screenshot of the Map Resources page showing that the Test Registration, Password Reset, and Recovery flow will be created as a new resource.

  7. Click Confirm and Continue.

    For the purposes of this scenario, there are no dependencies to map. If there were dependencies, you would need to map them on the Auto-select Dependencies page before continuing.

  8. Verify the promotion details on the Confirm Promotion page, enter release notes, and click Run Promotion.

Result

You’re returned to the Promotions page and the current promotion is listed with a status of In Progress. After about 30 seconds, refresh the page. The status will change to Success for a successful promotion.

A screenshot of the Promotions page showing a successful promotion.

Verify the promotion

To verify the results of the promotion, first confirm the details of the promotion in the source environment, then ensure that the flow exists as expected in the target environment.

Steps

  1. In the PingOne admin console for the Promotion-Source environment, go to Promote > Promotions.

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

    Promotions are listed in reverse chronological order, so the most recent promotion appears at the top of the list.
    Overview tab

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

    A screenshot of the Overview tab for the initial promotion of the Test Registration, Password Reset, and Recovery flow.
    Promoted Resources tab

    The Promoted Resources tab shows that the Test Registration, Password Reset, and Recovery flow was promoted to the target environment.

    A screenshot of the Promoted Resources tab for the initial promotion of the Test Registration, Password Reset, and Recovery flow.

  3. On the Overview tab, click View Target Environment.

    You’re taken to the PingOne admin console for the target environment so that you can confirm that the promoted resources exist and match what you expect.

  4. For this scenario, go to DaVinci and click Flows in the sidebar for the DaVinci admin console.

    The Test Registration, Password Reset, and Recovery flow is now listed on the Flows page in the target environment.

    A screenshot of the Test Registration, Password Reset, and Recovery flow in the target environment.

  5. Click the Test Registration, Password Reset, and Recovery flow to open it.

  6. Click the More Options icon (⋮) in the header and select Flow Versions.

Result

The Flow Versions panel displays, showing that, as expected, Version 3 of the flow was promoted and is the only version in the target environment.

A screenshot of the Flow Versions panel showing that Version 3 of the Test Registration, Password Reset, and Recovery flow is the only version in the target environment.