Git operation fails with error JGit implementation does not support merging or tagging
Note:
This KB article is applicable for all Bamboo versions before 7.1. JGit is deprecated since Bamboo 6.8 as announced here and has been fully removed in Bamboo 7.1.
Problem
Git checkout task fails with the following error in atlassian-bamboo.log:
java.lang.RuntimeException: java.lang.UnsupportedOperationException: JGit implementation does not support merging, please use native Git
Repository Tag task fails with the following error in atlassian-bamboo.log
Repository Tag task fails: java.lang.UnsupportedOperationException: Creating tags is not supported with JGit, please use native Git instead
Cause
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