actions: [ISSUE]: Azure Pipelines failing GitVersion 6.1 (no GitTools v4 released)
Edit: Active recommendation: Pin version 6.0.5 and use a tool like RenovateBot to handle updates.
- versionSpec: 6.x
+ versionSpec: 6.0.5
Prerequisites
- I have written a descriptive issue title
- I have searched issues to ensure it has not already been reported
GitVersion package
AzureDevops task
What are you seeing?
I see the error message
##[error]Version spec '6.x' resolved as '6.1.0' does not satisfy the range '>=5.2.0 <6.1.0'.See https://github.com/GitTools/actions/blob/main/docs/versions.md for more information.
That page (link) shows that I should be able to use GitTools 3.x, but maybe that I need 4.x
At time of writing, 4.x does not exist for ADO: https://marketplace.visualstudio.com/items?itemName=gittools.gittools&ssr=false#overview.
Version | 3.0.3.24112005
Last updated | 11/20/2024, 12:13:29 AM
What is expected?
I expect that my pipeline using GitVersion 6.x does not require a GitTools upgrade. (It was working, now it is broken with minor version release.) If this is not expected, please update documentation, at least the linked page.
Second, I expect that GitTools 4.x is available on Azure DevOps.
Steps to Reproduce
Something like
- Have an Azure DevOps project.
- Search marketplace for
GitTools. See that no 4.x exists. - Create an ADO pipeline, using GitVersion with versionSpec
6.x. See it fail.
Output log or link to your CI build (if appropriate).
N/A
About this issue
- Original URL
- State: closed
- Created 2 years ago
- Reactions: 19
- Comments: 16 (9 by maintainers)
v4 is not yet released, and 6.1.0 cannot be used yet. For now please use v6.0.5 as it’s not that different in terms of functionality. 6.1.0 it’s just dropping .net 6.0 and adding .net 9.0.
I will try my best documenting the
versions.mdfile with the current and planned changes (that’s why you see v4 which is planned)I will fix version file, it should be ‘>=5.2.0 <6.1.0’ for version v3
There is one issue I need to fix before releasing v4
I also would like to discuss the major version relationship, but I figured discussing after GitTools v4 landed on AzureDevOps might be more productive.
For now, I am taking https://github.com/GitTools/actions/issues/1378#issuecomment-2529574799 as the official recommendation (regardless of whether or not I agree).
So you did a critical dependency analysis on picking this dependency or is your company financially supporting the project? What is your point? Just fix it and wait for the release I’d say.
I would recommend to have a specific version pinned like 6.0.5 (like major.minor.patch) to avoid any potential issues and have a tool like dependabot or renovate automatically creating PRs with new version as they appear. The reason for that is those PRs will fail if there is anything wrong with the task/tool and that is not breaking the main pipelines. You merge only there is a successful build. So I’d avoid using 6.x.
A new GitTools version will be released whenever there is a new minor or major version of GitVersion or GitReleaseManager tools that require changes, or there are changes to the supported Agent versions for Azure Pipelines or GitHub Actions, or nodejs versions.
Thank you.
I have updated our primary pipeline to use
If possible, it would be helpful to learn why we needed a new GitTools version for underlying minor version change. Maybe it upgraded the .NET runtime? (I’m mostly wondering if I should use
6.xin the future, like I always used5.xor if that is wrong.)But this latter part can wait. Thank you for the prompt response and thank you for your contributions to GitTools!!
As others said, this is a breaking change. All of our pipelines are failing because a breaking change was introduced without a major version bump. The fix is simple, but spread out over various (critical) pipelines could have a big impact!
Please change to 6.0.x
Based on the documentation, shouldn’t any 3.x version of GitTools/actions support GitVersion 6.1.0? The error message in this ticket:
##[error]Version spec '6.x' resolved as '6.1.0' does not satisfy the range '>=5.2.0 <6.1.0'seems to reference the range for 2.x versions of GitTools/actions. Is this correct, or am I misunderstanding something?