azure-quickstart-templates/demos/vmss-windows-webapp-dsc-aut...
Azure Quickstarts Pipeline 710530d3a6 update azuredeploy.json README.md for (demos\vmss-windows-webapp-dsc-autoscale) ***NO_CI*** 2024-08-19 15:46:40 +00:00
..
DSC
WebDeploy
README.md update azuredeploy.json README.md for (demos\vmss-windows-webapp-dsc-autoscale) ***NO_CI*** 2024-02-13 15:54:34 +00:00
azuredeploy.json update azuredeploy.json README.md for (demos\vmss-windows-webapp-dsc-autoscale) ***NO_CI*** 2024-08-19 15:46:40 +00:00
azuredeploy.parameters.json
main.bicep Updated VMSS Flex bicep example to Trusted launch 2024-02-06 11:36:06 +05:30
metadata.json update azuredeploy.json README.md for (demos\vmss-windows-webapp-dsc-autoscale) ***NO_CI*** 2024-08-19 15:46:40 +00:00

README.md

description page_type products urlFragment languages
Deploys a Windows VM Scale Set running IIS and a very basic .NET MVC web app. The VMSS PowerShell DSC Extension is leveraged to do the IIS install and WebDeploy package deployment. sample
azure
azure-resource-manager
vmss-windows-webapp-dsc-autoscale
bicep
json

VM Scale Set with autoscale running an IIS WebApp

Azure Public Test Date Azure Public Test Result

Azure US Gov Last Test Date Azure US Gov Last Test Result

Best Practice Check Cred Scan Check

Bicep Version

Deploy To Azure Deploy To Azure US Gov Visualize

The following template deploys a Windows VM Scale Set (VMSS) running an IIS .NET MVC application integrated with Azure autoscale. This template can be used to demonstrate initial rollout and confiuguration with the VMSS PowerShell DSC extension, as well as the process to upgrade an application already running on a VMSS.

VMSS initial deployment

The template deploys a Windows VMSS with a desired count of VMs in the scale set. Once the VMSS is deployed, the VMSS PowerShell DSC extension installs IIS and a default web app from a WebDeploy package. The web app is nothing fancy, it's just the default MVC web app from Visual Studio, with a slight modification that shows the version (1.0 or 2.0) on the landing page.

The application URL is an ARM template output: http://<vmsspublicipfqdn>/MyApp or http://<vmsspublicip>/MyApp.

VMSS application upgrade

This template can also be used to demonstrate application upgrades for VMSS leveraging ARM template deployments and the VMSS PowerShell DSC extension.

When performing the upgrade you'll want to do two things. First, change the path of the webDeployPackage to DefaultASPWebApp.v2.0.zip, this will ensure you get the updated version of the WebDeploy package. Second change the value of powershelldscUpdateTagVersion to 2.0, this ensures the DSC extension is triggered and the WebDeploy package is deployed to the VMSS. Ensure all other parameters of the template are the same as your original deployment. Once deployed, visit the applicaion URL and confirm that the page shows version 2.0.

The VMSS is configured with "upgradePolicy : { "mode" : "Automatic" } to perfom an automatic upgrade of the VMSS. If you'd like to have control over when running VMs are upgraded, change Automatic to Manual. Automatic upgrades can incur downtime as all VMs are upgraded at the same time. For more information please see the Azure doc Upgrade a virtual machine scale set.

Autoscale rules

The Autoscale rules are configured as follows

  • Sample for Percentage CPU in each VM every 1 Minute
  • If the Percentage CPU is greater than 50% for 5 Minutes, then the scale out action (add more VM instances, one at a time) is triggered
  • Once the scale out action is completed, the cool down period is 1 Minute

Learn more

To learn more about how to deploy the template, see the quickstart article.

Tags: VMSS, VM Scale Set, Windows, DSC Extension

Tags: Microsoft.Network/loadBalancers, Microsoft.Compute/virtualMachineScaleSets, DSC, Microsoft.Network/publicIPAddresses, Microsoft.Network/virtualNetworks, Microsoft.Insights/autoscalesettings, ChangeCount