Versions Compared

Key

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

...

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  

...

colourYellow
titleIn Progress

Atlassian provides the Jira Cloud Migration Assistant to help Jira users assess and migrate from an on-premise Jira instance (server or data center) to Jira Cloud. However, Atlassian has not yet included apps like Xray in this tool.

...

Will not be migrated to cloud. (Miscellaneous settings section)

...

Warning

These scripts are provided AS-IS, with no further support from the Xray team. They require a high level of technical expertise with Xray and Jira and we recommend only expert users attempt to use them to migrate their Xray data.

Although Atlassian has not yet included Xray in the official Jira Cloud Migration Assistant, 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 either 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. 

...

titleInstructions
typewarning

...