Skip to content

ALM Accelerator For Advanced Makers September 2021

Pre-release
Pre-release
Compare
Choose a tag to compare
@mikefactorial mikefactorial released this 04 Oct 15:06
· 726 commits to 07d347abf169e2bf2a1d4108128caabe12062590 since this release

Issues and new features in this release:

https://github.com/microsoft/coe-starter-kit/milestone/13?closed=1

Setup Note

HTTP with Azure AD Connector Configuration

The latest release includes usage of the HTTP with Azure AD Connector. When running the app for the first time you will be prompted to create a new HTTP with Azure AD Connector. Enter the following when prompted (https://graph.microsoft.com).
image

Create a Service Connection for AA4AM Installation Environment

Additionally, there is a post setup step required to create a Power Platform Service Connection in your Azure DevOps project that points to the environment where AA4AM is installed. In order to create the Service Connection

  1. Ensure that an Application User is created in your installation environment for AA4AM (see https://github.com/microsoft/coe-starter-kit/blob/main/ALMAcceleratorForAdvancedMakers/SETUPGUIDE.md#create-an-app-user-in-your-dataverse-environments for instructions).
  2. Create a new Service Connection that points to the installation environment for AA4AM (see https://github.com/microsoft/coe-starter-kit/blob/main/ALMAcceleratorForAdvancedMakers/SETUPGUIDE.md#create-service-connections-for-devops-to-access-power-platform for instructions).

First Time Setup Instructions

To get started with the ALM Accelerator For Advanced Makers you can

  1. Use the preview CoE CLI to automate the install at https://github.com/microsoft/coe-starter-kit/blob/main/coe-cli/docs/aa4am/readme.md or in the Power Platform CoE CLI E-Book (Recommended)
  2. Use the manual setup documentation can be found at https://github.com/microsoft/coe-starter-kit/blob/main/ALMAcceleratorForAdvancedMakers/SETUPGUIDE.md

Upgrade Instructions

If you are upgrading to the latest release you will need to perform the following steps.

  • Import the latest AA4AM Solution https://github.com/microsoft/coe-starter-kit/releases/download/ALMAcceleratorForAdvancedMakers-September2021a/ALMAcceleratorForAdvancedMakers_1.0.20211001.1_managed.zip

  • Update your pipeline templates repo with the latest from https://github.com/microsoft/coe-alm-accelerator-templates/archive/refs/tags/ALMAcceleratorForAdvancedMakers-September2021.zip

  • We've removed the dependency on the Power DevOps Tools extension in this release. Any extension that has been removed from this list can be safely removed Install Azure DevOps Extensions.

  • Ensure that you have the latest version of Power Platform Build Tools (1.0.35) installed.

  • Update the Azure DevOps Build Service Permissions to allow the pipelines to configure other pipelines (e.g. setting variables for deployment configuration). Follow the SETUPGUIDE.md to set the permissions.

  • In this release we have updated the pipelines to use deployment configuration files stored in source control rather than using Pipeline variables for the json configuration of Connection References, Environment Variables, Component Ownership, App Sharing etc. We've also split the configuration between a customDeploymentSettings.json and deploymentSettings.json in order to use the built in import task to set environment variables and connection references. Please see DEPLOYMENTCONFIGGUIDE.md for more details.

    [!NOTE] If you have previously configured your pipelines using pipeline variables your pipeline variables will no longer work. However, with the addition of functionality to auto generate the deployment configuration files and configure deployment settings via the app in the latest version this should be a simple transition.

    image-20210917083516697

  • To take advantage of the new deployment configuration functionality

    • It is recommended that you delete all of your existing deployment pipeline variables except ServiceConnection and EnvironmentName and reconfigure your solutions for each target environment using the new deployment configuration functionality in the app.

    • Update your export-solution-to-git pipeline to include the following variable

      image-20210920105643412

    • Once you've updated the pipeline variable(s) go to the AA4AM App. Configure your solution deployment and export the solution to source control to ensure your deployment settings are stored appropriately in source control and the associated pipeline variables are created.

Change Log

  • #301-Change how Connection References and Environment Variables are set to align with new Build Tools task
  • #669-[AA4AM] Rename "global-variable-group" to make it easier to identify that it belongs to AA4AM
  • #812-[ALM Accelerator - BUG]: Simplified Version Numbering
  • #855-[AA4AM] Add deployment settings generator to Solution Export Pipeline
  • #895-[AA4AM] Update Build Pipeline to use correct version of PAC CLI based on Canvas YAML version
  • #924-export-solution-to-git pipeline error
  • #938-[AA4AM] Solutions Not Updating When Environment Changes Automatically
  • #954-[ALM Accelerator - BUG]: Custom Connector, GetIdentities unable to resolve schema
  • #956-[AA4AM] September Release Documentation Updates
  • #978-[AA4AM] Release Pipelines
  • #1028-[CoE Starter Kit - Feature] Remove vnext branches
  • #1051-[AA4AM] Add Ability to Configure Deployment Settings in Canvas App
  • #1077-[AA4AM] Add support for latest version PAC CLI
  • #1268-[AA4AM] Does not load connection references on config