Merge pull request #49641 from v-thpra/azure-triage-fix-1037360

JillGrant615 · web-flow · commit 14d2778d9702 · 2025-03-25T16:16:18.000-06:00
Technical Review 1037360: Build a scalable application with Virtual Machine Scale Sets
diff --git a/learn-pr/azure/build-app-with-scale-sets/1-introduction.yml b/learn-pr/azure/build-app-with-scale-sets/1-introduction.yml
@@ -7,7 +7,7 @@ metadata:
   prefetch-feature-rollout: true
   title: Introduction
   description: Introduction
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: ju-shim
   ms.author: jushiman
   ms.reviewer: mimckitt
diff --git a/learn-pr/azure/build-app-with-scale-sets/2-features-benefits-virtual-machine-scale-sets.yml b/learn-pr/azure/build-app-with-scale-sets/2-features-benefits-virtual-machine-scale-sets.yml
@@ -7,7 +7,7 @@ metadata:
   prefetch-feature-rollout: true
   title: Features and benefits of Virtual Machine Scale Sets
   description: Features and benefits of Virtual Machine Scale Sets
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: ju-shim
   ms.author: jushiman
   ms.reviewer: mimckitt
diff --git a/learn-pr/azure/build-app-with-scale-sets/3-exercise-deploy-scale-set-azure-portal.yml b/learn-pr/azure/build-app-with-scale-sets/3-exercise-deploy-scale-set-azure-portal.yml
@@ -7,7 +7,7 @@ metadata:
   prefetch-feature-rollout: true
   title: Exercise - Deploy a scale set in the Azure portal
   description: Exercise - Deploy a scale set in the Azure portal
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: ju-shim
   ms.author: jushiman
   ms.reviewer: mimckitt
diff --git a/learn-pr/azure/build-app-with-scale-sets/4-configure-virtual-machine-scale-set.yml b/learn-pr/azure/build-app-with-scale-sets/4-configure-virtual-machine-scale-set.yml
@@ -7,7 +7,7 @@ metadata:
   prefetch-feature-rollout: true
   title: Configure a Virtual Machine Scale Set
   description: Configure a Virtual Machine Scale Set
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: ju-shim
   ms.author: jushiman
   ms.reviewer: mimckitt
diff --git a/learn-pr/azure/build-app-with-scale-sets/5-exercise-configure-virtual-machine-scale-set.yml b/learn-pr/azure/build-app-with-scale-sets/5-exercise-configure-virtual-machine-scale-set.yml
@@ -7,7 +7,7 @@ metadata:
   prefetch-feature-rollout: true
   title: Exercise - Configure a Virtual Machine Scale Set
   description: Exercise - Configure a Virtual Machine Scale Set
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: ju-shim
   ms.author: jushiman
   ms.reviewer: mimckitt
diff --git a/learn-pr/azure/build-app-with-scale-sets/6-install-update-applications-virtual-machine-scale-sets.yml b/learn-pr/azure/build-app-with-scale-sets/6-install-update-applications-virtual-machine-scale-sets.yml
@@ -7,7 +7,7 @@ metadata:
   prefetch-feature-rollout: true
   title: Install and update applications in Virtual Machine Scale Sets
   description: Install and update applications in Virtual Machine Scale Sets
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: ju-shim
   ms.author: jushiman
   ms.reviewer: mimckitt
diff --git a/learn-pr/azure/build-app-with-scale-sets/7-exercise-update-applications-virtual-machine-scale-sets.yml b/learn-pr/azure/build-app-with-scale-sets/7-exercise-update-applications-virtual-machine-scale-sets.yml
@@ -7,7 +7,7 @@ metadata:
   prefetch-feature-rollout: true
   title: Exercise - Update applications in Virtual Machine Scale Sets
   description: Exercise - Update applications in Virtual Machine Scale Sets
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: ju-shim
   ms.author: jushiman
   ms.reviewer: mimckitt
diff --git a/learn-pr/azure/build-app-with-scale-sets/8-knowledge-check.yml b/learn-pr/azure/build-app-with-scale-sets/8-knowledge-check.yml
@@ -6,7 +6,7 @@ metadata:
   prefetch-feature-rollout: true
   title: Knowledge check
   description: Knowledge check
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: v-tcassi
   ms.author: tomcassidy
   ms.topic: unit
