How to proper replicate a version from the past?

[Pyth0ff]

I'm currently trying to replicate a version from the past, if I checkout a version tag from the past in the CI pipeline. Unfortunately the output is different.

Using the next-version with the /overrideconfig option looks very close, but only the branch name is wrong. Can I somehow override the branch name in a similar fashion like the version? Or is their even another way to handle the scenario of replicating a version form the past? I hope that somebvody can guide me a little bit on that topic. 😅

I already thought shortly about to perform a git reset --hard <tag> and than calculate the version number with gitversion, but I think this only works well, if a tags are created on the same branch and might require some additional logic in my CI pipeline, if other jobs also performing operations based on the history, like the changelog generation.

My current configuration looks like that:

mode: Mainline
assembly-versioning-scheme: MajorMinor
assembly-file-versioning-scheme: MajorMinorPatchTag
major-version-bump-message: "^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\\([\\w\\s]*\\))?(!:|:.*\\n\\n((.+\\n)+\\n)?BREAKING CHANGE:\\s.+)"
minor-version-bump-message: "^(feat)(\\([\\w\\s]*\\))?:"
patch-version-bump-message: "^(build|chore|ci|docs|fix|perf|refactor|revert|style|test)(\\([\\w\\s]*\\))?:"

Current output

{
  "Major": 1,
  "Minor": 11,
  "Patch": 0,
  "PreReleaseTag": "-no-branch-.1",
  "PreReleaseTagWithDash": "--no-branch-.1",
  "PreReleaseLabel": "-no-branch-",
  "PreReleaseLabelWithDash": "--no-branch-",
  "PreReleaseNumber": 1,
  "WeightedPreReleaseNumber": 1,
  "BuildMetaData": null,
  "BuildMetaDataPadded": "",
  "FullBuildMetaData": "Branch.-no-branch-.Sha.a9c318a443614dad190a6240b123e77c5aa6cb36",
  "MajorMinorPatch": "1.11.0",
  "SemVer": "1.11.0--no-branch-.1",
  "LegacySemVer": "1.11.0--no-branch-1",
  "LegacySemVerPadded": "1.11.0--no-branch-0001",
  "AssemblySemVer": "1.11.0.0",
  "AssemblySemFileVer": "1.11.0.1",
  "FullSemVer": "1.11.0--no-branch-.1",
  "InformationalVersion": "1.11.0--no-branch-.1+Branch.-no-branch-.Sha.a9c318a443614dad190a6240b123e77c5aa6cb36",
  "BranchName": "(no branch)",
  "EscapedBranchName": "-no-branch-",
  "Sha": "a9c318a443614dad190a6240b123e77c5aa6cb36",
  "ShortSha": "a9c318a",
  "NuGetVersionV2": "1.11.0--no-branch-0001",
  "NuGetVersion": "1.11.0--no-branch-0001",
  "NuGetPreReleaseTagV2": "-no-branch-0001",
  "NuGetPreReleaseTag": "-no-branch-0001",
  "VersionSourceSha": "a14ea3581969ff830ed01b8dac8496c8c532d676",
  "CommitsSinceVersionSource": 1,
  "CommitsSinceVersionSourcePadded": "0001",
  "UncommittedChanges": 0,
  "CommitDate": "2023-02-07"
}

Current with next-version

{
  "Major": 1,
  "Minor": 10,
  "Patch": 0,
  "PreReleaseTag": "",
  "PreReleaseTagWithDash": "",
  "PreReleaseLabel": "",
  "PreReleaseLabelWithDash": "",
  "PreReleaseNumber": null,
  "WeightedPreReleaseNumber": 60000,
  "BuildMetaData": null,
  "BuildMetaDataPadded": "",
  "FullBuildMetaData": "Branch.-no-branch-.Sha.a9c318a443614dad190a6240b123e77c5aa6cb36",
  "MajorMinorPatch": "1.10.0",
  "SemVer": "1.10.0",
  "LegacySemVer": "1.10.0",
  "LegacySemVerPadded": "1.10.0",
  "AssemblySemVer": "1.10.0.0",
  "AssemblySemFileVer": "1.10.0.0",
  "FullSemVer": "1.10.0",
  "InformationalVersion": "1.10.0+Branch.-no-branch-.Sha.a9c318a443614dad190a6240b123e77c5aa6cb36",
  "BranchName": "(no branch)",
  "EscapedBranchName": "-no-branch-",
  "Sha": "a9c318a443614dad190a6240b123e77c5aa6cb36",
  "ShortSha": "a9c318a",
  "NuGetVersionV2": "1.10.0",
  "NuGetVersion": "1.10.0",
  "NuGetPreReleaseTagV2": "",
  "NuGetPreReleaseTag": "",
  "VersionSourceSha": "a9c318a443614dad190a6240b123e77c5aa6cb36",
  "CommitsSinceVersionSource": 0,
  "CommitsSinceVersionSourcePadded": "0000",
  "UncommittedChanges": 0,
  "CommitDate": "2023-02-07"
}

Expected

{
  "Major": 1,
  "Minor": 10,
  "Patch": 0,
  "PreReleaseTag": "",
  "PreReleaseTagWithDash": "",
  "PreReleaseLabel": "",
  "PreReleaseLabelWithDash": "",
  "PreReleaseNumber": null,
  "WeightedPreReleaseNumber": 60000,
  "BuildMetaData": null,
  "BuildMetaDataPadded": "",
  "FullBuildMetaData": "Branch.main.Sha.a9c318a443614dad190a6240b123e77c5aa6cb36",
  "MajorMinorPatch": "1.10.0",
  "SemVer": "1.10.0",
  "LegacySemVer": "1.10.0",
  "LegacySemVerPadded": "1.10.0",
  "AssemblySemVer": "1.10.0.0",
  "AssemblySemFileVer": "1.10.0.0",
  "FullSemVer": "1.10.0",
  "InformationalVersion": "1.10.0+Branch.main.Sha.a9c318a443614dad190a6240b123e77c5aa6cb36",
  "BranchName": "main",
  "EscapedBranchName": "main",
  "Sha": "a9c318a443614dad190a6240b123e77c5aa6cb36",
  "ShortSha": "a9c318a",
  "NuGetVersionV2": "1.10.0",
  "NuGetVersion": "1.10.0",
  "NuGetPreReleaseTagV2": "",
  "NuGetPreReleaseTag": "",
  "VersionSourceSha": "a9c318a443614dad190a6240b123e77c5aa6cb36",
  "CommitsSinceVersionSource": 0,
  "CommitsSinceVersionSourcePadded": "0000",
  "UncommittedChanges": 0,
  "CommitDate": "2023-02-07"
}

[asbjornu]

To be able to fully replicate the same version number, you would have to do the following:

1. Ensure that the same branch is being built on the same commit. This means you need to do git checkout <branch> and git reset --hard <commit-id> to force <branch> back in time to point to <commit-id>.
2. Ensure that you use the same version of GitVersion as you did back when <commit-id> was built.

Please try that and report back your results.

[Pyth0ff]

The described solution worked mainly for me, but I had to set the next-version statement to workaround the issue that the git tag was taken as a pre-release tag. If I can improve that I would be happy, but the current solution already satisfies me.