Administering Bitbucket and GitHub with JIRA applications
Using Bitbucket and/or GitHub with your JIRA Software application allows you to work more effectively and efficiently with your development tools. If required, you can link multiple JIRA instances to one Bitbucket instance, and you can link multiple Bitbucket instances to one JIRA instance.
When opened in a viewport, the user will be redirected to: Connect Bitbucket and Jira.
When Jira applications are connected to Bitbucket or GitHub accounts:
- You can link all, or a subset, of your existing repositories (both public and private) to Jira Software.
- New repositories are automatically linked to Jira Software.
- Create new branches in a repository from a Jira Software issue, and see those branches in the issue.
- Reference Jira Software issues in a commit message and have those commits appear in the Development panel of Jira Software issues.
- Create new pull requests from a Jira Software issue, and see all the related PRs in an issue.
- Transition issues through a Jira Software Cloud workflow (for example, Close, Reopen, and so forth) using Smart Commit messages. See Use Smart Commits.
Read more about integrating Jira Software with Atlassian development tools: Streamlining your development with Jira Cloud.
You can connect Bitbucket Cloud or GitHub accounts with Jira applications using the free Jira DVCS Connector add-on. This add-on comes bundled with Jira Software. For Jira Server versions earlier than 7.0, this is a system add-on that you can install. For more details, see Linking Bitbucket Cloud and GitHub accounts to Jira Software.
Notes and Tips
- The Bitbucket links feature offers a similar functionality for Jira Software and other services.
- If you want to report a new issue, provide feedback, or require help, please raise a request in the issue tracker for Jira DVCS Connector project.
Current limitations of this feature
The following limitations exist for this feature:
- There is no way to link user accounts on Jira Software with user accounts on Bitbucket. This functionality will come with Atlassian account in the future.
However, when you create Jira Software users, emails will be automatically sent to the new users, inviting them to join Bitbucket. For details, see Managing Users. - If you use email addresses to connect Cloud with Bitbucket, repositories cannot be linked and you will see an error similar to the one shown in the screenshot below. To work around this, use your Bitbucket account name instead of email address.
Using this feature
See the following for details about using this feature: