Skip to content

Commit c5f36fc

Browse files
Merge pull request #8014 from MicrosoftDocs/users/jukullam/update-customize-asp
Update outdated task references in build-aspnet-4.md, customize-python.md, and customize-pipeline.md
2 parents a42cb93 + dac486d commit c5f36fc

File tree

3 files changed

+16
-17
lines changed

3 files changed

+16
-17
lines changed

docs/pipelines/apps/aspnet/build-aspnet-4.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ https://github.com/Azure-Samples/app-service-web-dotnet-get-started
3434

3535
Once you have the sample code in your own repository, create a pipeline in your Azure DevOps project by using the instructions in [Create your first pipeline](../../create-first-pipeline.md).
3636

37-
Select the **ASP.NET** template. This choice automatically adds the *azure-pipelines.yml* file with the tasks required to build the code to the sample repository. The template includes the VSTest@2 task to run tests. The sample repository doesn't contain tests, so you can remove the VSTest@2 task from the pipeline.
37+
Select the **ASP.NET** template. This choice automatically adds the *azure-pipelines.yml* file with the tasks required to build the code to the sample repository. The template includes the VSTest@3 task to run tests. The sample repository doesn't contain tests, so you can remove the VSTest@3 task from the pipeline.
3838

3939
Your pipeline should look like the following example:
4040

docs/pipelines/customize-pipeline.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,15 @@ ms.assetid: b3a9043e-aa64-4824-9999-afb2be72f141
77
ms.manager: jepling
88
ms.author: vijayma
99
author: vijayma
10-
ms.date: 08/17/2023
10+
ms.date: 06/09/2025
1111
monikerRange: "<=azure-devops"
1212
---
1313

1414
# Customize your pipeline
1515

1616
[!INCLUDE [version-gt-eq-2019](../includes/version-gt-eq-2019.md)]
1717

18-
This is a step-by-step guide on common ways to customize your pipeline.
18+
This article is a step-by-step guide on common ways to customize your pipeline.
1919

2020
## Prerequisite
2121

@@ -25,7 +25,7 @@ Follow instructions in [Create your first pipeline](create-first-pipeline.md) to
2525

2626
A pipeline is defined using a YAML file in your repo. Usually, this file is named `azure-pipelines.yml` and is located at the root of your repo.
2727

28-
Navigate to the **Pipelines** page in Azure Pipelines, select the pipeline you created, and choose **Edit** in the context menu of the pipeline to open the YAML editor for the pipeline.
28+
Go to the **Pipelines** page in Azure Pipelines, select the pipeline you created, and select **Edit** in the context menu of the pipeline to open the YAML editor.
2929

