Merge pull request #50706 from v-albemi/bicep-pipelines

1055073: Test your Bicep code by using Azure Pipelines

Author: JillGrant615

learn-pr/azure/includes/azure-template-pipeline-sign-in.md

@@ -14,15 +14,15 @@ To work with resource groups in Azure, sign in to your Azure account from the Vi
 
 1. If the shell shown on the right side of the terminal window is **bash**, the correct shell is open and you can skip to the next section.
 
-    :::image type="content" source="media/bash.png" alt-text="Screenshot of the Visual Studio Code terminal window, with the bash option shown.":::
+    :::image type="content" source="media/bash.png" alt-text="Screenshot of the Visual Studio Code terminal window. The bash option is highlighted.":::
 
-1. If a shell other than **bash** appears, select the shell dropdown, and then select **Git Bash (Default)**.
+1. If a shell other than **bash** appears, select the shell dropdown arrow, and then select **Git Bash**.
 
-    :::image type="content" source="media/select-shell-bash.png" alt-text="Screenshot of the Visual Studio Code terminal window, with the terminal shell dropdown shown and Git Bash Default selected.":::
+    :::image type="content" source="media/select-shell-bash.png" alt-text="Screenshot of the Visual Studio Code terminal window. The terminal shell dropdown list is shown, and Git Bash selected.":::
 
 1. In the list of terminal shells, select **bash**, and then select the plus sign to open a new terminal that uses the **bash** shell.
 
-   :::image type="content" source="media/select-bash-plus.png" alt-text="Screenshot of the Visual Studio Code terminal window, with the bash terminal and the plus sign selected.":::
+   :::image type="content" source="media/select-bash-plus.png" alt-text="Screenshot of the Visual Studio Code terminal window. The bash terminal and the plus sign are highlighted.":::
 
 ### Sign in to Azure by using the Azure CLI
 
@@ -44,15 +44,15 @@ To work with resource groups in Azure, sign in to your Azure account from the Vi
 
 1. If the shell shown on the right side of the terminal window is **powershell** or **pwsh**, the correct shell is open and you can skip to the next section.
 
-    :::image type="content" source="media/pwsh.png" alt-text="Screenshot of the Visual Studio Code terminal window, with the p w s h option displayed in the shell dropdown.":::
+    :::image type="content" source="media/pwsh.png" alt-text="Screenshot of the Visual Studio Code terminal window. The pwsh option is highlighted.":::
 
-1. If a shell other than **powershell** or **pwsh** appears, select the shell dropdown, and then select **PowerShell**.
+1. If a shell other than **powershell** or **pwsh** appears, select the shell dropdown arrow, and then select **PowerShell**.
 
-    :::image type="content" source="media/select-shell-powershell.png" alt-text="Screenshot of the Visual Studio Code terminal window, with the terminal shell dropdown shown and PowerShell selected.":::
+    :::image type="content" source="media/select-shell-powershell.png" alt-text="Screenshot of the Visual Studio Code terminal window. PowerShell is selected in the terminal shell dropdown list.":::
 
 1. In the list of terminal shells, select **powershell** or **pwsh**, and then select the plus sign to open a new terminal that uses the **powershell** or **pwsh** shell.
 
-   :::image type="content" source="media/select-powershell-plus.png" alt-text="Screenshot of the Visual Studio Code terminal window, with the PowerShell terminal and the plus sign selected.":::
+   :::image type="content" source="media/select-powershell-plus.png" alt-text="Screenshot of the Visual Studio Code terminal window. The PowerShell terminal and the plus sign are selected.":::
 
 ### Sign in to Azure by using Azure PowerShell
 

learn-pr/azure/test-bicep-code-using-azure-pipelines/1-introduction.yml

