Skip to main content

.NET Core installation and configuration with Azure App Service

Use this workflow with the Add New .NET Core agent wizard to ensure you have all the steps covered for installing and configuring the .NET Core agent with the Azure App Service. Using the wizard is the simplest way to deploy a new agent.

Before you begin

Make sure you have everything you need before you start.

  • The agent will need to be able to reach your Contrast instance. It can be a local/on-premise instance or a hosted instance. A proxy can be configured if the environment has limited network access.

  • It must use supported technologies and system requirements

  • Understand the order of precedence

  • You will also need access to a command line interface (with a chosen directory for downloading the agent) and your organization's instance of Contrast

Start the .NET Core agent wizard

  1. Select Add New at the top of the Contrast web interface.

  2. Select the Application card.

  3. Under Select a language, select .NET Core.

  4. Select Windows for operating system.

Install the agent

  1. Under Select application deployment method, select Install with Azure.

  2. Locate an ASP.NET Core web app where you can add the Contrast extension.

    If you do not have a web app, create an application hosted on Azure App Service. Then publish your application to Azure, and confirm that it works as expected without Contrast.

Configure application settings

Under Configure application settings, use the displayed values to configure settings that allow the agent to connect to Contrast. Add these values in the Application Settings section of the Environment variables blade for your application.

Add an extension for the application

  1. Go to the Azure Portal.

  2. Select your hosted application.

  3. Select Extensions.

  4. Select Add.

  5. Select Contrast .NET Core Site Extension for Azure App Service (this is the extension for .NET Core applications).

  6. Select OK and agree to the terms and conditions.

  7. Wait a few seconds and confirm the site extension installed correctly.

  8. Go back to the application overview and Restart the application.

Verify the agent deployment

  1. Interact with your application as you normally would. For example, interact with your application's web interface or send API commands

  2. Go to the Contrast web interface and select Applications in the header.

  3. Verify that you see the name of your application in the list.

  4. Select servers in the header.

  5. Verify that you see the name of your local server in the list.