diff --git a/learn-pr/azure/build-app-with-scale-sets/9-summary.yml b/learn-pr/azure/build-app-with-scale-sets/9-summary.yml
@@ -7,7 +7,7 @@ metadata:
   prefetch-feature-rollout: true
   title: Summary
   description: Summary
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: ju-shim
   ms.author: jushiman
   ms.reviewer: mimckitt
diff --git a/learn-pr/azure/build-app-with-scale-sets/includes/1-introduction.md b/learn-pr/azure/build-app-with-scale-sets/includes/1-introduction.md
@@ -1,4 +1,4 @@
-Managing virtual machines at scale can be a challenge, especially when usage patterns vary and demands on applications fluctuate. You want to be able to adjust your virtual machine resources to match demands. At the same time, you might want to keep the virtual machine configuration consistent to ensure application stability. Achieving these goals means you maintain throughput and responsiveness while minimizing the costs of continually running a large collection of virtual machines.
+Managing virtual machines at scale can be a challenge, especially when usage patterns vary, and demands on applications fluctuate. You want to be able to adjust your virtual machine resources to match demands. At the same time, you might want to keep the virtual machine configuration consistent to ensure application stability. Achieving these goals means you maintain throughput and responsiveness while minimizing the costs of continually running a large collection of virtual machines.
 
 Imagine that you work for a domestic shipping company. Your customers use one of the company's websites to manage and check the status of their shipments. This website is deployed to virtual machines and hosted on-premises. You noticed that increased usage on the site is straining the virtual machines' resources. However, you can't adjust to load fluctuations without manually intervening and creating or deallocating virtual machines.
 
diff --git a/learn-pr/azure/build-app-with-scale-sets/includes/2-features-benefits-virtual-machine-scale-sets.md b/learn-pr/azure/build-app-with-scale-sets/includes/2-features-benefits-virtual-machine-scale-sets.md
@@ -1,12 +1,12 @@
-Azure Virtual Machine Scale Sets provide a scalable way to run applications on a set of virtual machines (VMs). The VMs in a scale set can all have the same configuration and run the same applications or have different configurations and run different applications. As demand grows, the number of VMs that run in the scale set increases. As demand shrinks, excess VMs can be removed. Virtual Machine Scale Set is ideal for scenarios that include compute workloads, big-data workloads, and container workloads.
+Azure Virtual Machine Scale Sets provide a scalable way to run applications on a set of virtual machines (VMs). The VMs in a scale set can all have the same configuration and run the same applications or have different configurations and run different applications. As demand grows, the number of VMs that run in the scale set increases. As demand shrinks, excess VMs can be removed. A Virtual Machine Scale Set is ideal for scenarios that include compute workloads, Big data workloads, and container workloads.
 
 In our example scenario, your customers use one of the company's websites to manage and check the status of their shipments. Because the website is accessed globally, the load is sometimes difficult to predict at any particular time of day. Additionally, loading might vary seasonally, with December being busy because of the holidays at the end of the year. You decide to use a Virtual Machine Scale Set to handle the fluctuating load while maintaining a low response time for customer requests.
 
 In this unit, you explore the features of Virtual Machine Scale Sets. By the end of this unit, you can describe how a scale set works. You learn how a scale set supports scale-out and scale-up scenarios and learn how to use autoscaling and schedule-based scaling to adjust the resources available to a scale set.
 
 ## What is a Virtual Machine Scale Set?
 
-Virtual Machine Scale Sets in Azure are designed to allow you to deploy and manage many load-balanced VMs. Virtual Machine Scale Sets are intelligent enough to automatically scale up or down the number of VM instances.
+Virtual Machine Scale Sets in Azure are designed to allow you to deploy and manage many load-balanced VMs. Virtual Machine Scale Sets are intelligent enough to automatically scale up or down the number of virtual machine (VM) instances.
 
 The criteria used to activate the upscale or downscale can depend on a customized schedule or actual demand and usage. Scale sets can apply the same configuration to a group of VMs simultaneously. They don't require you to manually configure instances individually if you don't want to.
 
@@ -48,7 +48,7 @@ For this scenario, you can use metrics-based autoscaling. This type of autoscali
 
 Azure Spot Virtual Machines allows you to take advantage of our unused capacity at a significant cost savings. At any time when Azure needs the capacity back, the Azure infrastructure evicts Azure Spot Virtual Machines. Therefore, these virtual machines are great for workloads that can handle interruptions like batch processing jobs, dev/test environments, and large compute workloads.
 
