Configure environments for custom pipelines

Completed

If you decide to use a custom pipeline host, you need a dedicated environment and must install the Power Platform Pipelines application in that environment.

Create an environment for the custom pipeline host

If you don't have an environment for the custom pipeline host, you must first create one. The host environment should be a production environment.

Sign in to the Power Platform admin center (https://aka.ms/ppac), go to Environments > New, and create a new environment with a Microsoft Dataverse data store. Be sure to choose the same region that your development, test, and production environments are created in.

Screenshot of host environments.

Install the Power Platform Pipelines application in your host environment

You can install the Power Platform Pipelines application from the Power Platform admin center.

First, select the host environment, and then select Resources > Dynamics 365 apps.

Screenshot of the Dynamics 365 apps option selected.

Select Install app and then scroll down in the right panel until you find Power Platform Pipelines.

Screenshot of the Install apps section, showing the Power Platform Pipelines app selected.

Select Next, agree to the terms of service, and then select Install.

Note

Install only the Power Platform Pipelines app in the host environment.

Role assignment for the host environment

You should assign the Deployment Pipeline User and Deployment Pipeline Administrator security roles to users in the host environment.

You can also assign the pipeline roles by using the Pipeline Security Teams feature in the Deployment Pipeline Configuration app.

Add environments to the host environment configuration

Before you can create a pipeline in the custom host, you need to add the environments that are involved in pipelines to the Deployment Pipeline Configuration app.

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

  2. Select Environments.

  3. Select + New.

  4. Enter the Name for the environment row. It's a good idea to include the same name as the actual environment, such as Contoso Dev.

  5. Select the Environment Type. Choose Development Environment or Target Environment.

  6. Enter the environment ID. Copy this ID from the environment’s Settings page in the Power Platform admin center. The system validates the environment ID when you save the form.

  7. Select Save.

For more information about how to find your environment ID, see Find your environment and organization ID and name.

Prevent makers from creating personal pipelines by default

Custom hosts don't grant pipeline create-access by default like the platform host does. You can prevent users from creating pipelines. To do so, set up a custom host and then use the Force link option in the command bar in the Deployment Pipeline Configuration app to associate a development environment with a custom host.

Screenshot of the Force link option.

Next steps

Now, you learned about configuring environments for custom pipeline hosts. Next, you apply your learned knowledge to configure environments for a custom pipeline host.