Skip to content
/ trira Public

A simple tool to sync Trello Cards with JIRA Tasks

License

Notifications You must be signed in to change notification settings

aerogear/trira

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

  1. Create an epic in JIRA. If that JIRA contains metadata, namely Fix Version, the value will be copied to all created issues.

  2. 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
  1. 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]
  1. 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