The Azure WebApp Configuration task reads VSTS variables and adds those as AppSettings and ConnectionStrings to an Azure WebApp. The task also supports Slot Settings. The task can be linked to a web.config to validate if all AppSettings and ConnectionStrings in the web.config exists as VSTS variable.
The Task can be found in the marketplace and added to your VSTS account. The code is open source and can be found on GitHub.
Naming convention
The task uses naming conventions in the VSTS variables to deploy appsettings and connectionstrings to an Azure WebApp. If you like as a Slot Setting. The value of the VSTS variable is used for the value for the appsetting or in case of a connectionstring, the connectionstring.
The following naming conventions rules are supported:
- The name of a variable for an appsetting must start with appsetting.
- The name of a variable for a connectionstring must start with connectionstring.
- The type of database should be added in the namingconvention as stated in the following table.
- For a slotsetting the convention .sticky must be used.
The table below shows some examples:
Type | Example VSTS variable name |
appsetting | appsetting.mysetting |
appsetting with slotsetting | appsetting.mysetting.sticky |
connectionstring to SQL Server | connectionstring.myconnectionstring.sqlserver |
connectionstring to SQL Azure | connectionstring.myconnectionstring.sqlazure |
connectionstring to custom | connectionstring.myconnectionstring.custom |
connectionstring to MySQL | connectionstring.myconnectionstring.mysql |
connectionstring with slotsetting | connectionstring.myconnectionstring.sqlserver.sticky |
Steps to use and configure the task
- Install the task in your VSTS account by navigating to the marketplace and click install. Select the VSTS account where the task will be deployed to.
- Add the task to your release by clicking in your release on add a task and select the Utility category. Click the Add button on the Apply variables to Azure webapp task.
- Configure the task. When the task is added the configuration will look like this:
All yellow fields are required.
– Select an AzureRM subscription. If you don’t know how to configure this. Read this blogpost.
– Select the web app name.
– Select the resourcegroup.
– If you want to deploy to a Deployment slot, check the Deploy to Slot checkbox and select the Slot.
– If you want to validate the VSTS variables against the appSettings and ConnectionStrings in the web.config of the application you deploy, then select the web.config. Otherwise uncheck the Validate variables checkbox.
– When you want validation, you can choose how the task should behave when it finds incorrect variables. Default behavior is that the task will fail with an error. This results in a failed Release and the variables will not be deployed.
The other validation result action is to only get a warning. The variables will be deployed to Azure.
– By default all existing AppSettings and ConnectionStrings in Azure are overwritten by the variables in the release. When you don’t want this, but you want to preserve your appsettings or connectionstrings in your WebApp, then uncheck the Overwrite existing configuration checkbox. - The web.config of your application is not being used to deploy variables to Azure. If you have configured validation, the keys of the appSettings and the names of the ConnectionStrings are used to validate if there are VSTS variables available for these settings. The web.config in this sample looks like this:
- Add variables that match the names of the variables in the AppSettings and ConnectionStrings. Also apply the namingconventions for the VSTS variables.
- Instead of configuring Release variables as in step 5, you can also configure Environment variables. This step shows you how you can configure the release in VSTS to support multiple environments. In this sample each environment will have the same appsettings and connectionstrings. But the value of those differentiate.
After creating the Environments, configure variables per environment. Just like step 5, just add the keys and the values.
To see the Environment variables at a glance, select the Environment variable view as you can see in the following picture:
When you have configured all Environments, you will see an overview like the following:
- When you run the release, the settings will be deployed to Azure. In this sample it looks like this:
Note that the hidden value in VSTS is visible now in Azure.