continuous-integrationazure-devopsnugetazure-pipelinessemantic-versioning

Azure Pipeline Nuget Package Versioning Scheme, How to Get "1.0.$(Rev:r)"


I'm setting up an Azure Pipelines build that needs to package a C# .NET class library into a NuGet package.

In this documentation, it lists a couple different ways to automatically generate SemVer strings. In particular, I want to implement this one:

$(Major).$(Minor).$(rev:.r), where Major and Minor are two variables defined in the build 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 in the build pipeline.

But that's all they say about it, no example is provided. A link to learn more takes you to this documentation, where it says this:

For byBuildNumber, the version will be set to the build number, ensure that your build number is a proper SemVer e.g. 1.0.$(Rev:r). If you select byBuildNumber, the task will extract a dotted version, 1.2.3.4 and use only that, dropping any label. To use the build number as is, you should use byEnvVar as described above, and set the environment variable to BUILD_BUILDNUMBER.

Again, no example is provided. It looks like I want to use versioningScheme: byBuildNumber, but I'm not quite sure how to set the build number, I think it pulls it from the BUILD_BUILDNUMBER environment variable, but I can't find a way to set environment variables, only script variables. Furthermore, am I suppose to just set that to 1.0.$(Rev:r), or to $(Major).$(Minor).$(rev:.r)? I'm afraid that would just interpret it literally.

Googling for the literal string "versioningScheme: byBuildNumber" returns a single result... Does anyone have a working azure-pipelines.yml with this versioning scheme?


Solution

  • byBuildNumber uses the build number you define in your YAML with the name field.

    Ex: name: $(Build.DefinitionName)-$(date:yyyyMMdd)$(rev:.r)

    So if you set your build format to name: 1.0.$(rev:.r), it should work as you expect.