This repo provides a command for exporting a Pivotal Tracker project to Trello. The command is available as a gem or a docker container.
-
Install the gem:
> gem install pivotal-to-trelloOr pull the container down using Docker:
> docker pull ronawilliams/pivotal-to-trelloWhen using the docker container, substitute
pivotal-to-trellowithdocker run -i ronawilliams/pivotal-to-trello -
Run the importer:
> pivotal-to-trello import --trello-key TRELLO_API_KEY --trello-token TRELLO_TOKEN --pivotal-token PIVOTAL_TOKEN
See the Obtaining API credentials section for details on how to obtain these credentials.
The importer will ask you a series of questions to identify which Trello lists you want to import certain classes of stories into. It will then import the stories into Trello, along with any associated comments. It does not currently have the ability to import attachments.
For example :
> pivotal-to-trello import --trello-key TRELLO_API_KEY --trello-token TRELLO_TOKEN --pivotal-token PIVOTAL_TOKEN
Which Pivotal project would you like to export?
1. Android App
2. IOS App
3. Tech Support
4. Web App
Please select an option : 4
Which Trello board would you like to import into?
1. Development
2. Welcome Board
3. Wish List
Please select an option : 1
Which Trello list would you like to put 'icebox' stories into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 6
Which Trello list would you like to put 'current' stories into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 7
Which Trello list would you like to put 'finished' stories into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 5
Which Trello list would you like to put 'delivered' stories into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 4
Which Trello list would you like to put 'accepted' stories into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 10
Which Trello list would you like to put 'rejected' stories into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 10
Which Trello list would you like to put 'backlog' bugs into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 2
Which Trello list would you like to put 'backlog' chores into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 2
Which Trello list would you like to put 'backlog' features into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 2
Which Trello list would you like to put 'backlog' releases into?
1. Accepted
2. Backlog
3. Bugs
4. Delivered
5. Finished
6. Icebox
7. In Progress
8. Rejected
9. Releases
10. [don't import these stories]
Please select an option : 2
What color would you like to label bugs with?
1. Blue
2. Green
3. Orange
4. Purple
5. Red
6. Yellow
7. [none]
Please select an option : 5
What color would you like to label features with?
1. Blue
2. Green
3. Orange
4. Purple
5. Red
6. Yellow
7. [none]
Please select an option : 2
What color would you like to label chores with?
1. Blue
2. Green
3. Orange
4. Purple
5. Red
6. Yellow
7. [none]
Please select an option : 6
What color would you like to label releases with?
1. Blue
2. Green
3. Orange
4. Purple
5. Red
6. Yellow
7. [none]
Please select an option : 4
Beginning import...
Creating a card for chore 'My example chore'.
...
You can get your Trello application key by logging into Trello, and then visiting https://trello.com/1/appKey/generate
Your 32-character application key will be listed in the first box.
To obtain your Trello member token, visit the following URL, substuting your Trello application key for APP_KEY:
Click the Allow button, and you will be presented with a 64-character token.
See the Trello documentation for more details.
The Pivotal Tracker token can be found at the bottom of your Pivotal profile page.
- Version 0.3.1 (2019-12-20) : Added Ron Williams as an author in the gemspec again after
rake releaseremoved him. - Version 0.3.0 (2019-12-04) : Update to the maintained tracker_api gem (thanks @rwilliams!).
- Version 0.2.0 (2017-08-10) : Fix label creation, update gem dependencies, add checklist support (thanks @rikthevik!), add docker support (thanks @kennethkalmer!).
- Version 0.1.2 (2014-01-13) : Update version number in the gemspec.
- Version 0.1.1 (2014-01-13) : Specify gem dependencies.
- Version 0.1.0 (2014-01-13) : Initial version.
If you come across any problems, please create a ticket and I'll try to get it fixed as soon as possible.
Once you've made your changes:
- Fork pivotal-to-trello
- Create a topic branch -
git checkout -b my_branch - Push to your branch -
git push origin my_branch - Create a Pull Request from your branch
- That's it!
Dave Perrett :: [email protected] :: @daveperrett
Copyright (c) 2017 Dave Perrett. See License for details.