Page History
This page describes the migration path that you can can follow in order to migrate Xray data from Jira Server / Data Center to Jira Cloud.
...
Atlassian provides an app called Jira Cloud Migration Assistant which helps 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 is does not yet supported by support the Jira Cloud Migration Assistant. We are currently working with Atlassian to make this available, and we hope that the Atlassian Jira Cloud migration programme will include Xray soon. plan to provide this integration in early 2021.
Xray Cloud Migration Scripts
| Status | ||||
|---|---|---|---|---|
|
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.
| Message Box | ||||
|---|---|---|---|---|
| ||||
The scripts will not create new issues in Jira Cloud. The Xray issues must have already been migrated. Therefore, you first need to migrate the issues using the:
|
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
| Message Box | ||||
|---|---|---|---|---|
| ||||
Depending on the number of issues, the migration scripts can take a considerable amount of time to execute and migrate all the data. Please plan ahead and do a Proof-of-Concept in a Jira Test instance first. |
Clone or Download
These scrips are publicly available and free to use in our GitHub:
| Button Hyperlink | ||||||||
|---|---|---|---|---|---|---|---|---|
|
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.
| Message Box | ||||
|---|---|---|---|---|
| ||||
This page only contains a brief description of how the script works. Don't forget to follow the instructions on the README file in the repository. |