-The amount of available capacity can vary based on size, region, time of day, and other factors. When it deploys Azure Spot Virtual Machines, Azure allocates the VMs if there's capacity available, but there's no SLA for these VMs. An Azure Spot Virtual Machine offers no high-availability guarantees. At any point in time when Azure needs the capacity back, the Azure infrastructure evicts Azure Spot Virtual Machines with 30-seconds notice.
+The amount of available capacity can vary based on size, region, time of day, and other factors. When it deploys Azure Spot Virtual Machines, Azure allocates the VMs if there's capacity available, but there's no service level agreement (SLA) for these VMs. An Azure Spot Virtual Machine offers no high-availability guarantees. At any point in time when Azure needs the capacity back, the Azure infrastructure evicts Azure Spot Virtual Machines with 30-seconds notice.
 
 When Azure needs the computing power again, you receive a notification about the VM Azure removes from your scale set. If you need to clean up or gracefully exit code on your VM, you can use Azure Scheduled Events to react to the notification within the VM. You can also make the scale set try to create another VM to replace the one that's being removed. The creation of the new VM is, however, not guaranteed.
 
diff --git a/learn-pr/azure/build-app-with-scale-sets/includes/3-exercise-deploy-scale-set-azure-portal.md b/learn-pr/azure/build-app-with-scale-sets/includes/3-exercise-deploy-scale-set-azure-portal.md
@@ -35,7 +35,7 @@ Your first task is to create a scale set. Configure it to run a web server, in t
       - service nginx restart
     ```
 
-    This file contains configuration information to install nginx on the VMs in the scale set.
+    This file contains configuration information to install *nginx* on the VMs in the scale set.
 
 1. Select **Ctrl**+**S** to save the file, then **Ctrl**+**Q** to close the code editor.
 
@@ -61,7 +61,7 @@ Your first task is to create a scale set. Configure it to run a web server, in t
     By default, the new Virtual Machine Scale Set has two instances and a load balancer.
 
     > [!NOTE]
-    > The `custom-data` flag specifies that the VM configuration should use the settings in the *cloud-init.yaml* file after the VM has been created. You can use a cloud-init file to install additional packages, configure security, and write to files when the machine is first installed.
+    > The `custom-data` flag specifies that the VM configuration should use the settings in the *cloud-init.yaml* file after the VM is created. You can use a cloud-init file to install more packages, configure security, and write to files when the machine is first installed.
     >
     > For more information, see [Cloud-init support for VMs in Azure](/azure/virtual-machines/linux/using-cloud-init).
 
diff --git a/learn-pr/azure/build-app-with-scale-sets/includes/4-configure-virtual-machine-scale-set.md b/learn-pr/azure/build-app-with-scale-sets/includes/4-configure-virtual-machine-scale-set.md
@@ -57,11 +57,11 @@ A scale rule aggregates the values retrieved for a metric for all instances. It
 
 A one-minute interval is too short to determine whether any change in the metric is long-lasting enough to make autoscaling worthwhile. A scale rule takes a second step, further aggregating the time aggregation's value over a longer, user-specified period. This period is called the *duration*. The minimum duration is five minutes. For example, if the duration is set to 10 minutes, the scale rule aggregates the 10 values calculated for the time grain.
 
-The duration's aggregation calculation can differ from the time grain's aggregation calculation. For example, let's say the time aggregation is *average* and the statistic gathered is *percentage CPU* across a one-minute time grain. For every minute, the average CPU percentage usage across all instances during that minute is calculated. If the time-grain statistic is set to *maximum* and the rule's duration is set to 10 minutes, the maximum of the 10 average values for the CPU usage percentage determines whether the rule threshold has been crossed.
+The duration's aggregation calculation can differ from the time grain's aggregation calculation. For example, let's say the time aggregation is *average* and the statistic gathered is *percentage CPU* across a one-minute time grain. For every minute, the average CPU percentage usage across all instances during that minute is calculated. If the time-grain statistic is set to *maximum*, and the rule's duration is set to 10 minutes. Then, the maximum of the 10 average values for the CPU usage percentage determines whether the rule threshold was crossed.
 
 When a scale rule detects that a metric crosses a threshold, it can do a scale action. A scale action can be a *scale-out* or a *scale-in*. A scale-out action increases the number of instances. A scale-in action reduces the instance count.
 
-A scale action uses an operator such as *less than*, *greater than*, or *equal to* to determine how to react to the threshold. Scale-out actions typically use the *greater than* operator to compare the metric value to the threshold. Scale-in actions tend to compare the metric value to the threshold by using the *less than* operator. A scale action also sets the instance count to a specific level rather than increasing or decreasing the number available.
+A scale action uses an operator such as *less than*, *greater than*, or *equal to*, to determine how to react to the threshold. Scale-out actions typically use the *greater than* operator to compare the metric value to the threshold. Scale-in actions tend to compare the metric value to the threshold by using the *less than* operator. A scale action also sets the instance count to a specific level rather than increasing or decreasing the number available.
 
 A scale action has a *cool down* period, specified in minutes. During this period, the scale rule isn't triggered again. The cool-down allows the system to stabilize between scale events. Starting or shutting down instances takes time, so any metrics gathered might not show significant changes for several minutes. The minimum cool-down period is five minutes.
 
diff --git a/learn-pr/azure/build-app-with-scale-sets/includes/5-exercise-configure-virtual-machine-scale-set.md b/learn-pr/azure/build-app-with-scale-sets/includes/5-exercise-configure-virtual-machine-scale-set.md
@@ -1,4 +1,4 @@
-Recall from the example scenario that your customers use one of the company's websites to manage and check the status of their shipments. This website is deployed to virtual machines and hosted on-premises. 
+Recall from the example scenario that your customers use one of the company's websites to manage and check the status of their shipments. This website is deployed to virtual machines and hosted on-premises.
 
 You notice that users of the website have significant delays in response times when the overall CPU usage of the virtual machines exceeds 75 percent. You need the Virtual Machine Scale Set that hosts your web application to scale when the system hits this threshold. To save costs, you also want to scale back in when demand falls and the overall CPU usage across the scale set drops below 50 percent.
 
@@ -13,7 +13,7 @@ In this exercise, you configure autoscaling. Define scale rules that scale out a
 
 1. In the [Azure portal](https://portal.azure.com), go to the page for the Virtual Machine Scale Set.
 
-1. On the Virtual Machine Scale Set page, under **Settings**, select **Scaling**.
+1. On the Virtual Machine Scale Set page, under **Settings**, select **Availability + scale**.
 
 1. Select **Custom autoscale**. In the **Default** scale rule, ensure that the **Scale mode** is set to **Scale based on a metric**. Then select **Add a rule**.
 
diff --git a/learn-pr/azure/build-app-with-scale-sets/includes/6-install-update-applications-virtual-machine-scale-sets.md b/learn-pr/azure/build-app-with-scale-sets/includes/6-install-update-applications-virtual-machine-scale-sets.md
@@ -8,7 +8,7 @@ In this unit, you learn how to use a custom script extension to update an applic
 
 An Azure custom script extension downloads and runs a script on an Azure virtual machine. It can automate the same tasks on all the virtual machines (VMs) in a scale set.
 
-Store your custom scripts in Azure Storage or in GitHub. To add one to a VM, you can use the Azure portal. To run custom scripts as part of a templated deployment, combine a custom script extension with Azure Resource Manager templates.
+Store your custom scripts in Azure Storage or in GitHub. To add one to a virtual machine, you can use the Azure portal. To run custom scripts as part of a templated deployment, combine a custom script extension with Azure Resource Manager templates.
 
 ## Install an application across a scale set by using a custom script extension
 
@@ -60,7 +60,7 @@ az vmss extension set \
   --settings @yourConfigV2.json
 ```
 
