{{tag>jira github bitbucket}}

====== Bitbucket Server Cloud migration with Github integration ======

===== Add Github repository to Jira server instance. =====

Github repo can be added globally via Administration > Applications > DVCS accounts. This will enable the repo for all future projects.

Alternatively it can be added separately for each projects in Project Settings > Developer tools.

  - Add repo in Administration > Applications > DVCS accounts
  - Login to your github and generate client key. Go to Profile > Settings > Developer Settings > OAuth Apps and register a new application. For the url and callback url add the url for Jira.
  - Copy the the client ID and generated client secret back to Jira
  - Repo should now be connected

===== Do a test commit for some test project =====

Create a new project and test issue in Jira and then do a test commit with commit message beginning with issue key e.g. 
<code>git commit -m "ISSUE-1 add file"</code> 
You may need to refresh the repo to show the change (Administration > Applications > DVCS accounts)

You should see a new commit on the issue.
===== Bitbucket Cloud =====

Before migrating to cloud (or after), install the Github for Jira app and configure it to connect to your Github repo. You may need to select "Full" retry sync to see the commits/branches.


====== Tested on ======
  * Atlassian Jira Project Management Software 8.8.1

====== See also ======

====== References ======
  * https://confluence.atlassian.com/adminjiraserver088/installing-jira-applications/extending-jira-applications/integrating-with-development-tools/linking-a-bitbucket-or-github-repository-with-jira#LinkingaBitbucketorGitHubrepositorywithJira-Automaticsynchronizationandtemporarilydisablingalink