GitTools/GitVersion

Use convention to derive a SemVer product version from a GitFlow based repository

Gary Ewan Park

@gep13

@PepekT You would create a tag 0.1.0-beta1 and then it should increment

Josef Trejbal

@PepekT

@gep13 So release branch should increment per tag right?

Gary Ewan Park

@gep13

That is how I have always done it.

Trent Scholl

@TrentScholl

Hoping somebody can point out what I'm doing wrong here...
I'm using ContinuousDeployment mode for this flow
Commit to master and run gitversion, it outputs 1.1.0-ci.0
Create a release branch (release/v1.1) from master and run gitversion, it outputs v1.1.0-beta.0
Tag the HEAD commit of release/v1.1 and run gitversion on the tag, ERROR

It looks like the branch being examined is a detached Head pointing to commit '88e98c4'. Without a proper branch name GitVersion cannot determine the build version.

According to the documentation gitversion should just use the tag name and not try to figure out a branch?

Kim J. Nordmo

@AdmiringWorm

@TrentScholl gitversion need the full git history, which is what I assume is causing the problem that you are seeing.
Are you running on a CI server? If so which one?

Trent Scholl

@TrentScholl

Running locally

Kim J. Nordmo

@AdmiringWorm

I see, in that case it sounds more like a bug to me. Not sure how you would be able to work around it though, unfortunately.

leyshon

@leyshon

I thought the metadata of the version number was able to increment a number each time a build ran but this doesn't seem to be the case. Did it used to be and changed? Or am I doing something wrong? Or is this just something that never occurred?

pfaustinopt

@pfaustinopt

Hello,

To have GitVersion working on Azure DevOps am I supposed to install the NuGet Package? The documentation is confusing, it says "either using the Command Line build step or install an extension / custom build step" but the 1st step on "Executing GitVersion" is to install the NuGet package.

Patrick B

@PatrickBig

I'm a bit interested in that well. I just started reading up on gitversion and use ADO

But, I joined gitter to ask specifically about monorepos.

I have a large monorepo that I would like to try and tackle if possible. I see some mention of using tag prefixes.

Lets say I have the following

SuperSolution\
\SuperLibraryThing (NuGet package)
\AnotherLibraryThing (NuGet package)
\SuperApp (ASP.NET Core web app)

I assume I would potentially have a different GitVersion.yml in each of those folders, and I would perhaps set tag-prefix: superlibrarything for the first GitConfig.yml, tag-prefix: anotherlibrarything, for the second, etc

Gary Ewan Park

@gep13

@PatrickBig GitVersion asserts a single set of Version Numbers for the entire repository. It doesn't have any concept of asserted different version numbers of different folders within the repository.

Patrick B

@PatrickBig