3030
> [!NOTE]
3131
> For instructions on how to view and manage your pipelines in the Azure DevOps portal, see [View and manage your pipelines](create-first-pipeline.md#view-and-manage-your-pipelines).
@@ -56,7 +56,7 @@ Examine the contents of the YAML file.
5656
> The contents of your YAML file may be different depending on the sample repo you started with, or upgrades made in Azure Pipelines.
5757
5858
59-
This pipeline runs whenever your team pushes a change to the main branch of your repo or creates a pull request. It runs on a Microsoft-hosted Linux machine. The pipeline process has a single step, which is to run the Maven task.
59+
The pipeline runs whenever your team pushes a change to the main branch of the repo or creates a pull request. It runs on a Microsoft-hosted Linux machine. The pipeline process has a single step, which is to run the Maven task.
6060
6161
## Change the platform to build on
6262
@@ -71,7 +71,7 @@ You can build your project on [Microsoft-hosted agents](../pipelines/agents/host
7171
vmImage: "ubuntu-latest"
7272
```
7373
74-
* To choose a different platform like Windows or Mac, change the `vmImage` value:
74+
* To switch to a different platform like Windows or Mac, change the `vmImage` value:
7575

7676
```yaml
7777
pool:
@@ -94,12 +94,11 @@ You can add more **scripts** or **tasks** as steps to your pipeline. A task is a
9494
* Add the following snippet to the end of your YAML file.
9595

9696
```yaml
97-
- task: PublishCodeCoverageResults@1
97+
- task: PublishCodeCoverageResults@2
9898
inputs:
99-
codeCoverageTool: "JaCoCo"
100-
summaryFileLocation: "$(System.DefaultWorkingDirectory)/**/site/jacoco/jacoco.xml"
101-
reportDirectory: "$(System.DefaultWorkingDirectory)/**/site/jacoco"
102-
failIfCoverageEmpty: true
99+
summaryFileLocation: "$(System.DefaultWorkingDirectory)/**/site/jacoco/jacoco.xml" # Path to summary files
100+
reportDirectory: "$(System.DefaultWorkingDirectory)/**/site/jacoco" # Path to report directory
101+
failIfCoverageEmpty: true # Fail if code coverage results are missing
103102
```
104103

105104
* Select **Save** and then confirm the changes.
@@ -249,7 +248,7 @@ From the **Pipeline settings** pane you can configure the following settings.
249248
* **Paused** pipelines allow run requests to be processed, but those requests are queued without actually starting. When new request processing is enabled, run processing resumes starting with the first request in the queue.
250249
* **Disabled** pipelines prevent users from starting new runs. All triggers are also disabled while this setting is applied. All build policies using a disabled pipeline will show "Unable to queue Build" message next to the build policy in the PR overview window and the status of the build policy will be broken.
251250
* **YAML file path** - If you ever need to direct your pipeline to use a different YAML file, you can specify the path to that file. This setting can also be useful if you need to move/rename your YAML file.
252-
* **Automatically link work items included in this run** - The changes associated with a given pipeline run may have work items associated with them. Select this option to link those work items to the run. When **Automatically link work items included in this run** is selected, you must specify either a specific branch, or `*` for all branches, which is the default. If you specify a branch, work items are only associated with runs of that branch. If you specify `*`, work items are associated for all runs.
251+
* **Automatically link work items included in this run** - The changes associated with a given pipeline run might have work items associated with them. Select this option to link those work items to the run. When **Automatically link work items included in this run** is selected, you must specify either a specific branch, or `*` for all branches, which is the default. If you specify a branch, work items are only associated with runs of that branch. If you specify `*`, work items are associated for all runs.
253252

254253
:::image type="content" source="media/customize-pipeline/link-work-items.png" alt-text="Screenshot of setting to automatically link work items included in this run.":::
255254

@@ -267,7 +266,7 @@ To support security of your pipeline operations, you can add users to a built-in
267266

268267
::: moniker range="azure-devops"
269268

270-
YAML pipelines don't have a [Create work item on failure](build/options.md#create-a-work-item-on-failure) setting like classic build pipelines. Classic build pipelines are single stage, and **Create work item on failure** applies to the whole pipeline. YAML pipelines can be multi-stage, and a pipeline level setting may not be appropriate. To implement **Create work item on failure** in a YAML pipeline, you can use methods such as the [Work Items - Create](/rest/api/azure/devops/wit/work-items/create) REST API call or the Azure DevOps CLI [az boards work-item create](/cli/azure/boards/work-item#az-boards-work-item-create) command at the desired point in your pipeline.
269+
YAML pipelines don't have a [Create work item on failure](build/options.md#create-a-work-item-on-failure) setting like classic build pipelines. Classic build pipelines are single stage, and **Create work item on failure** applies to the whole pipeline. YAML pipelines can be multi-stage, and a pipeline level setting may not be appropriate. To implement **Create work item on failure** in a YAML pipeline, you can use methods such as the [Work Items - Create](/rest/api/azure/devops/wit/work-items/create) REST API call, or the Azure DevOps CLI [az boards work-item create](/cli/azure/boards/work-item#az-boards-work-item-create) command at the desired point in your pipeline.
271270

272271
The following example has two jobs. The first job represents the work of the pipeline, but if it fails, the second job runs, and creates a bug in the same project as the pipeline.
273272

docs/pipelines/ecosystems/customize-python.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Customize Python pipelines
33
description: See how to use Azure Pipelines to customize, build, test, package, and deliver Python apps and code.
44
ms.topic: conceptual
55
ms.custom: devx-track-python
6-
ms.date: 07/12/2024
6+
ms.date: 06/09/2025
77
monikerRange: '<= azure-devops'
88
---
99

@@ -12,7 +12,7 @@ monikerRange: '<= azure-devops'
1212
This article describes how to customize building, testing, packaging, and delivering Python apps and code in Azure Pipelines. To create your first pipeline with Python, see the [Python quickstart](python.md).
1313

1414
::: moniker range=">=azure-devops"
15-
With [Microsoft-hosted agents](../agents/hosted.md) in Azure Pipelines, you can build your Python apps without having to set up your own infrastructure. Tools that you commonly use to build, test, and run Python apps, including `pip`, are preinstalled.
15+
With [Microsoft-hosted agents](../agents/hosted.md) in Azure Pipelines, you can build Python apps without setting up your own infrastructure. Tools that you commonly use to build, test, and run Python apps, including `pip`, are preinstalled.
1616

1717
You might need to [request the free grant of parallel jobs](https://aka.ms/azpipelines-parallelism-request) or purchase a [parallel job](../licensing/concurrent-jobs.md) to run your pipelines.
1818
::: moniker-end
@@ -196,10 +196,10 @@ Add the [Publish code coverage results task](/azure/devops/pipelines/tasks/refer
196196

197197
## Package and deliver code
198198

199-
To authenticate with `twine`, use the [Python twine upload authenticate task](/azure/devops/pipelines/tasks/reference/twine-authenticate-v1) to store authentication credentials in the `PYPIRC_PATH` environment variable.
199+
Authenticate with `twine` by using the [Python twine upload authenticate task](/azure/devops/pipelines/tasks/reference/twine-authenticate-v1) to store authentication credentials in the `PYPIRC_PATH` environment variable.
200200

201201
```yaml
202-
- task: TwineAuthenticate@0
202+
- task: TwineAuthenticate@1
203203
inputs:
204204
artifactFeed: '<Azure Artifacts feed name>'
205205
pythonUploadServiceConnection: '<twine service connection from external organization>'

0 commit comments

Comments
 (0)