-The VMs are updated according to the upgrade policy for the scale set. This policy when you first create the scale set. The upgrade policy can have one of the following three modes:
+The VMs are updated according to the upgrade policy for the scale set. You set this policy when you first create the scale set. The upgrade policy can have one of the following three modes:
 
 - **Automatic**: The scale set doesn't define when the VMs are upgraded. They could all update at the same time, causing a service outage.
 - **Rolling**: The scale set rolls out the update in batches across the VMs in the scale set. An optional pause can minimize or eliminate a service outage. In this mode, machines in the scale set might run different versions of the app for a short time. This mode requires that you either add a health probe to the scale set or apply the application health extension to the scale set.
diff --git a/learn-pr/azure/build-app-with-scale-sets/includes/7-exercise-update-applications-virtual-machine-scale-sets.md b/learn-pr/azure/build-app-with-scale-sets/includes/7-exercise-update-applications-virtual-machine-scale-sets.md
@@ -1,6 +1,6 @@
-In the shipping-company scenario, you installed a web application by creating the Virtual Machine Scale Set. You now need to update the web app and install a new version across all virtual machines (VMs) in the scale set. 
+In the shipping-company scenario, you installed a web application by creating the Virtual Machine Scale Set. You now need to update the web app and install a new version across all virtual machines (VMs) in the scale set.
 
