Git Repository integration
With the integration of Git, repository management becomes highly practical and efficient. We currently support integration with Azure DevOps, GitLab, and GitHub. Whether you're merging branches, tracking changes, or rolling back to previous versions, you can track all these changes seamlessly within your Jira instance. This integration allows you to easily track repositories, branches, commits, and pull requests.
Our Git integration app for Jira is available at the following link: Git Connector for Jira.
While it is possible to create a Git integration using other integration apps, it is mandatory to have the Git Connector app installed.
How to Build a Git Integration
1. Launch the Getint App:
Navigate to Apps, launch the app Git Connector for Jira, go to Integrations, click Create Integration, and select Sync GIT Repository.
If you’re using Getint On-Premise, simply launch the app, click Create Integration, and select GIT.
2. Create a Connection for the App Containing the Git Repository:
Select the app you want to integrate by clicking the Connect App button.
Create a connection or select an existing one.
Follow the next steps depending on the app you selected. We’re taking GitLab as an example, but the process is the same for the rest of the connectors.
Once you've added your details, you'll find your new connection in the dropdown list of available connections. Please select it and click Connect to complete the process.
For detailed instructions on creating a connection and generating an access token, please refer to our comprehensive guide: Connections | Tokens and Requirements.
3. Establish a Connection with Jira:
Make sure you are logged in with admin rights, then click on Connect App and select Jira. Choose Create New to establish a fresh connection with your Jira instance and enter the URL of your Jira instance.
Unlike Continuous Syncs or Migrations, GIT integrations require users to set up OAuth in your Jira instance. Please ensure you have admin permissions; otherwise, you will not be able to set up the OAuth credentials. Then, follow our guide to configure a Jira OAuth at the following: Connection | Jira OAuth.
Enter the necessary details to establish the connection.
Once you've added your details, you'll find your new connection in the dropdown list of available connections. Please select it and click Connect to complete the process.
4. Building Your Integration:
By default, the Git repositories will sync with all projects in your Jira instance. However, unchecking this option allows you to select one or multiple projects where you want this information to be available.
For example, you can select specific projects based on your company’s needs. Next, choose the Git repositories you want to sync. Finally, name your integration and click Create at the top right corner of the screen to save it.
Once you've created your integration, it will be easily accessible in the Integrations section within Workflows, and it is marked with a code icon.
If you did not install the Git Connector app as instructed at the beginning of the article, you will encounter an error like the one shown below:
5. Test the Integration and Sync Your Branches
To start syncing branches, ensure that you use the ID of the Jira task as a prefix for the branch names. For branch names, only underscores or dashes can be used instead of spaces. For example ED-23-resolve-support-ticket-9843-migrate.
For example, if you’re syncing an item with the Jira ID ED-23, your branch should be named ED-23 + branch name, as shown below:
If the correct naming prefix is not used to sync your items, an error like the one below will occur:
The Git repository details of your Jira items will be available in the Development field. Refresh the page if you don’t see any changes to the Development field.
Depending on your Project template, the Development field may not be visible. In such cases, you must either add the field by modifying the issue layout or switch to a different template.
By clicking on this field, you can easily access all the information that is being collected from the repositories.
Getint enables the synchronization of Repositories, Branches, Commits, and Pull Requests. However, please note that changes cannot be submitted from Jira to the Git repository. The synchronization of repository information is one-way from the Git connector.
Conclusion
With this comprehensive guide, you can seamlessly integrate Git with Jira and take full advantage of efficient repository management. If you require any assistance or have further questions, don't hesitate to contact us here.
Last updated
Was this helpful?