Set up ALM Accelerator for Makers components

Je li ova stranica od pomoći?

Imate dodatne povratne informacije?

Povratne informacije će biti poslane kompaniji Microsoft: pritiskom na dugme za slanje, vaše povratne informacije će se koristiti za unapređivanje proizvoda i usluga kompanije Microsoft. Pravila privatnosti.

Important

The ALM Accelerator for Makers components are for reference only. For more robust deployment configurations, including components that need to be configured as part of—or after—solution deployment, we recommend that you use the ALM accelerator for Microsoft Power Platform. The GitHub integration in the ALM Accelerator for Makers will eventually be replaced by functionality in the ALM Accelerator for Power Platform app. More information: Set up the ALM accelerator for Microsoft Power Platform components and Use the ALM accelerator for Power Platform app

This solution uses GitHub actions for source control and deployments. The GitHub connector is used in flows to interact with GitHub. More information: Use the ALM Accelerator for Makers components

Prerequisites

Note

The ALM Accelerator for Makers components don't have a dependency on other components of the CoE Starter Kit. They can be used independently.

Environments

The ALM Accelerator for Makers components will manage deploying solutions from development to testing to production environments. You'll need separate environments for deploying ALM Accelerator for Makers, and for the development, testing, and production of your project:

1. Create an environment with a Microsoft Dataverse database for deploying ALM Accelerator for Makers.

   • The environment must have a data loss prevention (DLP) policy that allows Dataverse, Office 365 Outlook, Power Apps for Makers, Approvals, GitHub, and Power Platform for Admins connectors to be used together. Those connectors must be in the business data–only bucket of the DLP policy for this environment.

   • Any target environment—development, test, or production—will require a Dataverse database for deploying solutions.

2. Create a GitHub account at GitHub.com.

3. Create a GitHub org.

Users and permissions

You'll need the following users and permissions in Microsoft Power Platform and Azure Active Directory (Azure AD):

• A licensed Power Apps user with the system administrator security role in the environment where ALM Accelerator for Makers will be deployed.

  Note

  This user must not have enabled multifactor authentication until the full support of service principals is enabled in GitHub workflows.

• A licensed Azure user with permissions to create app registrations and grant admin consent to app registrations in Azure AD.

• A GitHub account at GitHub.com.

• A GitHub organization.

Create an Azure AD app registration

Set up an Azure AD app registration that will be used to create environments and retrieve solutions within an environment:

1. Sign in to portal.azure.com.

2. Go to Azure Active Directory > App registrations.

3. Select + New Registration.

4. Enter GithubDevOpsApp for the name, and then select Register. Don't change any other settings.

5. Select API Permissions > + Add a permission.

6. Select Dynamics CRM.

7. Select Delegated permissions, and then select user_impersonation.

8. Select Add permissions.

9. Select Grant admin consent for [Your Organization].

10. Select Authentication from the menu.

11. Under Advanced Settings > Allow public client flows, turn on the Enable the following mobile and desktop flows toggle.

12. Select Save.

13. Select Overview, and copy and paste the application (client) ID value to Notepad. You'll need this value in the next step as you configure the custom connector.

Leave the Azure portal open, because you'll need to copy some information when you set up the custom connector.

Import the solution

1. Download the ALM Accelerator for Makers solution zip file from the CoE Starter Kit repository (aka.ms/CoeStarterKitDownload—download the file ALMAcceleratorForMakers_x.x.xxxxxxxx.x_managed.zip under "Assets").

2. Go to make.powerapps.com.

3. Go to your target environment.

4. Create connections to all connectors used as part of the solution.

   1. Go to Data > Connections.
   2. Select + New Connection.
   3. Search for and select Microsoft Dataverse.
   4. Select + to create a connection.
   5. Complete the same steps for the following connectors:
      • Office 365 Outlook
      • GitHub
      • Power Apps for Makers
      • Power Platform for Admins
      • Approval
      • Content Conversion

5. On the left pane, select Solutions.

6. Select Import. A pop-up window appears. If the window doesn't appear, be sure your browser's pop-up blocker is disabled and try again.

7. In the pop-up window, select Choose File.

8. Select the ALM Accelerator solution from File Explorer (ALMAcceleratorForMakers_x.x.xxxxxxxx.x_managed.zip).

