Merge branch 'main' into release-waf-modules-refresh

Author: v-alje

learn-pr/azure-devops/host-build-agent/1-introduction.yml

@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.azdo.host-build-agent.1-introduction
-title: Introduction
-metadata:
-  title: Introduction
-  description: In this module, you learn how to set up a build agent that runs on an Azure virtual machine.
-  ms.custom: devdivchpfy22
-  ms.date: 04/02/2024
-  author: steved0x
-  ms.author: sdanie
-  ms.topic: unit
-durationInMinutes: 1
-content: |
-  [!include[](includes/1-introduction.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azdo.host-build-agent.1-introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: In this module, you learn how to set up a build agent that runs on an Azure virtual machine.
+  ms.custom: devdivchpfy22
+  ms.date: 05/08/2025
+  author: steved0x
+  ms.author: sdanie
+  ms.topic: unit
+durationInMinutes: 1
+content: |
+  [!include[](includes/1-introduction.md)]
+

learn-pr/azure-devops/host-build-agent/2-choose-a-build-agent.yml

@@ -1,48 +1,48 @@
-### YamlMime:ModuleUnit
-uid: learn.azdo.host-build-agent.2-choose-a-build-agent
-title: Choose a Microsoft-hosted or self-hosted build agent
-metadata:
-  title: Choose a Microsoft-hosted or self-hosted build agent
-  description: Learn about some of the factors to consider when you choose a build agent.
-  ms.custom: devdivchpfy22
-  ms.date: 04/02/2024
-  author: steved0x
-  ms.author: sdanie
-  ms.topic: unit
-durationInMinutes: 6
-content: |
-  [!include[](includes/2-choose-a-build-agent.md)]
-quiz:
-  title: Check your knowledge
-  questions:
-  - content: "Let's say you're building a video game. The build process takes two hours to run and uses 18 GB to 20 GB of disk space to compile the game assets. What kind of build agent might you use?"
-    choices:
-    - content: "A Microsoft-hosted agent"
-      isCorrect: false
-      explanation: "Although the build is completed within the allowed time, a Microsoft-hosted agent might not provide enough disk space for your build."
-    - content: "A self-hosted agent"
-      isCorrect: true
-      explanation: "Although the build is completed within the allowed time, you might need a self-hosted agent to accommodate the amount of disk space that your build requires."
-  - content: "Let's say you're building an application that runs on macOS, Linux, and Windows. How might you build the app for each platform you target?"
-    choices:
-    - content: "Create a build pipeline for each platform."
-      isCorrect: false
-      explanation: "Although you can create multiple build pipelines, it's easier to configure the pipeline to build the app on multiple platforms."
-    - content: "Configure one pipeline to build on each platform."
-      isCorrect: true
-      explanation: "You can configure the pipeline to build on multiple platforms."
-    - content: "Build for one platform and trust that the results run on all platforms."
-      isCorrect: false
-      explanation: "You can't always deploy a build for one platform to another platform. You also miss the opportunity to run quality tests on each platform you support."
-  - content: "A self-hosted build agent:"
-    choices:
-    - content: "Must run on Azure."
-      isCorrect: false
-      explanation: "In this module, you bring up a self-hosted agent on Azure. But you can run your build agent almost anywhere."
-    - content: "Can run anywhere, including Azure, another cloud, or on-premises."
-      isCorrect: true
-      explanation: "You can run a self-hosted agent anywhere. The agent must meet the requirements and be able to connect to Azure Pipelines."
-    - content: "Must run on Linux. Use a Microsoft-hosted agent to build Windows applications."
-      isCorrect: false
-      explanation: "A self-hosted agent can run on Linux, macOS, or Windows."
-
+### YamlMime:ModuleUnit
+uid: learn.azdo.host-build-agent.2-choose-a-build-agent
+title: Choose a Microsoft-hosted or self-hosted build agent
+metadata:
+  title: Choose a Microsoft-hosted or self-hosted build agent
+  description: Learn about some of the factors to consider when you choose a build agent.
+  ms.custom: devdivchpfy22
+  ms.date: 05/08/2025
+  author: steved0x
+  ms.author: sdanie
+  ms.topic: unit
+durationInMinutes: 6
+content: |
+  [!include[](includes/2-choose-a-build-agent.md)]
+quiz:
+  title: Check your knowledge
+  questions:
+  - content: "Let's say you're building a video game. The build process takes two hours to run and uses 18 GB to 20 GB of disk space to compile the game assets. What kind of build agent might you use?"
+    choices:
+    - content: "A Microsoft-hosted agent"
+      isCorrect: false
+      explanation: "Although the build is completed within the allowed time, a Microsoft-hosted agent might not provide enough disk space for your build."
+    - content: "A self-hosted agent"
+      isCorrect: true
+      explanation: "Although the build is completed within the allowed time, you might need a self-hosted agent to accommodate the amount of disk space that your build requires."
+  - content: "Let's say you're building an application that runs on macOS, Linux, and Windows. How might you build the app for each platform you target?"
+    choices:
+    - content: "Create a build pipeline for each platform."
+      isCorrect: false
+      explanation: "Although you can create multiple build pipelines, it's easier to configure the pipeline to build the app on multiple platforms."
+    - content: "Configure one pipeline to build on each platform."
+      isCorrect: true
+      explanation: "You can configure the pipeline to build on multiple platforms."
+    - content: "Build for one platform and trust that the results run on all platforms."
+      isCorrect: false
+      explanation: "You can't always deploy a build for one platform to another platform. You also miss the opportunity to run quality tests on each platform you support."
+  - content: "A self-hosted build agent:"
+    choices:
+    - content: "Must run on Azure."
+      isCorrect: false
+      explanation: "In this module, you bring up a self-hosted agent on Azure. But you can run your build agent almost anywhere."
+    - content: "Can run anywhere, including Azure, another cloud, or on-premises."
+      isCorrect: true
+      explanation: "You can run a self-hosted agent anywhere. The agent must meet the requirements and be able to connect to Azure Pipelines."
+    - content: "Must run on Linux. Use a Microsoft-hosted agent to build Windows applications."
+      isCorrect: false
+      explanation: "A self-hosted agent can run on Linux, macOS, or Windows."
+

learn-pr/azure-devops/host-build-agent/3-set-up-environment.yml

@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.azdo.host-build-agent.3-set-up-environment
-title: Exercise - Set up your Azure DevOps environment
-metadata:
-  title: Exercise - Set up your Azure DevOps environment
-  description: Run a template to set up your Azure DevOps environment.
-  ms.custom: devdivchpfy22
-  ms.date: 04/02/2024
-  author: steved0x
-  ms.author: sdanie
-  ms.topic: unit
-durationInMinutes: 8
-content: |
-  [!include[](includes/3-set-up-environment.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azdo.host-build-agent.3-set-up-environment
+title: Exercise - Set up your Azure DevOps environment
+metadata:
+  title: Exercise - Set up your Azure DevOps environment
+  description: Run a template to set up your Azure DevOps environment.
+  ms.custom: devdivchpfy22
+  ms.date: 05/08/2025
+  author: steved0x
+  ms.author: sdanie
+  ms.topic: unit
+durationInMinutes: 8
+content: |
+  [!include[](includes/3-set-up-environment.md)]
+

learn-pr/azure-devops/host-build-agent/4-create-build-agent.yml

@@ -1,26 +1,26 @@
-### YamlMime:ModuleUnit
-uid: learn.azdo.host-build-agent.4-create-build-agent
-title: Exercise - Create a build agent that runs on Azure
-metadata:
-  title: Exercise - Create a build agent that runs on Azure
-  description: Use a virtual machine that runs on Azure to configure a build agent you can use in Azure Pipelines.
-  ms.custom: devdivchpfy22, linux-related-content
-  ms.date: 04/02/2024
-  author: steved0x
-  ms.author: sdanie
-  ms.topic: unit
-interactive: bash
-# azureSandbox: true
-durationInMinutes: 20
-content: |
-  [!include[](includes/4-create-build-agent.md)]
-# NOTE: Task validation is failing for learners, so that is disabled for now.
-# tasks:
-#  Verify a VM exists. Do NOT check anything specific about it.
-# - action: exists
-#   environment: azure
-#   azure:
-#     resource:
-#       type: "Microsoft.Compute/virtualMachines"
-#   hint: "Run the `az vm create` command as shown to create your virtual machine."
-
+### YamlMime:ModuleUnit
+uid: learn.azdo.host-build-agent.4-create-build-agent
+title: Exercise - Create a build agent that runs on Azure
+metadata:
+  title: Exercise - Create a build agent that runs on Azure
+  description: Use a virtual machine that runs on Azure to configure a build agent you can use in Azure Pipelines.
+  ms.custom: devdivchpfy22, linux-related-content
+  ms.date: 05/08/2025
+  author: steved0x
+  ms.author: sdanie
+  ms.topic: unit
+interactive: bash
+# azureSandbox: true
+durationInMinutes: 20
+content: |
+  [!include[](includes/4-create-build-agent.md)]
+# NOTE: Task validation is failing for learners, so that is disabled for now.
+# tasks:
+#  Verify a VM exists. Do NOT check anything specific about it.
+# - action: exists
+#   environment: azure
+#   azure:
+#     resource:
+#       type: "Microsoft.Compute/virtualMachines"
+#   hint: "Run the `az vm create` command as shown to create your virtual machine."
+

learn-pr/azure-devops/host-build-agent/5-build-application.yml

@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.azdo.host-build-agent.5-build-application
-title: Exercise - Build the application using your agent
-metadata:
-  title: Exercise - Build the application by using your agent
-  description: Configure the pipeline to use your build agent, and watch the build in action.
-  ms.custom: devdivchpfy22
-  ms.date: 04/02/2024
-  author: steved0x
-  ms.author: sdanie
-  ms.topic: unit
-durationInMinutes: 10
-content: |
-  [!include[](includes/5-build-application.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azdo.host-build-agent.5-build-application
+title: Exercise - Build the application using your agent
+metadata:
+  title: Exercise - Build the application by using your agent
+  description: Configure the pipeline to use your build agent, and watch the build in action.
+  ms.custom: devdivchpfy22
+  ms.date: 05/08/2025
+  author: steved0x
+  ms.author: sdanie
+  ms.topic: unit
+durationInMinutes: 10
+content: |
+  [!include[](includes/5-build-application.md)]
+

learn-pr/azure-devops/host-build-agent/6-clean-up-environment.yml

@@ -1,15 +1,15 @@
-### YamlMime:ModuleUnit
-uid: learn.azdo.host-build-agent.6-clean-up-environment
-title: Exercise - Clean up your Azure DevOps environment
-metadata:
-  title: Exercise - Clean up your Azure DevOps environment
-  description: Clean up your Azure DevOps environment and disable your build pipeline.
-  ms.custom: devdivchpfy22
-  ms.date: 04/02/2024
-  author: steved0x
-  ms.author: sdanie
-  ms.topic: unit
-durationInMinutes: 7
-content: |
-  [!include[](includes/6-clean-up-environment.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azdo.host-build-agent.6-clean-up-environment
+title: Exercise - Clean up your Azure DevOps environment
+metadata:
+  title: Exercise - Clean up your Azure DevOps environment
+  description: Clean up your Azure DevOps environment and disable your build pipeline.
+  ms.custom: devdivchpfy22
+  ms.date: 05/08/2025
+  author: steved0x
+  ms.author: sdanie
+  ms.topic: unit
+durationInMinutes: 7
+content: |
+  [!include[](includes/6-clean-up-environment.md)]
+

learn-pr/azure-devops/host-build-agent/7-summary.yml

@@ -1,16 +1,16 @@
-### YamlMime:ModuleUnit
-uid: learn.azdo.host-build-agent.7-summary
-title: Summary
-metadata:
-  title: Summary
-  description: This unit summarizes what you've learned and provides more learning resources.
-  ms.custom: devdivchpfy22
-  ms.date: 04/02/2024
-  author: steved0x
-  ms.author: sdanie
-  ms.topic: unit
-  show_latex: true
-durationInMinutes: 7
-content: |
-  [!include[](includes/7-summary.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azdo.host-build-agent.7-summary
+title: Summary
+metadata:
+  title: Summary
+  description: This unit summarizes what you've learned and provides more learning resources.
+  ms.custom: devdivchpfy22
+  ms.date: 05/08/2025
+  author: steved0x
+  ms.author: sdanie
+  ms.topic: unit
+  show_latex: true
+durationInMinutes: 7
+content: |
+  [!include[](includes/7-summary.md)]
+

learn-pr/azure-devops/host-build-agent/includes/1-introduction.md

@@ -27,7 +27,7 @@ If you want to go through just this module, you need to set up a development env
 - An Azure subscription
 - A [GitHub](https://github.com/join?azure-portal=true) account
 - [Visual Studio Code](https://code.visualstudio.com?azure-portal=true)
-- [.NET 6.0 SDK](https://dotnet.microsoft.com/download/dotnet/6.0?azure-portal=true)
+- [.NET 8.0 SDK](https://dotnet.microsoft.com/download/dotnet/8.0?azure-portal=true)
 - [Git](https://git-scm.com/downloads?azure-portal=true)
 
 You can get started with Azure DevOps for free.

learn-pr/azure-devops/host-build-agent/includes/2-choose-a-build-agent.md

@@ -69,7 +69,7 @@ Microsoft-hosted agents have a few limitations, which include:
 
 * **Build duration**: A build job can run for up to six hours.
 * **Disk space**: Hosted agents provide a fixed amount of storage for your sources and your build outputs. This may not be enough storage.
-* **CPU, memory, and network**: Hosted agents run on Microsoft Azure general purpose VMs. [Standard_DS2_v2](/azure/virtual-machines/dv2-dsv2-series#dsv2-series) describes the CPU, memory, and network characteristics you can expect.
+* **CPU, memory, and network**: Hosted agents run on Microsoft Azure general purpose VMs. [Standard_DS2_v2](/azure/virtual-machines/dv2-dsv2-series) describes the CPU, memory, and network characteristics you can expect.
 * **Interactivity**: You can't sign in to a hosted agent.
 * **File shares**: You can't drop build artifacts to Universal Naming Convention (UNC) file shares.
 
@@ -92,10 +92,10 @@ For example, you can:
 * **Set up the build agent manually**: You bring up the system, sign in, and interactively install your build tools and the agent software.
 * **Automate the process**: You bring up the system and run a script or tool to install your build tools and the agent software. You can configure the agent after the system comes online or during the provisioning process.
 
-    For example, when you run build agents on Azure, you can use an Azure Resource Manager template (ARM template) or Bicep to bring up the system and configure it to act as a build agent, all in one step. [Terraform](https://www.terraform.io?azure-portal=true) by HashiCorp is another way to automate the process. Terraform works with many types of infrastructure, including Azure.
+    For example, when you run build agents on Azure, you can use an Azure Resource Manager template (ARM template) or Bicep to bring up the system and configure it to act as a build agent, all in one step. [Terraform](https://developer.hashicorp.com/terraform?azure-portal=true) by HashiCorp is another way to automate the process. Terraform works with many types of infrastructure, including Azure.
 * **Create an image**: You create an image—or snapshot—of a configured environment. You then use the image to create as many identical systems as you need in your pool.
 
-Manual configuration is a good way to get started, because it enables you to understand the process. It's also the fastest way to get set up when you need just one build agent.
+Manual configuration is a good way to get started, because it allows you to understand the process. It's also the fastest way to get set up when you need just one build agent.
 
 Automation is useful when you need many build agents, or you need to bring up and tear down build infrastructure on a regular basis. You can move from a manual process to an automated process when you need multiple agents.
 

learn-pr/azure-devops/host-build-agent/includes/4-create-build-agent.md

@@ -1,4 +1,4 @@
-In this unit, to configure a build agent that you can use in Microsoft Azure Pipelines, you'll use a virtual machine that runs on Microsoft Azure. We provide a virtual machine that you can use for the duration of this module.
+In this unit, you'll use a virtual machine that runs on Microsoft Azure to configure a build agent that you can use in Microsoft Azure Pipelines. We provide a virtual machine that you can use for the duration of this module.
 
 In this unit, you will:
 
@@ -18,7 +18,7 @@ To configure your VM, you have several choices:
 * You can automate the deployment by using an ARM template, Bicep, or other automated provisioning tool.
 * If you need to deploy many build agents, you can create a VM image that has all the software pre-installed.
 
-Configuring a system interactively is a good way to get started because it helps you understand the process and what's needed. To simplify the process, connect to your Ubuntu VM over SSH and run shell scripts to set up your build agent.
+Configuring a system interactively is a good way to get started, because it helps you understand the process and what's needed. To simplify the process, connect to your Ubuntu VM over SSH and run shell scripts to set up your build agent.
 
 > [!NOTE]
 > If you're unfamiliar with connecting to or configuring Linux systems, just follow along. You can apply the same concepts to Windows build agents.
@@ -86,17 +86,17 @@ To create your VM, run the following `az vm create` command:
 az vm create \
     --name MyLinuxAgent \
     --resource-group tailspin-space-game-rg \
-    --image canonical:0001-com-ubuntu-server-focal:20_04-lts:latest \
+    --image canonical:ubuntu-24_04-lts:server:latest \
     --size Standard_DS2_v2 \
     --admin-username azureuser \
     --generate-ssh-keys
 ```
 
 Your VM will take a few minutes to come up.
 
-[Standard_DS2_v2](/azure/virtual-machines/dv2-dsv2-series#dsv2-series) specifies the VM's size. A VM's size defines its processor speed, amount of memory, initial amount of storage, and expected network bandwidth. This is the same size that's provided by Microsoft-hosted agents. In practice, you can choose a size that provides more computing power or additional capabilities, such as graphics processing.
+[Standard_DS2_v2](/azure/virtual-machines/dv2-dsv2-series) specifies the VM's size. A VM's size defines its processor speed, amount of memory, initial amount of storage, and expected network bandwidth. This is the same size that's provided by Microsoft-hosted agents. In practice, you can choose a size that provides more computing power or additional capabilities, such as graphics processing.
 
-The `--resource-group` argument specifies the _resource group_ that holds all the things that we need to create. A resource group enables you to administer all the VMs, disks, network interfaces, and other elements that make up our solution as a unit.
+The `--resource-group` argument specifies the _resource group_ that holds all the things that we need to create. A resource group allows you to administer all the VMs, disks, network interfaces, and other elements that make up our solution as a unit.
 
 ## Create the agent pool