PingOne

Scenario 1: Simple promotion without dependencies (early access)

The goal of this scenario is for you to complete the first promotion of the My First App application from the Promotion-Source environment to the Promotion-Target environment. As part of the promotion, you’ll also create some promotion variables.

In this first scenario, My First App has no dependencies.

Configure promotion variables in the source environment

As you prepare for your promotion, you’ve determined that although you want most of the configuration for My First App to be the same in both the source and target environments, you want to use different URLs for the Signoff URLs and Redirect URIs settings. To manage these differences, use promotion variables, which you’ll create in the Promotion-Source environment.

Steps

  1. Sign on to the PingOne admin console for the Promotion-Source environment.

  2. Go to Promote > Promotion Variables and click Create Promotion Variable.

  3. In the Select Target Environment modal, select Promotion-Target in the Target Environment list.

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

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

    After you confirm the target environment, PingOne determines the resources for which you can create variables.

  5. On the Create Variables page, in the Resource Details section, select Application in the Category list.

    A screen capture of the first page of the Create Variables workflow with the Category list expanded.

    Categories allow you to narrow down the list and find what you’re looking for more easily.

    You might need to click Reload resources list to pick up categories for configuration resources that were recently added to the environment.

    Result

    The subcategory auto-fills with Web App because My First App is the only application in the environment, and it’s an OIDC web application. Because there are no other applications in this environment, My First App is also selected automatically in the Resource list.

    The Attributes list shows all of the application configuration attributes for which you can create variables.

    A screen capture of the Create Variables workflow showing Application in the Category field, WEB-APP in the Sub-category field, and My First App in the Resource field.

  6. Select Signoff URLs and Redirect URIs, then click Next.

    A screen capture of the Create Variables workflow showing Application in the Category field

  7. Set the following variable values to use in the Promotion-Target environment.

    The values for the source environment are displayed on the left, and you define the target environment values on the right.

    • Signoff URLs: https://test-myfirstapp.com/signoff

    • Redirect URIs: https://test-myfirstapp.com

    A screen capture of the second page of the Create Variables workflow showing the source environment values for Signoff URLs and Redirect URIs on the left and fields with new values for the target environment on the right.

  8. Click Next.

  9. On the Review and Save page, confirm the variable configuration and click Save.

Result

You’re returned to the Promotion Variables page. My First App is listed in the Resources with Variables section.

A screen capture showing the Promotion Variables page with My First App added to the Resources with Variables list.

Configure and run the promotion in the source environment

To configure the promotion, you’ll confirm the target environment and select My First App as the resource to promote. Next, you’ll decide whether the resource should be created as new in the target environment or mapped to an existing resource. Finally, you’ll review the promotion details and 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. In 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 the two 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 My First App and select it.

    A screenshot of the Select Resources to Promote page with app in the search bar and My First App selected.

  6. Click Next.

    Because this is the first time you’re promoting the app to the target environment, you’re prompted to map it to a resource in the target environment.

    On the Map Resources page, you can see that the promotion service didn’t find a corresponding resource in the Promotion-Target environment. In this case, you’ll promote the app as a new resource.

    A screenshot of the Map Resources modal showing My First App in the Source field.

  7. Click Confirm and Continue.

  8. On the Confirm Promotion page, review the details for the promotion.

    A screenshot of the Confirm Promotion page

    To view the JSON for the resource you’re promoting, click the down arrow on the right side of the table. Viewing the JSON allows you to visually inspect and verify the exact configuration values for the resource before you run the promotion.

    A screenshot of the JSON for My First App, showing the configured variables and other details.

  9. 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 My First App application now exists 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 My First App.
    Promoted Resources tab

    The Promoted Resources tab shows the details about the resources that were promoted.

    A screenshot of the Promoted Resources tab for the initial promotion of My First App.

  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 Applications > Applications, browse or search for My First App, and click it to open the details panel.

    A screenshot of the details panel for the My First app application in the target environment

Result

My First App now exists in the Promotion-Target environment, and the values for the Signoff URLs and Redirect URIs match the values you configured when you configured the variables for the promotion.