-You must ensure that the system remains available during the rollout. A good way to ensure availability is to use a custom script extension to do the update. Apply this script across the Virtual Machine Scale Set. The scale set applies the update to one VM at a time, leaving the other VMs up and running.
+You must ensure that the system remains available during the rollout. A good way to ensure availability is to use a custom script extension to do the update. Apply this script across the Virtual Machine Scale Set. The scale set applies the update to one virtual machine at a time, leaving the other VMs up and running.
 
 In this exercise, you use a custom script extension to roll out a new version of the web app. Edit the message that the nginx server provides. You can use the same approach for bigger updates.
 
@@ -20,7 +20,7 @@ In this exercise, you use a custom script extension to roll out a new version of
       --query upgradePolicy.mode
     ```
 
-    Verify that the upgrade policy is set to `Automatic`. You specified this policy when you created the scale set in the first lab. If the policy was `Manual`, you would apply any VM changes by hand. Because the policy is `Automatic`, you can use the custom script extension and allow the scale set to do the update.
+    Verify that the upgrade policy is set to `Automatic`. You specified this policy when you created the scale set in the first lab. If the policy was `Manual`, you would apply any virtual machine changes by hand. Because the policy is `Automatic`, you can use the custom script extension and allow the scale set to do the update.
 
 1. Run the following command to apply the update script:
 
diff --git a/learn-pr/azure/build-app-with-scale-sets/includes/9-summary.md b/learn-pr/azure/build-app-with-scale-sets/includes/9-summary.md
@@ -12,9 +12,9 @@ az group delete --name myResourceGroup --yes
 
 ## Learn more
 
-- [Overview of autoscale with Azure Virtual Machine Scale Sets](/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-autoscale-overview)
+- [Learn about autoscale with an overview of Azure Virtual Machine Scale Sets](/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-autoscale-overview)
 - [Deploy your application on Virtual Machine Scale Sets](/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-deploy-app)
-- [Work with large Virtual Machine Scale Sets](/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-placement-groups)
+- [Working with large Virtual Machine Scale Sets](/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-placement-groups)
 - [Use the custom script extension for Windows](/azure/virtual-machines/extensions/custom-script-windows)
 - [Use the Azure custom script extension version 2 with Linux VMs](/azure/virtual-machines/extensions/custom-script-linux)
 - [Use the application health extension with Virtual Machine Scale Sets](/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-health-extension)
diff --git a/learn-pr/azure/build-app-with-scale-sets/index.yml b/learn-pr/azure/build-app-with-scale-sets/index.yml
@@ -6,7 +6,7 @@ metadata:
   title: Build a scalable application with Virtual Machine Scale Sets
   description: Enable your application to automatically adjust to changes in load while minimizing costs with Virtual Machine Scale Sets.
   manager: akashdubey
-  ms.date: 04/03/2024
+  ms.date: 03/24/2025
   author: ju-shim
   ms.author: jushiman
   ms.reviewer: mimckitt

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-Managing virtual machines at scale can be a challenge, especially when usage patterns vary and demands on applications fluctuate. You want to be able to adjust your virtual machine resources to match demands. At the same time, you might want to keep the virtual machine configuration consistent to ensure application stability. Achieving these goals means you maintain throughput and responsiveness while minimizing the costs of continually running a large collection of virtual machines.`
	`1`	`+Managing virtual machines at scale can be a challenge, especially when usage patterns vary, and demands on applications fluctuate. You want to be able to adjust your virtual machine resources to match demands. At the same time, you might want to keep the virtual machine configuration consistent to ensure application stability. Achieving these goals means you maintain throughput and responsiveness while minimizing the costs of continually running a large collection of virtual machines.`
`2`	`2`
`3`	`3`	`Imagine that you work for a domestic shipping company. Your customers use one of the company's websites to manage and check the status of their shipments. This website is deployed to virtual machines and hosted on-premises. You noticed that increased usage on the site is straining the virtual machines' resources. However, you can't adjust to load fluctuations without manually intervening and creating or deallocating virtual machines.`
`4`	`4`