9. When the compressed (.zip) file has been loaded, select Next.

10. Review the information, and then select Next.

11. Establish connections to activate your solution. If you create a new connection, you must select Refresh. You won't lose your import progress.

    

12. Select Import.

Configure environment settings and deployment stages after import

1. Go to make.powerapps.com.
2. On the left pane, select Solutions.
3. Select the Power Platform GitHub ALM solution, and then open the ALM Accelerator Admin Configuration app.

Set up deployment stages

Important

Update one row at a time, and then select Update to save your changes.

1. Update the Stage Owner Email for each of the three stages (DEV, TEST, and PROD). The stage owner will receive notification for approving project creation and deployment.

2. Update the Admin username and password. These credentials can be a service account or a user account with a Power Platform admin role.

3. For each of the test and production stages, select a pre-existing environment that will be used for test and production deployments. Your development environment is the environment provisioned when you first create a project.

Update the Webhook URL value

This URL will be used for callbacks from GitHub.

1. On a new tab, go to make.powerapps.com > Solutions > Power Platform GitHub ALM solution.

2. Edit the WorkflowCompleteNotification flow.

3. Select the first action, and then copy the URL in the action.

4. Go back to the ALM Accelerator Admin app, and update the Webhook Url field with the value that you copied in the previous step.

5. Select Update.

Update the client ID

The client ID is needed for flows to create an environment and perform other admin-related activities, like fetching solutions and apps inside an environment.

1. In the ALM Accelerator Admin app, update the Client ID field by using the application (client) ID value you copied in step 13 of Create an Azure AD app registration.

2. Select Update

Update the GitHub org name

1. Enter your GitHub org name. The repositories will be created inside this org. More information: Prerequisites, earlier in this article

2. Select Update.

Update the language

1. Change your preferred language, if you want. Power Apps uses the IETF BCP-47 language tag format, for example en_US, fr_FR, it_IT.

2. Select Update.

Update GitHub plan exists setting

If a paid GitHub org plan exists for your org, turn on the GitHub Plan Exists toggle.

Secure admin credentials

Field-level security is enabled to secure credentials for deployments. As an admin, you'll need to add users to the FieldSecurityForPassword field security profile; this enables those users to add their credentials for the deployment from development to test and production environments.

To add users to the field security profile

1. Go to make.powerapps.com, select Solutions, and then open the Power Platform GitHub ALM solution.

2. Select FieldSecurityForPassword from the solution.

3. Select Users.

4. Select Add.

5. Search for a user you want to add to the profile. Select to add the user to the security profile.

6. Repeat the previous step for all users who will use the ALM Accelerator for Makers app.

7. Select Save and Close.

Configure GitHub org secrets

GitHub org secrets will be used to make API calls to import and export solutions, and to interact with Dataverse. Secrets are the recommended way of storing sensitive information.

GitHub supports org secrets and repository-level secrets. If you have a paid plan, all the secrets created at the org level can be used by private repositories as well. That's the advantage of having a paid plan. Otherwise, the admin has to create secrets for each repository.

Learn more: GitHub Team offerings.

Important

The environment admin must have GitHub repo admin permissions to complete the following steps.

Paid GitHub org plan

If you have a paid GitHub org plan, configure org secrets by following these steps:

1. Go to your org in GitHub (https://github.com/yourorg).
2. Select Settings > Secret > New organization secret
3. Enter DEV_ENVIRONMENT_SECRET as the name for your development deployment stage, and enter the value for your secret.
4. In the Repository access list, select Private Repositories.
5. Select Add Secret.
6. Repeat the preceding steps to add a TEST_ENVIRONMENT_SECRET and PROD_ENVIRONMENT_SECRET.

Free GitHub org plan

If you don't have a paid GitHub org plan, do the following for all projects created in the ALM Accelerator for Makers app.

Note

These steps need to be followed for all projects created in ALM Accelerator for Makers.

1. Go to your org in GitHub (https://github.com/yourorg).
2. Select Settings > Secret > New organization secret.
3. Enter DEV_ENVIRONMENT_SECRET as the name for your development deployment stage, and enter the value for your secret.
4. Select Add Secret.
5. Repeat the preceding steps to add a TEST_ENVIRONMENT_SECRET and PROD_ENVIRONMENT_SECRET.

You can now use the ALM Accelerator for Makers components.