Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 does is not yet support the supported by Jira Cloud Migration Assistant. We plan to provide this integration in early 2021.

Xray Cloud Migration Scripts 
Status
colourBlue
titleAVAILABLE

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
titleScript Requirements
typegeneric

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
titleScript Performance
typewarning

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
titleClone or Download
typeprimary
urlhttps://github.com/Xray-App/xray-cloud-mig
targettrue

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.

...

titleInstructions
typewarning

...

are currently working with Atlassian to make this available, and we hope that the Atlassian Jira Cloud migration programme will include Xray soon.