In this post, we will be evaluating the cloud migration journey for Atlassian’s Bitbucket. Yeah, it’s not technically a Jira app, but it many ways it feels like a Jira add-on and so we included it in our evaluation of app migrations.
Bitbucket Server and Bitbucket Cloud have an equivalent feature set; however, you will need to use a combination of automatic and manual migration methods to ensure that all features are correctly implemented in the Cloud. If you need support or guidance with your migration, you can contact Atlassian or refer to their migration documentation.
| Feature Compatibility |  |
| Migration Complexity |  |
| Migration Method |  |
| Migration Support Available |  |
| Supported Jira Migration Methods |  |
Feature Compatibility
Even though all of Bitbucket’s Server features are available on Cloud through automatic and manual migration methods, there are some differences in the way that Bitbucket Cloud operates due to differences in the fundamental architecture of both environments. To learn more about these disparities, refer to the Functional differences in Bitbucket Cloud article by Atlassian.
Migration Method and Complexity
There are three main migration methods that can be used to migrate Bitbucket data to the Cloud:
- Repository Importer – a Bitbucket Cloud tool used to import from Git-based hosting sites.
- Create a repository in Bitbucket Cloud and push the server repository to the new one in Cloud.
- Bitbucket APIs. This is recommended for migrating many repositories at once.
You may have to use a combination of the above mentioned migration tools to implement all of the Cloud features successfully. What to know more about the technical details of migrating Bitbucket to the cloud? Read our technical blog post on the various migration methods: Bitbucket Server to Cloud Migration.
Atlassian is creating a tool to migrate Bitbucket data called the Bitbucket Cloud Migration Assistant. For more updates on Bitbucket Cloud, take a look at Atlassian’s Cloud roadmap.
Migration Support Available
To receive assistance and support with your migration, there is some documentation available on migrating from Bitbucket Server to Bitbucket Cloud. To receive help with specific issues that arise in your migration, contact Atlassian.
Possible Challenges
During our migration testing, we discovered a few challenges when migrating Bitbucket data:
- The Repository Importer cannot migrate user accounts, permission structures, or repository metadata like pull request history and comments.
- Pushing server repository to a new repository in the Cloud consists of the same drawbacks as the Repository Importer.
Resources: