ARM template to create a resource group, app service instance, and add the Contrast .NET or .NET Core extension to it.

Environment variables required by the extensions are also setup with this template.

There are some additional branches which allow conditional inclusion of the extension, and even conditional inclusion of the extension and its configuration. See:

• optional-extension
• optional-extension-optional-config

1. The ARM template itself: WebSite.json
2. The parameters to the template, using Azure Vault references: WebSite.parameters.json
3. Minimal parameters to the template, if you do not want to use Azure Vault: WebSite.prompt-parameters.json
4. A PowerShell script to deploy the template: Deploy-AzureResourceGroup.ps1

As the provided ARM template generates many resources in addition to Contrast specifics, if you want to integrate the Contrast specific parts into an existing ARM template, the following links highlight key sections which you'll need to integrate:

• Declaration of Parameters
• Parameter Reference to Vault Keys
• Declaration of Template Variables
• Setup of Contrast Environment Variables
• Addition of Contrast Extension

1. Define 4 secrets in Azure Key Vault: contrastApiKey, contrastAgentServiceKey, contrastAgentUsername and contrastURL -- values for these can be found by logging in to Contrast and navigating to Organization Settings -> API (contrastURL should be scheme and host/port only, do not include /Contrast)
2. Set a value for hostingPlanName in WebSite.parameters.json
3. Update the 4 key vault references in WebSite.parameters.json

If you are not using Azure Key Vault, rename the minimal WebSite.prompt-parameters.json to WebSite.parameters, and then you will be prompted for the 4 values when running the deploy below.

1. Install the AzureRM module in PowerShell: Install-Module AzureRM
2. Login to your Azure instance in Powershell: Connect-AzureRmAccount
3. Determine which location to deploy the resources to. To see a list, run Get-AzureRMLocation | Format-Table
4. (Optional) Adjust the value for ResourceGroupName in Deploy-AzureResourceGroup.ps1 or pass it as a parameter
5. Run the deployment script in PowerShell: .\Deploy-AzureResourceGroup.ps1
6. Specify a region
7. When prompted for contrastDotnetOrDotnetCore, enter Dotnet if your application is using the .NET Framework, and DotnetCore if your application is using .NET Core

This will create the required resources. To complete integration, you must publish your .NET or .NET Core application to this app services instance, and your application should then show up in Contrast.

Run the following command, substituting <Your Resource Group Name> with the name of the resource group to deploy this to: az deployment group create --resource-group <Your Resource Group Name> --template-file WebSite.json --parameters WebSite.parameters.json

When running interactively, you will be prompted for the value of contrastDotnetOrDotnetCore, this can also be passed with an additional switch: --parameters contrastDotnetOrDotnetCore=<Dotnet|DotnetCore>

It is optional, but recommended to pass a name for this deployment so deployment history will be maintained rather than overwritten, this can be achieved by adding e.g.: --name "website-with-contrast-$(date +%Y-%m-%d--%H-%M-%S)"

1. Add the following task to your Pipeline YAML file:

   - task: AzureResourceManagerTemplateDeployment@3
     inputs:
       deploymentScope: 'Resource Group'
       azureResourceManagerConnection: '<Name of Azure Service Connection>'
       subscriptionId: '<Your Azure Subscription ID>'
       action: 'Create Or Update Resource Group'
       resourceGroupName: '<Your Resource Group Name>'
       location: '<Azure Deployment Location>'
       templateLocation: 'Linked artifact'
       csmFile: '<Path/to/WebSite.json>'
       csmParametersFile: '<Path/To/WebSite.parameters.json>'
       deploymentMode: 'Incremental'
       overrideParameters: '-contrastDotnetOrDotnetCore <Dotnet|DotnetCore>'

2. Replace the following 7 parameters in the above snippet:

The following are optional, but recommended parameters which can be added to the overrideParameters section: