Git operation fails with error JGit implementation does not support merging or tagging
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Note:
This KB article is applicable for all Bamboo versions before 7.1. JGit is deprecated since Bamboo 6.8 as announced hereand has been fully removed in Bamboo 7.1.
Problem
Git checkout task fails with the following error in atlassian-bamboo.log:
1
java.lang.RuntimeException: java.lang.UnsupportedOperationException: JGit implementation does not support merging, please use native GitRepository Tag task fails with the following error in atlassian-bamboo.log
1
Repository Tag task fails: java.lang.UnsupportedOperationException: Creating tags is not supported with JGit, please use native Git insteadCause
JGit is a Java library bundled with Bamboo that interacts with Git repositories when there is no native Git binary installed on the server and defined as a Server Capability. The bundled JGit isn't as feature rich or as performant and thus does not support Git merge or tagging.
Resolution
To use native Git instead of jGit, please do the following:
Install a Git binary on the Bamboo server and any remote agents that will need to use it.
Define it as a Server Capability at Bamboo Administration > Overview > Server Capabilities
For agents, you may verify if you have Git capability configured under their respective capabilities section as explained here: Configuring capabilities
Was this helpful?