Edit

Upgrade the ALM Accelerator

  • Article

We periodically release updates of the ALM Accelerator for Power Platform. When a new version of the solution is available, follow the steps in this article to upgrade it. Upgrade the pipeline templates separately using the pipeline sync template that's included with the ALM Accelerator solution.

Don't use these instructions to install the ALM Accelerator for the first time. Instead, follow one of these guides:

Download the latest release

The solution version number indicates the date of the release. For example, version 1.0.20220406.1 means version 1.0, created on 20220406 (yyyyMMdd), or April 6, 2022.

Download the latest managed solution file from GitHub. Scroll down to Assets and select CenterofExcellenceALMAccelerator_<latest version>_managed.zip.

Install the ALM Accelerator solution

  1. Sign in to Power Apps, and then select the environment that hosts the ALM Accelerator app.

  2. In the left side panel, select Solutions.

  3. Select Import solution > Browse, and then browse to the location of the managed solution you downloaded and select the file.

  4. Select Next.

  5. Select Advanced settings, and then select Update.

  6. Select Import.

Reactivate the Azure DevOps custom connector

  1. Select Data > Custom Connectors > CustomAzureDevOps.

  2. Select Edit.

  3. On the Definition tab, confirm there are six policies that are configured as described in the following section.

  4. On the Security tab, select Edit, and then set the following values:

  5. On the Test tab, select Test operation.

  6. Confirm the Response Status returned is 200.

  7. Select Update connector.

  8. Update the ALM Accelerator pipeline templates.

Verify the Azure DevOps custom connector policies

You should have six policies on the Definition tab in the CustomAzureDevOps custom connector. Make sure they're defined as described in the following tables. You might need to create missing policies or change values to match the specifications that follow. Pay attention to the Operations field, which can sometimes be set to empty after an upgrade.

Set host to https://vssps.dev.azure.com policy:

Field Value
Name Set host to https://vssps.dev.azure.com
Template Set host URL
Operations GetUsers, GetIdentities
URL Template https://vssps.dev.azure.com

Set host to https://app.vssps.visualstudio.com policy:

Field Value
Name Set host to https://app.vssps.visualstudio.com
Template Set host URL
Operations GetOrganizations, GetUserCurrentProfile
URL Template https://app.vssps.visualstudio.com

Convert Build Definition Variables to Array policy:

Field Value
Name Convert Build Definition Variables to Array
Template Convert an object to an array (Preview)
Operations
Target object or collection path @body().value
Property subpath variables
Path of the new property @item().variables
Property name for the key key
Property name for the value value
Run policy on Response

Set host to https://vsaex.dev.azure.com policy:

Field Value
Name Set host to https://vsaex.dev.azure.com
Template Set host URL
Operations RemoveMemberFromGroup, AddMemberToGroup
URL Template https://vsaex.dev.azure.com

Set method to POST policy:

Field Value
Name Set method to POST
Template Route request
Operations RunSyncPipeline
New path <organization>/<project>/_apis/pipelines/<pipelineId>/runs
Method POST

Set method to GET for ListItems policy:

Field Value
Name Set method to GET for ListItems
Template Route request
Operations ListItems
New path <organization>/<project>/_apis/git/repositories/<repo>/items
Method GET