jira-ticket-migrate

Migrate tickets from one Jira to another Jira


License
MIT
Install
pip install jira-ticket-migrate==0.1.4

Documentation

Build Status codecov PyPI PyPI - Python Version Code style: black

jira-ticket-migrate

This is a program to help migrate tickets between Jira servers. If you have the appropriate privileges, there are better ways of doing this! If you don't, all you have available are messy solutions (including this).

So what's this, then? This migrates tickets belonging to projects from one Jira server to Jira another server. If the project is fresh on the destination server, then ticket numbers will be preserved.

To see what's done, a set of before and after pictures tells the best story:

Source ticket

source ticket

Migrated ticket

migrated ticket

Notice that the following are preserved:

  • title
  • description
  • priority
  • status
  • resolution

And possibly add the ticket number to that list (see above paragraph). Everything else is not preserved.

Note that this program assumes that you're migrating to a new-ish Jira (2018-ish), since there are some key differences between old and new Jiras.

Installation

Using pip,

pip install jira-ticket-migrate

Alternatively, you can run jira-ticket-migrate directly from source using the script run_jira_ticket_migrate.py.

Usage

Copy the example config file config.yaml.example to config.yaml

cp config.yaml.example config.yaml

and fill it in.

Then run with

jira-ticket-migrate

You can specify a config file explicitly with the -c option:

jira-ticket-migrate -c /path/to/config.yaml

Otherwise it will look for it at the root of the repository.