@@ -1,17 +1,17 @@
-### YamlMime:ModuleUnit
-uid: learn.azure.test-bicep-code-using-azure-pipelines.introduction
-title: Introduction
-metadata:
-  unitType: introduction
-  title: Introduction
-  description: Introduction to testing Bicep code by using Azure Pipelines.
-  ms.date: 10/31/2022
-  author: mumian
-  ms.author: jgao
-  ms.topic: unit
-  ms.custom:
-    - devx-track-bicep
-durationInMinutes: 2
-content: |
-  [!include[](includes/1-introduction.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azure.test-bicep-code-using-azure-pipelines.introduction
+title: Introduction
+metadata:
+  unitType: introduction
+  title: Introduction
+  description: Introduction to testing Bicep code by using Azure Pipelines.
+  ms.date: 05/29/2025
+  author: mumian
+  ms.author: jgao
+  ms.topic: unit
+  ms.custom:
+    - devx-track-bicep
+durationInMinutes: 2
+content: |
+  [!include[](includes/1-introduction.md)]
+

learn-pr/azure/test-bicep-code-using-azure-pipelines/10-knowledge-check.yml

@@ -1,53 +1,53 @@
-### YamlMime:ModuleUnit
-uid: learn.azure.test-bicep-code-using-azure-pipelines.knowledge-check
-title: Module assessment
-metadata:
-  unitType: knowledge_check
-  title: Module assessment
-  description: Knowledge check.
-  ms.date: 10/31/2022
-  author: mumian
-  ms.author: jgao
-  ms.topic: unit
-  ms.custom:
-    - devx-track-bicep
-durationInMinutes: 2
-content: |
-  [!include[](includes/10-knowledge-check.md)]
-quiz:
-  questions:
-  - content: |
-      What can you do to minimize the chance of this error happening again?
-    choices:
-    - content: Add an approval check to the pipeline.
-      isCorrect: false
-      explanation: Incorrect. An approval check enables you to manually verify the status of your environment or pipeline. It doesn't reduce the chance of an invalid template being submitted to Azure.
-    - content: Run preflight validation within your pipeline.
-      isCorrect: true
-      explanation: Correct. The preflight validation process performs validation of your template. It reports errors that prevent the template deployment from being submitted to Azure.
-    - content: Add a rollback stage to your pipeline.
-      isCorrect: false
-      explanation: Incorrect. You can add a rollback stage to reverse the effects of a stage that's failed, but it doesn't validate the Bicep file that you submit.
-  - content: Which of these scenarios is an example of negative testing?
-    choices:
-    - content: Manually approving a pipeline run.
-      isCorrect: false
-      explanation: Incorrect. However, you might choose to manually run tests and then approve the pipeline run.
-    - content: Rolling back your deployment if something fails.
-      isCorrect: false
-      explanation: Incorrect. However, you might choose to roll back a deployment if your negative tests fail.
-    - content: Verifying that a website is accessible only through HTTPS and not through HTTP.
-      isCorrect: true
-      explanation: Correct. Negative tests verify that your resource doesn't exhibit unwanted behavior, like responding on nonsecure protocols.
-  - content: Which of these statements is true?
-    choices:
-    - content: The Bicep linter needs to be installed separately from Bicep.
-      isCorrect: false
-      explanation: Incorrect. The Bicep linter is part of the Bicep tooling. It runs automatically when you build or deploy a Bicep file.
-    - content: A template with no linting warnings or errors is guaranteed to deploy successfully.
-      isCorrect: false
-      explanation: Incorrect. The linter runs some basic checks on code style. Your template might successfully pass the linter's checks, but not deploy.
-    - content: Linting ensures that your Bicep file meets a minimum quality level for code style.
-      isCorrect: true
-      explanation: Correct. The linter doesn't verify that your file will deploy successfully, but it checks that your Bicep file follows some basic rules for code style.
-
+### YamlMime:ModuleUnit
+uid: learn.azure.test-bicep-code-using-azure-pipelines.knowledge-check
+title: Module assessment
+metadata:
+  unitType: knowledge_check
+  title: Module assessment
+  description: Knowledge check.
+  ms.date: 05/30/2025
+  author: mumian
+  ms.author: jgao
+  ms.topic: unit
+  ms.custom:
+    - devx-track-bicep
+durationInMinutes: 2
+content: |
+  [!include[](includes/10-knowledge-check.md)]
+quiz:
+  questions:
+  - content: |
+      What can you do to minimize the chance of this error happening again?
+    choices:
+    - content: Add an approval check to the pipeline.
+      isCorrect: false
+      explanation: Incorrect. An approval check enables you to manually verify the status of your environment or pipeline. It doesn't reduce the chance of an invalid template being submitted to Azure.
+    - content: Run preflight validation in your pipeline.
+      isCorrect: true
+      explanation: Correct. The preflight validation process performs validation of your template. It reports errors that prevent the template deployment from being submitted to Azure.
+    - content: Add a rollback stage to your pipeline.
+      isCorrect: false
+      explanation: Incorrect. You can add a rollback stage to reverse the effects of a stage that fails, but that stage doesn't validate the Bicep file that you submit.
+  - content: Which of these scenarios is an example of negative testing?
+    choices:
+    - content: Manually approving a pipeline run.
+      isCorrect: false
+      explanation: Incorrect. However, you might choose to manually run tests and then approve the pipeline run.
+    - content: Rolling back your deployment if something fails.
+      isCorrect: false
+      explanation: Incorrect. However, you might choose to roll back a deployment if your negative tests fail.
+    - content: Verifying that a website is accessible only through HTTPS and not through HTTP.
+      isCorrect: true
+      explanation: Correct. Negative tests verify that your resource doesn't exhibit unwanted behavior, like responding on nonsecure protocols.
+  - content: Which of these statements is true?
+    choices:
+    - content: The Bicep linter needs to be installed separately from Bicep.
+      isCorrect: false
+      explanation: Incorrect. The Bicep linter is part of the Bicep tooling. It runs automatically when you build or deploy a Bicep file.
+    - content: A template with no linting warnings or errors is guaranteed to deploy successfully.
+      isCorrect: false
+      explanation: Incorrect. The linter runs some basic checks on code style. Your template might successfully pass the linter's checks but not deploy.
+    - content: Linting ensures that your Bicep file meets a minimum quality level for code style.
+      isCorrect: true
+      explanation: Correct. The linter doesn't verify that your file will deploy successfully, but it checks that your Bicep file follows some basic rules for code style.
+

learn-pr/azure/test-bicep-code-using-azure-pipelines/11-summary.yml

@@ -1,17 +1,17 @@
-### YamlMime:ModuleUnit
-uid: learn.azure.test-bicep-code-using-azure-pipelines.summary
-title: Summary
-metadata:
-  unitType: summary
-  title: Summary
-  description: Summary for testing your Bicep code by using Azure Pipelines.
-  ms.date: 10/31/2022
-  author: mumian
-  ms.author: jgao
-  ms.topic: unit
-  ms.custom:
-    - devx-track-bicep
-durationInMinutes: 1
-content: |
-  [!include[](includes/11-summary.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azure.test-bicep-code-using-azure-pipelines.summary
+title: Summary
+metadata:
+  unitType: summary
+  title: Summary
+  description: Summary for testing your Bicep code by using Azure Pipelines.
+  ms.date: 05/30/2025
+  author: mumian
+  ms.author: jgao
+  ms.topic: unit
+  ms.custom:
+    - devx-track-bicep
+durationInMinutes: 1
+content: |
+  [!include[](includes/11-summary.md)]
+

learn-pr/azure/test-bicep-code-using-azure-pipelines/2-understand-pipeline-stages.yml

@@ -1,17 +1,17 @@
-### YamlMime:ModuleUnit
-uid: learn.azure.test-bicep-code-using-azure-pipelines.understand-pipeline-stages
-title: Understand pipeline stages
-metadata:
-  unitType: learning-content
-  title: Understand pipeline stages
-  description: Learn about multistage pipelines in Azure Pipelines. Also, learn about the typical deployment stages for Bicep code.
-  ms.date: 10/31/2022
-  author: mumian
-  ms.author: jgao
-  ms.topic: unit
-  ms.custom:
-    - devx-track-bicep
-durationInMinutes: 7
-content: |
-  [!include[](includes/2-understand-pipeline-stages.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azure.test-bicep-code-using-azure-pipelines.understand-pipeline-stages
+title: Understand pipeline stages
+metadata:
+  unitType: learning-content
+  title: Understand pipeline stages
+  description: Learn about multistage pipelines in Azure Pipelines. Also, learn about the typical deployment stages for Bicep code.
+  ms.date: 05/29/2025
+  author: mumian
+  ms.author: jgao
+  ms.topic: unit
+  ms.custom:
+    - devx-track-bicep
+durationInMinutes: 7
+content: |
+  [!include[](includes/2-understand-pipeline-stages.md)]
+

learn-pr/azure/test-bicep-code-using-azure-pipelines/3-lint-validate-bicep-code.yml

@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.azure.test-bicep-code-using-azure-pipelines.lint-validate-bicep-code
-title: Lint and validate your Bicep code
-metadata:
-  unitType: learning-content
-  title: Lint and validate your Bicep code
-  description: Learn about linting and validating your Bicep code in a deployment pipeline.
-  ms.date: 10/31/2022
-  author: mumian
-  ms.author: jgao
-  ms.topic: unit
-  ms.custom:
-    - devx-track-bicep
-  zone_pivot_groups: azure-shell-interface
-durationInMinutes: 5
-content: |
-  [!include[](includes/3-lint-validate-bicep-code.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azure.test-bicep-code-using-azure-pipelines.lint-validate-bicep-code
+title: Lint and validate your Bicep code
+metadata:
+  unitType: learning-content
+  title: Lint and validate your Bicep code
+  description: Learn about linting and validating your Bicep code in a deployment pipeline.
+  ms.date: 05/29/2025
+  author: mumian
+  ms.author: jgao
+  ms.topic: unit
+  ms.custom:
+    - devx-track-bicep
+  zone_pivot_groups: azure-shell-interface
+durationInMinutes: 5
+content: |
+  [!include[](includes/3-lint-validate-bicep-code.md)]
+

learn-pr/azure/test-bicep-code-using-azure-pipelines/4-exercise-set-up-environment.yml

@@ -1,18 +1,18 @@
-### YamlMime:ModuleUnit
-uid: learn.azure.test-bicep-code-using-azure-pipelines.exercise-set-up-environment
-title: Exercise - Set up your environment
-metadata:
-  unitType: exercise
-  title: Exercise - Set up your environment
-  description: Configure your environment to add tests to your Bicep deployment pipeline.
-  ms.date: 10/31/2022
-  author: mumian
-  ms.author: jgao
-  ms.topic: unit
-  ms.custom:
-    - devx-track-bicep
-  zone_pivot_groups: azure-shell-interface
-durationInMinutes: 4
-content: |
-  [!include[](includes/4-exercise-set-up-environment.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azure.test-bicep-code-using-azure-pipelines.exercise-set-up-environment
+title: Exercise - Set up your environment
+metadata:
+  unitType: exercise
+  title: Exercise - Set up your environment
+  description: Configure your environment so you can add tests to your Bicep deployment pipeline.
+  ms.date: 05/29/2025
+  author: mumian
+  ms.author: jgao
+  ms.topic: unit
+  ms.custom:
+    - devx-track-bicep
+  zone_pivot_groups: azure-shell-interface
+durationInMinutes: 4
+content: |
+  [!include[](includes/4-exercise-set-up-environment.md)]
+

learn-pr/azure/test-bicep-code-using-azure-pipelines/5-exercise-add-lint-validate-stages-pipeline.yml

@@ -1,17 +1,17 @@
-### YamlMime:ModuleUnit
-uid: learn.azure.test-bicep-code-using-azure-pipelines.exercise-add-lint-validate-stages-pipeline
-title: Exercise - Add lint and validate stages to your pipeline
-metadata:
-  unitType: exercise
-  title: Exercise - Add lint and validate stages to your pipeline
-  description: Add Bicep linting and preflight validation to your Bicep deployment pipeline.
-  ms.date: 10/31/2022
-  author: mumian
-  ms.author: jgao
-  ms.topic: unit
-  ms.custom:
-    - devx-track-bicep
-durationInMinutes: 3
-content: |
-  [!include[](includes/5-exercise-add-lint-validate-stages-pipeline.md)]
-
+### YamlMime:ModuleUnit
+uid: learn.azure.test-bicep-code-using-azure-pipelines.exercise-add-lint-validate-stages-pipeline
+title: Exercise - Add lint and validate stages to your pipeline
+metadata:
+  unitType: exercise
+  title: Exercise - Add lint and validate stages to your pipeline
+  description: Add Bicep linting and preflight validation to your Bicep deployment pipeline.
+  ms.date: 05/30/2025
+  author: mumian
+  ms.author: jgao
+  ms.topic: unit
+  ms.custom:
+    - devx-track-bicep
+durationInMinutes: 3
+content: |
+  [!include[](includes/5-exercise-add-lint-validate-stages-pipeline.md)]
+