Exercise - Configure a delegated pipeline

Completed

In this exercise, you apply your learned knowledge to configure environments for a delegated deployment with a service principal.

Scenario

You are a Microsoft Power Platform administrator and need to configure deployment stages so that you can use a service principal.

Exercise steps (video)

The following video describes the steps for this exercise. The detailed instructions follow.

Preparation

To prepare for this exercise, you need to have the following assets provisioned and configured:

  • User with the Microsoft Power Platform administrator role

  • Microsoft Power Platform environments for host, development, and one or more targets

  • The Power Platform Pipelines app installed on the host environment

  • The environments successfully added in the Power Platform Pipelines app

  • An Enterprise application created in Microsoft Entra ID and owned by your admin user

Exercise

First, you need to add the enterprise application as a server-to-server (S2S) user in your pipelines host environment and to each target environment that it deploys to.

In the Power Platform admin center, for the host and each target environment, follow these steps:

  1. Select the environment.

  2. Select S2S apps.

  3. Select New app user.

  4. Select Add an app.

  5. Select the enterprise application that you created.

  6. Select Add.

  7. Select the root business unit.

  8. Select the Deployment Pipeline Administrator security role for the host environment and the System Administrator security role for the target environment(s).

  9. Select Save.

  10. Select Save.

  11. Select Create.

To delegate a deployment stage with a service principal, follow these steps:

  1. In the Power Apps maker portal, select the host environment and then play the Deployment Pipeline Configuration app.

  2. Select Environments and then verify that the environments are added successfully.

  3. Select Pipelines and then create a new pipeline or edit an existing pipeline.

  4. Ensure that the development environment links to the pipeline.

  5. Select the Deployment stages tab on the pipeline form. Create a new deployment stage or edit an existing deployment stage for a target environment.

  6. Select Is Delegated Deployment.

  7. Select Service Principal for Delegated Deployment Type and then enter the client ID of the service principal.

  8. Set Allow sharing requests to Yes.

  9. Select Save.

If you have another target environment, repeat these steps.

Next steps

Now you learned how to configure a delegated deployment pipeline stage with a service principal. Next, you have an opportunity to validate the learned concepts for this module.