This page describes the migration path that our customers can follow in order to migrate Xray data from Jira Server / Data Center to Jira Cloud.
Server/DC vs Cloud - Product Comparison
If you are looking to migrate from Jira Server/DC to Jira Cloud, you need to consider the differences between Xray Server/DC and Xray Cloud. These differences might affect how your users work and interact with Xray.
The ideas, goals, and major features are the same, of course. However, while there is great similarity between them, there are a few subtle differences between the two versions mainly due to:
- Jira architecture - The way apps work in Server and Cloud is completely different. In Server, apps can integrate with many aspects of Jira, while on Cloud, there are lot's of integration points missing, e.g. JQL functions, Project Templates, etc
- Product Age - Xray Cloud is a newer product. Therefore, some of the features are not yet present (e.g. Automated Step Library, Historic Test Coverage report), although we plan to include these features in future releases. Also, we took the opportunity to improve some features (e.g. Project Level Settings).
For a full comparison between the Server/DC and Cloud versions of Xray, please refer to Xray Server and Xray Cloud.
Jira Cloud Migration Assistant IN PROGRESS
Atlassian provides an app called Jira Cloud Migration Assistant which will help users assess and migrate all the information from Jira on-premises to Jira Cloud. Jira Apps can also integrate with this assistant, making it easier to migrate all the data at once.
Currently, Xray does not yet support the Jira Cloud Migration Assistant. We plan to provide this integration in early 2021.
Xray Cloud Migration Scripts AVAILABLE
Although there isn't support for the Jira Cloud Migration Assistant yet, the Xray team has created some scripts that can help you migrate your data today.
These scripts are written in Python and are using the Xray REST and GraphQL APIs to fetch the Xray information from Xray Server/DC, and then import this information into Xray Cloud.
The scripts will fill the gaps, namely:
- Test specifications
- Test Repository folders
- Relations between Xray issues/entities, e.g. Tests in Test Plans, Tests in Test Sets, Preconditions, etc.
- Test Runs
Clone or Download
These scrips are publicly available and free to use in our Github:
https://github.com/Xray-App/xray-cloud-mig
Please clone or download the repository and make any changes as needed.
Feel free to contribute and submit pull requests.