How To Set Up GitHub Integration With JIRA (Video Tutorial)

Two of the many open source applications used when developing an application in the cloud are GitHub and JIRA. These apps have important roles to plan in the SDLC for tracking code and work. This free video tutorial shows how to set up the GitHub integration with JIRA.

GitHub Integrations with JIRA - Video Transcript

We’ll be using Atlassian’s On Demand flavor of JIRA to demonstrate this integration. The JIRA DVCS plug-in scans commits and pull requests orchestrated on GitHub, and creates relevant metadata and hyperlinks in any mentioned JIRA issues.

To integrate the JIRA DVCS plug-in, we’ll first set it up as a developer application on our GitHub instance. Log in with an account that has permissions to add OAuth applications, and then, navigate to your applications settings page. Click “Register a new application,” then, enter “JIRA DVCS” as the application name, though you can be creative as you like with this. Next, enter your JIRA instance’s URL for both the home page URL, and the authorization callback URL fields, and click “Register application.” Take note of the client ID and client secret fields, we’ll use this information in just a minute. Now that we have our GitHub side of things configured, we’ll bring this data over to JIRA, to finish connecting the service to the GitHub platform.

There’s a help page that documents this configuration process if you need to refer back to it later. Log in to your JIRA instance using an account that has administrative access, then, click the settings icon, and then click “add-ons.” Next, click on the DVCS accounts link in the left-hand navigation, then choose to link a GitHub account, choose GitHub or GitHub Enterprise, as appropriate for your set-up, and fill in the OAuth key and OAuth secret that we obtained by creating an OAuth application on GitHub, and click add. Our GitHub repositories are now listed on the DVCS connector page and have started their initial sync. We’re all set up. Our commits and pull requests can now reference JIRA issue numbers. Let’s create a sample issue and pull request to see this in action. We’ll open up our sample project, and create a branch. With this branch selected, we’ll make a small change to one of the files, ensuring that we reference the JIRA issue, and also adding some metadata about the time it took us to make this fix.

Let’s head back over to JIRA to see what it’s observed in our GitHub repository. JIRA has recorded our time logged against the work in the commit and notice the pull request that corresponds to this issue. Now that you’ve seen how easy it is to get set up, you’ll soon be on your way to leveraging the JIRA integration with GitHub. Thanks for watching this video on the integration of JIRA and GitHub. This great project planning tool and collaboration platform will make an excellent addition to your stable of development tools.


Leave a Reply