Publish NuGet packages with Azure Pipelines (YAML/Classic)

TFS 2017

In Azure Pipelines, you can use the classic editor or the YAML tasks to publish your NuGet packages within your pipeline, to your Azure Artifacts feed, or to public registries such as nuget.org.

Create a NuGet package

There are various ways to create your NuGet packages such as using Visual Studio to pack your NuGet packages. If you're already using MSBuild or some other task to create your packages, skip this section and jump to the publish packages section.

YAML

YAML is not supported in TFS.

Classic

From your pipeline definition, add the NuGet task to your pipeline to create a NuGet package. Make sure to add this task below the one building your application and above any tasks that require your NuGet package.

• Command: the NuGet command to run.
• Path to csproj or nuspec file(s) to pack: pattern to search for csproj directories to pack.
• Configuration to package: when using a csproj file this specifies the configuration to package.
• Package folder: directory where packages will be created.

Package versioning

NuGet packages are identified by their names and version numbers. A recommended approach to versioning your packages is to use Semantic Versioning. Semantic versions have three numeric components: Major, Minor, and Patch.

The patch is usually incremented after fixing a bug (E.g. 1.0.0 -> 1.0.1). When you release a new backward-compatible feature, you increment the minor version and reset the patch version to 0 (E.g. 1.4.17 -> 1.5.0). When you make a backward-incompatible change, you increment the major version and reset the minor and patch versions to 0 (E.g. 2.6.5 -> 3.0.0).

With Semantic Versioning, you can also use prerelease labels to tag your packages. To use prelease labels, enter a hyphen followed by whatever letter(s) or number(s) you choose: E.g.1.0.0-beta.

Semantic Versioning is supported in Azure Pipelines and can be configured in your NuGet task:

• Use the same versioning scheme for your builds and packages:

  • $(Major).$(Minor).$(rev:.r), where Major and Minor are two variables defined in your pipeline. This format will automatically increment the build number and the package version with a new patch number. It will keep the major and minor versions constant, until you change them manually.
  • $(Major).$(Minor).$(Patch).$(date:yyyyMMdd), where Major, Minor, and Patch are variables defined in your pipeline. This format will create a new prerelease label for the build and package while keeping the major, minor, and patch versions constant.

• Use a custom versioning scheme. You can customize the major, minor, and patch versions for your packages and let the NuGet task generate a unique prerelease label based on the date and time.

• Use a script in your build pipeline to generate the version.

YAML

YAML is not supported in TFS.

Classic

From the NuGet task in your pipeline definition, select Pack options, and then select your preferred Automatic package versioning.

Note

DotNetCore and DotNetStandard packages should be packaged with the DotNetCoreCLI@2 task to avoid System.InvalidCastExceptions. See the .NET Core CLI task for more details.

task: DotNetCoreCLI@2
inputs:
    command: pack
    versioningScheme: byPrereleaseNumber
    majorVersion: '$(Major)'
    minorVersion: '$(Minor)'
    patchVersion: '$(Patch)'

Publish a package

To publish packages to an Azure Artifacts feed from your pipeline, you must set the Project Collection Build Service identity to be a Contributor on your feed. See Configure feed settings for more details.

YAML

YAML is not supported in TFS.

Classic

To publish NuGet packages with Azure Pipelines, add the NuGet task to your pipeline definition and configure it as follows:

• Command: the NuGet command to run.
• Path to NuGet package(s) to publish:the pattern to match or path to nupkg files to be uploaded.
• Target feed location: You can publish to your current organization or an external NuGet server.
• Target feed: Select the feed that you want to publish to.

Note

If you are running TFS Update 2 or older, Nuget is not a service endpoint option. You must use the Generic service connection.

Related articles

• Publish npm packages with Azure Pipelines
• Publish and download Universal Packages in Azure Pipelines
• Releases in Azure Pipelines
• Release artifacts and artifact sources