Edit

Set up ALM Accelerator for Power Platform (Deprecated)

Note

The CoE CLI is deprecated and no new features are being added. Issues are no longer reviewed or addressed.

If you identify a potential security issue, please report it to the Microsoft Security Response Center.

In addition to the Power Platform admin center, consider using the Microsoft Power Platform CLI, Power Platform API, Power Platform inventory API, and the Power Platform for Admins V2 connector.

First, complete the initial ALM deployment steps as an administrator. Use the following commands to automate the installation. After you complete these steps, add makers and set up connections to their Power Platform development environments.

Overview

The following roles are involved with Power Platform.

  • Administrator:
    • Microsoft Entra ID: Permissions to create Microsoft Entra applications with Admin Level Consent.
    • Power Platform: Environment administrator to create validation, test, and production environments.
    • Azure DevOps: Organization and project administrator.
  • Maker:
    • Power Platform: Create development environment.
    • Azure DevOps: Azure DevOps project user, create solution branch.

It is assumed that the installation will be run by a single user with the following rights:

  • Power Platform administration role
  • DevOps administrator rights
  • Microsoft Entra administrator rights

Before you start

Complete Before You Start to ensure that:

  • Power Platform environments have been created.
  • The Azure DevOps organization and Azure DevOps project have been created.
  • The latest version of the CoE CLI is installed.

Initial install

  1. Create install configuration file and review the generated JSON file and confirm the settings before you start the install process.

    coe alm generate install -o quickstart.json
    

    This command generates a file similar to the following:

    {
    "log": [
       "info"
    ],
    "components": [
       "all"
    ],
    "aad": "ALMAcceleratorServicePrincipal",
    "group": "ALMAcceleratorForAdvancedMakers",
    "devOpsOrganization": "https://dev.azure.com/dev1234",
    "project": "alm-sandbox",
    "repository": "pipelines",
    "settings": {
       "installEnvironments": [
          "validation",
          "test",
          "prod"
       ],
       "validation": "https://sample-validation.crm.dynamics.com",
       "test": "https://sample-test.crm.dynamics.com",
       "prod": "https://sample-prod.crm.dynamics.com",
       "createSecret": "true",
       "region": [
          "NAM"
       ]
    },
    "importMethod": "api",
    "endpoint": "prod"
    }
    

    More information: COE ALM generate install

  2. Review the JSON and install using the following command.

    coe alm install -f quickstart.json
    

    More information: CoE ALM generate install

    If you're prompted to create an HTTP with Microsoft Entra ID connection, enter https://graph.microsoft.com for both the Base Resource URL and Azure AD Resource URI.

  3. Update permissions for the project build service to enable build pipelines to interact with Git repositories.