TeamCity 2019.1 Help

.NET CLI (dotnet)

TeamCity comes with built-in support of .NET CLI toolchain providing .NET CLI (dotnet) build steps, CLI detection on the build agents, and auto-discovery of build steps in your repository.

This page provides details on configuring the .NET CLI (dotnet) runner. Also see the related blog post.

  • .NET Core SDK has to be installed on your build agent machines.

  • The .NET CLI tools path has to be added to the PATH environment variable. You can also configure the DOTNET_HOME environment variable for your TeamCity build agent user, for example, DOTNET_HOME=C:\Program Files\dotnet\

Option

Description

Command

Select a dotnet command from the drop-down. Depending on the selected command, some of the options below will vary. The currently supported commands are:

Projects

Specify paths to projects and solutions. Wildcards are supported. Parameter references are supported. If you have a finished build, you can use the file/directory chooser here.

Working directory

Optional, set if differs from the checkout directory. Parameter references are supported. If you have a finished build, you can use the file/directory chooser here.

Framework

Specify the target framework, for example, netcoreapp or netstandard. Parameter references are supported.

Configuration

Specify the target configuration, for example, Release or Debug. Parameter references are supported.

Runtime

Specify the target runtime. Parameter references are supported.

Output directory

The directory where to place outputs. Parameter references are supported. If you have a finished build, you can use the file/directory selector here.

Version suffix

Defines the value of the $(VersionSuffix) property in the project. Parameter references are supported.

Command line parameters

Enter additional command line parameters for dotnet.

Logging verbosity

Select from the <Default>, Minimal, Normal, Detailed or Diagnostic.

Docker Settings

Since TeamCity 2018.1, the .NET CLI build step can be run in a specified Docker container.

Code Coverage

JetBrains dotCover is supported as a coverage tool for the msbuild, test, and vstest commands.

Authentication in private NuGet Feeds

TeamCity allows you to authenticate using private NuGet feeds. Read more in NuGet.

Parameters Reported by Agent

When starting, the build agent reports the following parameters:

Parameter

Description

DotNetCLI

The .NET CLI version

DotNetCLI_Path

The path to .NET CLI executable

DotNetCoreSDKx.x_Path

The .NET Core SDK version