Find answers to questions asked by Git Integration for Jira app users, workarounds and solutions to help you get up and running. Use the table of contents below to jump to a specific topic.
Feel free to contact our support team if you don’t see what you’re looking for.
On this page
- General
- Developer
- Installation and Setup
- Administration
- Repositories
- Workspace
- SSH
- Reindex
- Uninstall and Reinstall
- Purchase and Pricing
- Support
General
Frequently asked questions by users in general.
What is Git?
Git is a source code repository. Developers keep track of their source code using Git. Git relies heavily on branching and merging. Branching is making a temporary copy of source code for a single purpose like adding a particular feature or fixing a bug. Merging is safely moving the changes from one branch back to another.
What is this app?
This is Git Integration for Jira Cloud – an app for Jira that mashes together data from a Git server with your Jira Cloud. It let’s people see code from Git in context with Jira issues.
Why would I want to see Git in my Jira?
Git can be complicated and daunting – especially for non-developers. Jira users want this app so they can work with Git in the familiar Jira interface.
How do Git and Jira work together?
In organizations with Git and Jira, it is common to have a branch for each Jira issue and branches for every version.
When developers put their work in Git, they can include a Jira issue key in the comments. With the Git Integration for Jira app installed, Jira Cloud will then show the changes in the issue.
Is this safe? Will it cause trouble?
It is a safe and well-tested plugin.
We test this on huge Git repositories in large Jira instances. Over 5000 organizations in 70 countries use the Git Integration for Jira app.
Which version of Jira is compatible with Git for Jira Cloud app?
For a more comprehensive view, see Git Integration for Jira app Version History ».
Developer
Solutions targeted for developers.
How do Git commits get associated with a Jira issue?
On every Git commit, make sure the message includes the exact issue ID at the beginning of the text. The Git Integration for Jira Cloud app will automatically index new commits and associate the referenced issue.
To create a link between your Git commit and a Jira issue, developers must include the issue key into the commit comment.
Example git commit message:
“PROJ-913 - Plugin version change from 2.6.7 to 2.6.8“; where PROJ-913 is the issue key that links the commit message to the Jira issue.
How do I ensure people are following our organization’s process for source code?
Open the project summary in your browser and click on the Git Commits tab.
All changes that developers have submitted will be listed in reverse chronologically order. From this view, you can audit all of the changes that developers have recently submitted.
What will happen to commit associations if a Jira issue is moved to a new Jira project?
For GIJ Cloud users, moving Jira issues to a different project is not recommended, especially for repositories with extensive git commit histories. This is because associated git commits from the old project do not automatically transfer to the new project due to the different project key.
To manually associate git commits to a Jira issue in Jira Cloud:
- Go to Jira dashboard menu Apps ➜ Git Integration: Repository browser.
- Click a repository to work on. The list defaults to the Compare view.
- Click on the Commits tab.
- On the right of the list item, click on the edit
icon or the Link commit label to manage Jira issue association for the selected git commit. - Add, remove or change one or more Jira issue keys to assign the selected commit.
- Please note that manually linking git commits in this manner can only be done one at a time.
For Jira administrators planning to migrate from Jira Server/Data Center to Jira Cloud, please read this first – Export project from Jira Server to Jira Cloud.
When transitioning from Jira self-hosted to Jira Cloud, maintaining the same project name will retain all git commit associations after the migration.
Can the plugin be configured to handle or scan multiple keys for one project? How is this supposed to work?
Yes – the Git Integration for Jira Cloud app supports multiple Jira issue keys in a multiple-line commit message.
For more information, see Smart Commits ».
Installation and Setup
Solutions related to Git Integration for Jira Cloud app installation.
Does it take long to install?
No. With Atlassian Marketplace, you can install the app from inside of your JIRA Cloud using your browser.
I don’t know Git — what will I need to install the app?
For the most common setups, you will need the URL to your Git server and credentials to access it. Tell your Git administrator that you need access to the Git repository just like a regular developer would have. They will provide what you need.
What will my Jira look like after it is installed?
A new tab is added in each issue. A new tab is added in each project.
How do I install the plugin in a development version of Jira?
Atlassian has posted the following relevant information regarding Atlassian Marketplace addons and development licenses of Jira:
Which points to:
Licensing and Paid via Atlassian Listings
Go to the section titled, “Can customers use developer licenses for my add-on?”, which has instructions on how to get a developer license for add-ons.
A developer license can be generated (free of charge) once the plugin has been purchased and can only be installed on a development licensed version of Jira.
Administration
Questions and solutions targeted for administrators.
Does Jira+GitHub integration support multiple Jira projects (many) to multiple git repositories (many)? If it does not, how about many-to-one or one-to-many?
Yes — it does support repositories supporting many projects. That said, the associations are made by the developers when they commit code to a specific issue key (which is part of a project). The permission that allows a user to see these commits in a Jira project is whether they have the “View Development Tools” permission for that project (that’s a Jira setting).
Repositories
Solutions to common issues encountered while connecting and configuring git repositories.
We use GitBlit without SSH keys and use only HTTPS instead. Does Git Integration Plugin for Jira support this?
Yes. The Git Integration for Jira Cloud app definitely supports GitBlit via HTTPS authentication. Use the Plain git integration wizard to connect to your repositories. Towards the end of the process, a username and password will be required for connection authentication.
Workspace
Questions on Git Integration for Jira add-on user experience in Jira.
How do I see if work has really started on an issue?
Open an issue in your browser and click on the Git Commits tab.
If the tab says that no Git log entries have been found, then work has not yet started on the ticket.
See all Git commits associated with an issue in Jira
How do I see who has worked on an issue?
Open an issue in your browser and click on the Git Commits tab.
Everyone listed in the “Author/Committer” column has worked on the issue.
How do I see how long ago since someone worked on it?
Open an issue in your browser and click on the Git Commits tab.
All changes to source code are listed from newest to oldest. The date/time in the “Date/Revision” column on the first line is the last time changes to the issue have been submitted into Git.
How do I see what is being changed in this ticket?
Open an issue in your browser and click on the Git Commits tab.
When a developer submits a change to Git, they can type a brief message that summarizes the changes. These messages show up under the Committer/Author’s name.
The files that were changed by the developer appear as clickable links. column. Click on the file links to view the actual source code that was changed.
SSH
Questions related to SSH connections in Jira.
Does this app support authenticating to git repositories via SSH?
Yes.
SSH keys with and without passphrases are supported.
Why do I need to provide a PRIVATE KEY to the Git Integration for Jira Cloud app instead of a PUBLIC KEY?
The PRIVATE KEY is needed by the SSH client, which is the Jira Cloud, to connect to the Git server via SSH.
How do I configure/connect an SSH remote git repository to Jira?
In Jira, use the Plain git integration wizard to configure SSH integration with any remote git repositories.
Reindex
Questions related to git notes, reindex tracking and control.
What does re-index do?
Re-index does 2 operations:
- Updates the cloned repo from remote
- Updates the indexes which contain info about every commit
Is there any way to control the reindex?
In terms of kicking off the indexing based on an event:
- Webhook: Configure Webhooks
What other users have done is set a high interval and then configure one of those options.
Commits are not showing right away. Can they show up faster?
Commits won’t appear immediately. Configure webhooks via Manage integrations page to make commits show faster.
Is it possible to track the specified branches when reindexing?
No. The Git Integration for Jira app is designed to do a full index.
Purchase and Pricing
Questions about trial or purchase of Git Integration for Jira app and accepted payment methods.
How do I buy this add-on?
Buy the Git Integration for Jira app on Atlassian Marketplace using your Atlassian account — the same place where you manage your Jira license today.
Click here for a 30-day trial of Jira Git Plugin
Click here to buy the Jira Git Plugin
What payment methods are accepted?
Atlassian Marketplace accepts MasterCard, Visa and American Express. You may also pay with bank transfer or mailed check.
How do I determine the Git Integration for Jira app pricing after the trial?
There are four ways to determine the pricing:
-
Install the Git Integration for Jira app then go to:
https://[replacewithyourJiraname].atlassian.net/admin/billing/estimateThe estimated monthly or annual price will be quoted.
-
See pricing details on the Atlassian Marketplace: Git Integration for Jira.
-
Use the Atlassian Cloud Pricing Calculator:
- Choose between monthly/annual.
- Enter the number of seats your Jira is licensed for.
- Select Apps.
- Select Git Integration for Jira (Top Selling) from the dropdown list.
-
Create a quote on Atlassian.com.
Select the Quote option then Deployment (Server/Cloud/DC) and follow the instructions.
All four should provide the same answer.
Support
Topics related to Git Integration for Jira app support.
Does the Git for Jira Cloud app support CJK languages or Unicode?
Unicode characters are supported and displayed properly.
Where can I find my App Information?
You can find your App information by Navigating to the GIJ General settings
First, click on the apps menu, then click “Git Integration for Jira”, then click the ‘Settings’ button.
Copy the information at the bottom of the page, starting from “Current Build”. Include this information in your support request, or supply it to the support team if they have requested it.
