Diagnostic Tasks for Build and Release.

This extension provides diagnostic tasks to help you diagnose and profile build or release definitions. With these tasks, you can gather information (such as variable values) and troubleshoot common issues during the different stages of your pipeline.

Usage

Currently, this extension has the following tasks:

• Add Build Tag - Add a tag for the current build.
• Attach Summary Markdown - Upload and attach summary markdown section to the current timeline record.
• Log Variables - Log predefined variables provided by Build or Release Management to the console.
• Set Variable - Sets a variable to be exposed to the following tasks as an environment variable.
• Update Build Number - Update the build number for the current build.

Add Build Tag

Builds can be tagged for easy searching. This task adds a tag for the current build. The following options are available:

• Tag - The tag to add to the build.

Attach Summary Markdown

Markdown based sections can be added to both Build and Release summary pages. This task uploads and attach summary sections to the Build or Release timeline record. The following options are available:

• Section name - The summary section name.
• Markdown file path - Relative path from the repository root to the markdown file.

Log Variables

Team Build brings a number of predefined variables that can be used in build (and release) definitions and scripts. Variables are generated by the agent in the scope of a particular job (prior to it starting) or generated on the server side and sent to the agent as part of the job.

This task logs these variables to the console. The following options are available:

• Agent variables.
• Build variables.
• Common variables.
• Release variables.
• System variables.

Note: Variable values are automatically logged when a release is in progress (at the Logs hub) by Release Management.

Set Variable

This task sets a variable. The first task can set a variable, and following tasks are able to use the variable. The following options are available:

• Variable name - The name of the variable to be set.
• Variable value - The value to be set.

Update Build Number

This task updates the build number. It uses a logging command to emit the new number via standard output. The following options are available:

• Build number - The build number to be set for the current build.