trira
v0.6.0
Published
A tool to move cards from Trello to JIRA
Downloads
45
Readme
Trira
A tool that is able to convert cards in Trello board into JIRA. It creates JIRA Tasks based on content of cards and link them to provided Epic.
Prerequisites
- Node.js v6 or newer
- Trello API key and Trello token
- JIRA instance with Greenhopper Epic support
- JIRA user and password
Usage
Create an epic in JIRA. If that JIRA contains metadata, namely Fix Version, the value will be copied to all created issues.
Install the trira tool:
npm install -g trira
To use development version:
git clone https://github.com/aerogear/trira.git && cd trira && npm install && npm link
- Provide credentials for Trello and JIRA. For example, a JIRA host could be issues.jboss.org.
trira target <jiraHost> --trello-key=<trello-key> --trello-token=<trello-token> --jira-user=<jira-user> --jira-password=<jira-password> [--strict-ssl=true|false]
- To create Jiras from all lists in a trello board:
trira sync <trello-board-regexp> <jira-epic-name-or-key> --list-regexp '.*'
There are further options available, such as which Trello columns will be synced or a card name regular expression for more granular filtering, custom prefix of the card names, etc. For more details about command usage, run:
trira help sync
Assumptions
- All checklists are included in JIRA description field
- Labels on cards in Trello are used to label issues in JIRA (labels in Trello can't contain spaces)
- It is current not possible to sync data from JIRA to Trello
- Tool ignores existing issues, hence every run creates new issues - instead of updating them
- Tool creates issues where provided jira user acts as reporter
- Story points are represented in Trello card name - in the beginning as a number in parentheses, such as (3)
- Card description from Trello is converted from Trello markdown to JIRA markup language