I see :( That is a bit of a bummer. Any known plans for enhancing that or am I using an unusual pattern

Gary Ewan Park

@gep13

GitVersion uses the history of the entire git repository to make an assertion about the current version number associated with the contents of that repository. As such, no, there are no plans to change away from this.

In terms of usage of GitVersion, the best suggestion would be to move the different pieces of your application, that you want to version separately, into their own repositories.

Patrick B

@PatrickBig

Does anyone have any examples of applying this to .NET Core projects? I am using the task in Azure DevOps. Will it automatically update my csproj information? There is a checkbox item for "Update AssemblyInfo files" which don't exist anymore by default. Do we specify the csproj instead?

Jorge E. Alvarez

@jealvarez

i would like to install it in ubuntu, do you know what do i need to do?

thanks

Kim J. Nordmo

@AdmiringWorm

@jealvarez easiest way would be through .NET Core
dotnet tool install --global gitversion.tool (this is the only one that is cross-platform compatible now AFAIK)

Jorge E. Alvarez

@jealvarez

thank you @AdmiringWorm

pfaustinopt

@pfaustinopt

@PatrickBig you should had the following to your YAML:
variables:
GitVersion.SemVer: ''
GitVersion.AssemblySemVer: ''
GitVersion.MajorMinorPatch: ''
GitVersion.InformationalVersion: ''

steps:

task: gitversion/setup@0
inputs:
versionSpec: '5.x'
displayName: 'GitVersion setup'
task: gitversion/execute@0
displayName: 'GitVersion execute'
task: DotNetCoreCLI@2
displayName: 'dotnet build'
inputs:
command: 'build'
projects: '$(project)'
arguments: '/p:Version=$(GitVersion.SemVer)
/p:AssemblyVersion=$(GitVersion.AssemblySemVer)
/p:FileVersion=$(GitVersion.MajorMinorPatch)
/p:InformationalVersion=$(GitVersion.InformationalVersion)
--configuration $(buildConfiguration)'

Colin Laws

@ColinLaws

Hello GitVersion warriors! I am currently working on implementing GitFlow at our company, and there is a lot of confusion here surrounding GitVersion.

mode: ContinuousDelivery
continuous-delivery-fallback-tag: ''
branches: {}
ignore:
  sha: []
merge-message-formats: {}

I created a tag 0.1.0 on master. Created hotfixes/0.1.1 from master.

At this point, GitVersion was correctly generating me 0.1.1-beta.1+70 (I had a lot of old commits behind this as I was testing).

I performed a commit to hotfixes/0.1.1, which GitVersion asserted as 0.1.1-beta.1+71. Perfect.

Then I created a tag of 0.1.1-beta.1 (I'm following the GitFlow example here https://gitversion.net/docs/git-branching-strategies/gitflow-examples#hotfix-branches)

Running GitVersion asserted 0.1.1-beta.1 as expected.

Colin Laws

@ColinLaws

I was ready to pull my changes to master. I created a PR of hotfixes/0.1.1 -> master. When running GitVersion on a build for my PR, I am seeing a version of 0.2.0.

Is this due to the fact that GitVersion is looking at what branch is currently checked out in Git, and as I am running in DevOps, my build pipeline is checking out the branch of my pull request to perform a build on that code.

So what I'm imagining going wrong here is that the pull requests branch refs/heads/pull/943/merge is not going to be providing GitVersion with an accurate history to work off of.

Colin Laws

@ColinLaws

Okay yes, I see the error in my ways. We do not care to even run GitVersion on pull requests, because there's nothing for us to do on PRs. The only reason GitVersion is running on PRs is because we have build validation as a branch policy.

Once we pull that change into master, you would tag master with 0.1.1, and then you'd want to have a release pipeline set up to identify a new tag based on master to release.

So for every release we do for testers on the release branch, we make a tag? Same on hotfix. We would make a hotfix branch, make a change, tag it (fires release), testers give feedback, etc.

David Perfors

@dnperfors

Good day, Is there a way to configure GitVersion to use only lowercase characters in the versions? We have an issue in our pipeline that some tasks will force lowercase version numbers for a package, but some bash scripts that use the same packages don't force lowecase.

Mattias Karlsson

@devlead

NuGetVersionV2 and NuGetPreReleaseTagV2 will always be lowercase. But looking att configuration doesn't seem to be any general case handling you can set
https://github.com/GitTools/GitVersion/blob/fd03acec2d8cea78acbf72e93a0dc48a495450b2/src/GitVersionCore/Model/Configuration/Config.cs#L11

David Perfors

@dnperfors

In our case we are not using NuGetVersionV2 nor NuGetPreReleaseTagV2, but the semver version. We use this version for tagging docker images.

Mattias Karlsson

@devlead

Ok in bash you can lowercase using ,,i.e.

version='AbAbAb'
echo ${version,,}

will output

ababab

so could potentially be a work around in scripts.

David Perfors

@dnperfors

That is indeed a workaround which currently works for me. Thanks for the help :) my bash skills are not that great yet ;)

ForteUnited

@ForteUnited

Hello! I'm using the gitversion/execute@0 in Azure Devops. I would like to get one of the gitversion outputs (SemVer) and set it to a variable in my pipeline for me to use later but I'm not sure how to accomplish this. Can anyone help?

Kim J. Nordmo

@AdmiringWorm

@ForteUnited you can get the giversion output by using ${{ steps.gitversion.outputs.semVer }}

assuming you have set the id of the step to gitversion

ForteUnited

@ForteUnited

ok got it. Thank you @AdmiringWorm

Patrick B

@PatrickBig

Hey all, I'm trying to get GitVersion to install on my build server (linux) but having some trouble. Most likely due to my proxy setup at the company I work at.
If I use the GitTools/setup task I get a timeout. Anything else that needs to reach the internet doesn't seem to have any problems. Any advise?

Another route I was trying to do was to just pre-install on the agent. But using

dotnet tool install -g GitVersion.Tool

Didn't seem to help

Where communities thrive

People

Repo info

Activity