Jira GitHub integration
Last updated
Last updated
Integrating Jira with GitHub via Getint streamlines your development and project management processes by enabling two-way synchronization between these platforms. Whether you're tracking issues in Jira or managing code in GitHub, this integration ensures both teams remain in sync, improving collaboration and efficiency. This step-by-step guide will walk you through the process of setting up the integration between Jira and GitHub using Personal Access Tokens for authentication.
Navigate to "Apps" and select “Jira - GitHub Integration.”
Click "Create integration” or “Migration.”
For Jira Cloud, generate a Jira token. This token will act as your password:
Go to Atlassian Account Settings.
Navigate to Security and generate an API token, then use this token as the password for Jira integration.
Log in to your GitHub account.
Select your Avatar in the top right corner. Navigate to Settings > Developer Settings > Personal access tokens.
Click Generate new Token and select Generate new Token (Classic).
Provide a name for your token, select the expiration date, and set the required scopes (permissions). For a detailed description of how to create the token, please follow this Guide.
Click Generate Token and make sure to securely store your token as it will only be visible once.
In Getint, enter your Jira instance URL, username, and the API token.
Use the Personal Access Token for Jira Cloud.
Follow our Quickstart Guide for more details on how to create the connection.
Select the Jira project you wish to integrate with GitHub.
Once the token is generated, return to Getint.
Paste the GitHub Personal Access Token into the API token field.
Select the GitHub repository you want to sync with Jira.
Click Save to establish the connection.
Map the Jira issue types you want to sync with GitHub tasks, such as mapping a GitHub Task to a Jira task or a Jira bug to a GitHub task.
Consider using the "Quick Build" beta feature for automated type and field mapping, which can streamline the setup process.
Review or manually map fields within mapped types, including title, description, and assignees.
Use the assignee mapping option to match Jira assignees to GitHub collaborators, enabling precise synchronization of task ownership. For more details, visit our doc: Assignees (users) mapping.
Map status fields to align between Jira and GitHub. For example, “To do” in Jira could be mapped to “Opened” in GitHub.
When enabling comment synchronization, you can filter by criteria such as created date, author, or visibility (public/private).
Use the assignee mapping option to match Jira assignees to GitHub collaborators, enabling precise synchronization of task ownership. For more details, visit our doc: Assignees (users) mapping.
It is possible to filter the synchronization to have them customized for your needs and requirements. Please see the doc Items Filtering for more details.
UI Filtering Option:
Click on the filtering icon near the app icon in your integration. This will apply to that side of the integration.
Select if the filtering applies to All, New, and Synced items.
Note that if the option “New items” is selected, the filtering will apply only to the new items, and the already synced items will continue to sync and update. If the option “Synced items” is selected, only the already synced items will be updated based on that filter.
Choose the options and add the value for the filter. It is possible to filter more than one option for each field.
Select Apply once you created the filters and Save the integration.
Create test issues or tasks in Jira or GitHub and observe how they synchronize.
Ensure that the data between the two platforms is correctly synced.
Monitor the integration status and the logs in Getint to verify that everything functions as expected.
By following this guide, you can successfully integrate Jira and GitHub using Getint. This setup enables smooth synchronization of issues, tasks, and workflows between development and project management tools, helping teams collaborate more effectively and bridging the gap between developers and project managers.
For further assistance, please contact us at the Support Center or Schedule a Demo.