Upgrade the ALM Accelerator
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
Sign in to Power Apps, and then select the environment that hosts the ALM Accelerator app.
In the left side panel, select Solutions.
Select Import solution > Browse, and then browse to the location of the managed solution you downloaded and select the file.
Select Next.
Select Advanced settings, and then select Update.
Select Import.
Reactivate the Azure DevOps custom connector
Select Data > Custom Connectors > CustomAzureDevOps.
Select Edit.
On the Definition tab, confirm there are six policies that are configured as described in the following section.
On the Security tab, select Edit, and then set the following values:
- Identity provider: Microsoft Entra ID
- Client ID: The Application (client) ID from the app registration
- Client secret: The Application (client) secret value from the app registration
- Resource URL: The DevOps Application (client) ID from the app registration
On the Test tab, select Test operation.
Confirm the Response Status returned is 200.
Select Update connector.
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 |