An open API service indexing awesome lists of open source software.

https://github.com/xray-app/zephyr_cloud_to_xray_cloud

Simple Zephy Cloud to Xray Cloud migration script
https://github.com/xray-app/zephyr_cloud_to_xray_cloud

testing-tools xray zephyr

Last synced: 10 months ago
JSON representation

Simple Zephy Cloud to Xray Cloud migration script

Awesome Lists containing this project

README

          

## Important note

**This project is no longer actively maintained.**

## Description

This project contains some preliminary and **unmaintained** scripts to migrate Zephyr cloud to Xray Cloud.

## Disclaimer

These scripts are provided AS-IS, with no support from the Xray team. They require a high level of technical expertise with Xray and Jira.

## Features
- creates (only) new Test issues, on the same or another project
- source Test cases can be identified using JQL
- copies: summary, description, fixVersion, components, labels, priority, custom fields (single value and multivalue)
- recreates up to 1 link :(
- ability to add labels to easily identify the created Test issues

# Limitations
- does not copy Test's attachments, comments and other fields that are not described earlier
- doesnt recreate more than one link per Test issue
- does not migrate inline existing test cases; it always creates new Tests issues
- does not process Test Cycles nor execution related information
- some fields are copied based on id an not on name

# Requirements
- Ruby >= 2.3.3
- rvm (http://www.rvm.io), to easily setup Ruby environment
- bundler
- having Zephyr for Jira Cloud, ZAPI for Jira Cloud and ZAPI for Jira Cloud installed in Jira Cloud instance

## Setup
- rvm use 2.3.3
- gem install bundler
- bundle

## How to use

1. Create an API token in Jira, in order to obtain the jira_api_token, this can be done by accessing the following url: https://id.atlassian.com/manage/api-tokens
2. Create an API key in ZAPI, in order to obtain a Access Key and a Secret Key
3. Create an API key in Xray, in order to obtain a Client Id and a Client Secret
4. Edit the settings in config.yml
5. Run it
```sh
$ migrate_zephyr_to_xray_cloud.rb
```

The utility may also support some parameters.
In order to see the full syntax, please use:
```sh
$ migrate_zephyr_to_xray_cloud.rb --help
```

## LICENSE

[BSD 3-Clause](LICENSE)