Merge pull request #51097 from v-thpra/azure-triage-fix-1058600

JillGrant615 · web-flow · commit c78ab455f1b3 · 2025-07-01T13:20:50.000-06:00
Technical Review 1058600: Choose a compute provisioning solution for your application
diff --git a/learn-pr/azure/choose-compute-provisioning/1-introduction.yml b/learn-pr/azure/choose-compute-provisioning/1-introduction.yml
@@ -1,13 +1,13 @@
-### YamlMime:ModuleUnit
-uid: learn.choose-compute-provisioning.1-introduction
-metadata:
-  title: Introduction
-  description: In this unit, you'll learn about a business that must decide on its Azure compute resources.
-  ms.date: 03/29/2023
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-title: Introduction
-durationInMinutes: 5
-content: |
-  [!include[](includes/1-introduction.md)]
+### YamlMime:ModuleUnit
+uid: learn.choose-compute-provisioning.1-introduction
+metadata:
+  title: Introduction
+  description: In this unit, you learn about a business that must decide on its Azure compute resources.
+  ms.date: 06/24/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+title: Introduction
+durationInMinutes: 5
+content: |
+  [!include[](includes/1-introduction.md)]
diff --git a/learn-pr/azure/choose-compute-provisioning/2-provisioning-solutions.yml b/learn-pr/azure/choose-compute-provisioning/2-provisioning-solutions.yml
@@ -1,17 +1,17 @@
-### YamlMime:ModuleUnit
-uid: learn.choose-compute-provisioning.2-provisioning-solutions
-metadata:
-  title: Identify the provisioning solutions for Azure compute infrastructure
-  description: Identify the provisioning solutions for Azure compute infrastructure
-  ms.date: 03/29/2023
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-  ms.custom:
-    - devx-track-arm-template
-    - devx-track-terraform
-title: Identify the provisioning solutions for Azure compute infrastructure
-durationInMinutes: 10
-content: |
-  [!include[](includes/2-provisioning-solutions.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.choose-compute-provisioning.2-provisioning-solutions
+metadata:
+  title: Identify the provisioning solutions for Azure compute infrastructure
+  description: Identify the provisioning solutions for Azure compute infrastructure
+  ms.date: 06/24/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+  ms.custom:
+    - devx-track-arm-template
+    - devx-track-terraform
+title: Identify the provisioning solutions for Azure compute infrastructure
+durationInMinutes: 10
+content: |
+  [!include[](includes/2-provisioning-solutions.md)]
+
diff --git a/learn-pr/azure/choose-compute-provisioning/3-azure-native-solutions.yml b/learn-pr/azure/choose-compute-provisioning/3-azure-native-solutions.yml
@@ -1,16 +1,16 @@
-### YamlMime:ModuleUnit
-uid: learn.choose-compute-provisioning.3-azure-native-solutions
-metadata:
-  title: Choose a native Azure solution
-  description: Choose a native Azure solution
-  ms.date: 03/29/2023
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-  ms.custom:
-    - devx-track-arm-template
-title: Choose a native Azure solution
-durationInMinutes: 10
-content: |
-  [!include[](includes/3-azure-native-solutions.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.choose-compute-provisioning.3-azure-native-solutions
+metadata:
+  title: Choose a native Azure solution
+  description: Choose a native Azure solution
+  ms.date: 06/24/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+  ms.custom:
+    - devx-track-arm-template
+title: Choose a native Azure solution
+durationInMinutes: 10
+content: |
+  [!include[](includes/3-azure-native-solutions.md)]
+
diff --git a/learn-pr/azure/choose-compute-provisioning/4-third-party-solutions.yml b/learn-pr/azure/choose-compute-provisioning/4-third-party-solutions.yml
@@ -1,16 +1,16 @@
-### YamlMime:ModuleUnit
-uid: learn.choose-compute-provisioning.4-third-party-solutions
-metadata:
-  title: Choose a third-party solution
-  description: Choose a third-party solution
-  ms.date: 03/29/2023
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-  ms.custom:
-    - devx-track-terraform
-title: Choose a third-party solution
-durationInMinutes: 10
-content: |
-  [!include[](includes/4-third-party-solutions.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.choose-compute-provisioning.4-third-party-solutions
+metadata:
+  title: Choose a third-party solution
+  description: Choose a third-party solution
+  ms.date: 06/24/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+  ms.custom:
+    - devx-track-terraform
+title: Choose a third-party solution
+durationInMinutes: 10
+content: |
+  [!include[](includes/4-third-party-solutions.md)]
+
diff --git a/learn-pr/azure/choose-compute-provisioning/5-exercise-deploy-template.yml b/learn-pr/azure/choose-compute-provisioning/5-exercise-deploy-template.yml
@@ -1,25 +1,25 @@
-### YamlMime:ModuleUnit
-uid: learn.choose-compute-provisioning.5-exercise-deploy-template
-metadata:
-  title: Exercise - Analyze a scenario and map it to a technology option
-  description: Analyze a scenario and map it to a technology option
-  ms.date: 03/29/2023
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-title: Exercise - Analyze a scenario and map it to a technology option
-durationInMinutes: 10
-interactive: bash
-azureSandbox: true
-content: |
-  [!include[](includes/5-exercise-deploy-template.md)]
-# NOTE: Task validation is failing for learners, so that is disabled for now.
-# tasks:
-# - action: exists
-#   environment: azure
-#   azure:
-#     resource:
-#       type: Microsoft.Compute/virtualMachines
-#       name: hostVM1
-#   hint: "Make sure you've successfully deployed the template."
-
+### YamlMime:ModuleUnit
+uid: learn.choose-compute-provisioning.5-exercise-deploy-template
+metadata:
+  title: Exercise - Analyze a scenario and map it to a technology option
+  description: Analyze a scenario and map it to a technology option
+  ms.date: 06/24/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+title: Exercise - Analyze a scenario and map it to a technology option
+durationInMinutes: 10
+interactive: bash
+azureSandbox: true
+content: |
+  [!include[](includes/5-exercise-deploy-template.md)]
+# NOTE: Task validation is failing for learners, so that is disabled for now.
+# tasks:
+# - action: exists
+#   environment: azure
+#   azure:
+#     resource:
+#       type: Microsoft.Compute/virtualMachines
+#       name: hostVM1
+#   hint: "Make sure you've successfully deployed the template."
+
diff --git a/learn-pr/azure/choose-compute-provisioning/6-summary.yml b/learn-pr/azure/choose-compute-provisioning/6-summary.yml
@@ -1,13 +1,13 @@
-### YamlMime:ModuleUnit
-uid: learn.choose-compute-provisioning.6-summary
-metadata:
-  title: Summary
-  description: Summary
-  ms.date: 03/29/2023
-  author: rmcmurray
-  ms.author: robmcm
-  ms.topic: unit
-title: Summary
-durationInMinutes: 5
-content: |
-  [!include[](includes/6-summary.md)]
+### YamlMime:ModuleUnit
+uid: learn.choose-compute-provisioning.6-summary
+metadata:
+  title: Summary
+  description: Summary
+  ms.date: 06/24/2025
+  author: rmcmurray
+  ms.author: robmcm
+  ms.topic: unit
+title: Summary
+durationInMinutes: 5
+content: |
+  [!include[](includes/6-summary.md)]
diff --git a/learn-pr/azure/choose-compute-provisioning/includes/1-introduction.md b/learn-pr/azure/choose-compute-provisioning/includes/1-introduction.md
@@ -1,6 +1,6 @@
 Organizations often face challenges when they provision large numbers of compute resources in Azure.
 
-You're the solution architect for a clothing manufacturer that's moving several product design applications to Azure virtual machines. The company needs to scale out by adding many virtual machines now and in the future. Their current manual process is time consuming and error prone. They want to automate the scale out process to improve operational abilities. They're unsure about the tools that are available on Azure for provisioning compute resources, and where each fits into the overall provisioning process.
+You're the solution architect for a clothing manufacturer that's moving several product design applications to Azure virtual machines. The company needs to scale out by adding many virtual machines now and in the future. Their current manual process is time consuming and error prone. They want to automate the scale-out process to improve operational abilities. They're unsure about the tools that are available on Azure for provisioning compute resources, and where each fits into the overall provisioning process.
 
 In this module, you identify what tools are available on Azure to provision compute. You learn how you can choose an appropriate provisioning platform. Then, you automate deployment with a provisioning tool.
 
diff --git a/learn-pr/azure/choose-compute-provisioning/includes/2-provisioning-solutions.md b/learn-pr/azure/choose-compute-provisioning/includes/2-provisioning-solutions.md
@@ -57,7 +57,7 @@ The following custom script extension configuration can be added to an Azure Res
 
 Desired State Configuration (DSC) extensions make it possible for you to deal with the configurations on your infrastructure that might need more complex installation procedures, such as reboots. DSC helps you define a state for your machines instead of writing detailed manual instructions on how to achieve that state for each machine. State configurations are relatively easy to read and implement.
 
-By using a DSC extension handler, which you can define for a virtual machine, you can enforce your states. The configurations for your states can be located in various places, such as Azure Blob storage or your internal file storage. The DSC extension handler grabs the configuration and implements the state on the target virtual machine. If reboots are necessary for a configuration, DSC continues to execute the state configuration after the reboots are completed.
+By using a DSC extension handler, which you can define for a virtual machine, you can enforce your states. The configurations for your states can be located in various places, such as Azure Blob storage or your internal file storage. The DSC extension handler grabs the configuration and implements the state on the target virtual machine. If it's necessary for reboots to occur during a configuration, DSC continues to execute the state configuration after the reboots are completed.
 
 The following example defines a DSC extension handler for a virtual machine in an Azure Resource Manager template. The `script` property points to a configuration script in blob storage.
 
@@ -152,7 +152,7 @@ The following example defines a Chef extension for a virtual machine in an Azure
 }
 ```
 
-A recipe might look like the one that follows. The recipe installs an IIS web server.
+A recipe might look like the one that follows. The recipe installs an Internet Information Services (IIS) web server.
 
 ```powershell
 #install IIS on the node.
@@ -248,7 +248,7 @@ Azure Automation state configuration is the service you use to make sure that yo
 
 ![Screenshot of the State configuration panel in the Azure portal.](../media/2-automation-state-config.png)
 
-Azure Automation state configuration makes it possible for you to ensure that all target machines are assigned the correct configurations automatically. It also ensures that each machine reports back on what its current state is and shows whether it has achieved the desired state. You can send this information for reporting and for further decision making. You can interact with Azure Automation state configuration through the Azure portal or through Azure PowerShell.
+Azure Automation state configuration makes it possible for you to ensure that the correct configurations are assigned to all target machines automatically. It also ensures that each machine reports back on what its current state is and shows whether it achieved the desired state. You can send this information for reporting and for further decision making. You can interact with Azure Automation state configuration through the Azure portal or through Azure PowerShell.
 
 ## Azure Resource Manager templates
 
diff --git a/learn-pr/azure/choose-compute-provisioning/includes/3-azure-native-solutions.md b/learn-pr/azure/choose-compute-provisioning/includes/3-azure-native-solutions.md
@@ -20,7 +20,7 @@ Let's consider the advantages or disadvantages for each of these tools, by using
 
 ### Scenario
 
-The organization you work for has been given a new contract to work for a new client. They have a handful of virtual machines that run on Azure. The development team decides they need to install a small application they've written to help increase their team's productivity and make sure they can meet new deadlines. This application doesn't require a restart.
+The organization you work for receives a new contract to work for a new client. They have a handful of virtual machines that run on Azure. The development team decides they need to install a small application they wrote to help increase their team's productivity and make sure they can meet new deadlines. This application doesn't require a restart.
 
 The team asks you to implement a solution to ensure that these virtual machines all have the application installed properly, and in the fastest and least complex manner possible.
 
@@ -46,7 +46,7 @@ You decide to use DSC. DSC configurations are easy to read. You can declare a si
 
 ### Solution summary
 
-DSC is easy to read, update, and store. DSC configurations help you declare the state your machines should be in at the point they're provisioned, rather than having instructions that detail how to put the machines in a certain state. Without Azure Automation State Configuration, you have to manage your own DSC configurations and orchestration. DSC can achieve more when it's coupled with Azure Automation State Configuration.
+DSC is easy to read, update, and store. DSC configurations help you declare the state your machines should be in at the point they're provisioned, rather than having instructions that detail how to put the machines in a certain state. Without Azure Automation State Configuration, you have to manage your own DSC configurations and orchestration. DSC can achieve more when coupled with Azure Automation State Configuration.
 
 ## Azure Automation State Configuration
 
diff --git a/learn-pr/azure/choose-compute-provisioning/includes/4-third-party-solutions.md b/learn-pr/azure/choose-compute-provisioning/includes/4-third-party-solutions.md
@@ -10,9 +10,9 @@ Let's consider Chef and Terraform against the same criteria as in the previous u
 
 ### Scenario
 
-Your organization has decided to let the developers create some virtual machines for their own testing purposes. The development team knows various programming languages and recently started writing Ruby applications. They'd like to scale these applications and run them on test environments. They're familiar with Linux. The developers run only Linux-based machines and destroy them after testing is finished.
+Your organization decides to let the developers create some virtual machines for their own testing purposes. The development team knows various programming languages and recently started writing Ruby applications. They'd like to scale these applications and run them on test environments. They're familiar with Linux. The developers run only Linux-based machines and destroy them after testing is finished.
 
-The scenario is ideal for Chef, since you're letting the programmers create their own environments by using their own Ruby configuration scripts. They're already familiar with Ruby, since they've written applications with the language.
+The scenario is ideal for Chef, since you're letting the programmers create their own environments by using their own Ruby configuration scripts. They're already familiar with Ruby, since their applications are written in that language.
 
 ### Solution summary
 
@@ -28,7 +28,7 @@ Chef is suitable for large-scale infrastructure deployment and configuration. Ch
 
 ### Scenario
 
-Your organization has gained a new client who wants to create multiple virtual machines across several cloud providers. The client has asked you to create three new virtual machines in Azure and one other in the public cloud. The client wants the virtual machines to be similar. They should be created by using a script that works with both providers. This approach helps the client have a better idea of what they've provisioned across providers.
+Your organization gains a new client who wants to create multiple virtual machines across several cloud providers. The client asks you to create three new virtual machines in Azure and one other in the public cloud. The client wants the virtual machines to be similar. They should be created by using a script that works with both providers. This approach helps the client have a better idea of what they provisioned across providers.
 
 Terraform is a good solution for this scenario. You can easily create virtual machines and other resources on multiple providers by using Terraform.
 
diff --git a/learn-pr/azure/choose-compute-provisioning/includes/5-exercise-deploy-template.md b/learn-pr/azure/choose-compute-provisioning/includes/5-exercise-deploy-template.md
@@ -1,20 +1,20 @@
-Your organization grows, and demand rises in Europe and Asia. Your organization is based in the United States. Most of your infrastructure is cloud based. Your European users are reporting a slow website. To provide better service to the customers in Europe, your company has asked you to create a new and improved web server for Europe. The machine must be configured as an IIS web server when it's provisioned.
+Your organization grows, and demand rises in Europe and Asia. Your organization is based in the United States. Most of your infrastructure is cloud based. Your European users are reporting a slow website. To provide better service to the customers in Europe, your company asks you to create a new and improved web server for Europe. The machine must be configured as an Internet Information Services (IIS) web server when you provision it.
 
-You've been asked to choose appropriate provisioning tools. Your tools should also be easy to use and easily customizable.
+You're asked to choose appropriate provisioning tools. Your tools should also be easy to use and easily customizable.
 
 In this exercise, you provision a web server to meet the requirements.
 
 ## Provision a web server
 
 You need to use several tools to provision a web server. Using an Azure Resource Manager template, you can define the environment for your web server. The Resource Manager template can also help you define a desired state configuration (DSC) for your web server. When you link to a DSC extension handler in the Resource Manager template, both the environment and the desired state are applied when you provision the web server. The DSC extension handler helps enforce the DSC state that you defined.
 
-In the following exercise, you use a Resource Manager template to provision a virtual machine. The DSC extension handler that's included in the template enforces your state on the virtual machine. You use an Azure storage account to host your DSC configuration file.
+In the following exercise, you use a Resource Manager template to provision a virtual machine. The DSC extension handler included in the template enforces your state on the virtual machine. You use an Azure storage account to host your DSC configuration file.
 
 ## Clone the configuration and template
 
 Let's start by obtaining a configuration file and an Azure Resource Manager template from GitHub.
 
-1. 1. In the Cloud Shell window on the right side of the screen, select the **More** icon (**...**), then select **Settings** > **Go to Classic version**.
+1. In the Cloud Shell window on the right side of the screen, select the **More** icon (**...**), then select **Settings** > **Go to Classic version**.
 
 1. In Azure Cloud Shell instance on the right, run the following command to clone the GitHub repository.
 
@@ -124,7 +124,7 @@ The GitHub repository that you cloned, also contains a Resource Manager template
             "metadata": {
                 "description": "Image SKU"
             }
-        },
+    },
     ```
 
 1. Update the code as follows so that it looks like this code:
@@ -141,7 +141,7 @@ The GitHub repository that you cloned, also contains a Resource Manager template
             "metadata": {
                 "description": "Image SKU"
             }
-        },
+    },
     ```
 
 1. Save the template by pressing <kbd>Ctrl+S</kbd>.
@@ -175,7 +175,7 @@ Now that you have a completed template and a zipped configuration file, you can
 
 Now that you know the template is valid, you can deploy it.
 
-1. To deploy the template, run the following command. When prompted for a password, enter the password you defined in the previous task.
+1. Run the following command To deploy the template. When prompted for a password, enter the password you defined in the previous task.
 
     ```azurecli
     az deployment group create \
@@ -184,9 +184,9 @@ Now that you know the template is valid, you can deploy it.
         --parameters vmName=hostVM1 adminUsername=serveradmin
     ```
 
-    It may take several minutes for deployment to complete.
+    It can take several minutes for deployment to complete.
 
-1. When the deployment is completed, you should have a virtual machine configured as an IIS web server. To confirm it has been set up, run the following command to list all of the resources in the resource group.
+1. When the deployment is completed, you should have a virtual machine configured as an IIS web server. To confirm your setup, run the following command to list all of the resources in the resource group.
 
     ```azurecli
     az resource list \
diff --git a/learn-pr/azure/choose-compute-provisioning/index.yml b/learn-pr/azure/choose-compute-provisioning/index.yml
