JGit feature limitations
Platform Notice: Data Center Only - This article only applies to Atlassian apps 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
Our built-in JGit implementation of git is a long-deprecated feature in Bamboo. We are not planning to actively maintain it beyond the security fixes.
We highly recommend installing a compatible native Git client on both Bamboo nodes and remote agents to access all repository-related features in Bamboo, including native Bitbucket DC integration, creation of commits, pushing to the repository, modern SSH key types, and LFS support.
Our Elastic and Ephemeral agents come with the native git already installed and configured.
The following limitations apply:
The Bamboo JGit feature can only check out repositories.
It supports both full checkout and a shallow checkout of just the last commit from the specified branch
The LFS extension is not supported.
If a repository containing files managed by the LFS extension is checked out, the LFS pointers will not be replaced by the actual files.
The private keys used for checkout authentication need to be provided in PEM format. Keep in mind the OpenSSH or any other format will not work. Only the following types are accepted:
DSA (-----BEGINDSAPRIVATEKEY-----)
SSH-RSA (-----BEGINRSAPRIVATEKEY-----)
ECDSA (-----BEGINECPRIVATEKEY-----)
when linking a Bitbucket Cloud or Github repository, use their respective linked repository types.
when linking a repository hosted on Bitbucket Data Center or Server and any other source, use the standard Git Repository type.
An attempt to access the Bitbucket DC or Server repository using the Bitbucket/Stash repository type will fail. The type of key we use to authorize Bamboo with Bitbucket DC using the application links is not supported by our built-in JGit feature.
Was this helpful?