FI Internal Trello-Harvest Integration

Development

1. Setting up development environment:

First, git clone both:

• https://github.com/func-i/Trello-estimates-server.git
• https://github.com/func-i/Trello-estimates-chrome-extension.git

2. Set up server (application.yml):

• TRELLO_DEVELOPER_KEY and TRELLO_DEVELOPER_SECRET
  • Click "Get your Application Key" on the Trello Developers page
• TRELLO_TOKEN
  • Refer to: ruby-trello, under Basic authorization

  $ gem install ruby-trello
  $ irb -rubygems
  irb> require 'trello'
  irb> Trello.open_authorization_url key: 'TRELLO_DEVELOPER_KEY above' # copy your member token
  

3. Install and run server:

• bundle exec bundle install
• bundle exec foreman start -f Procfile.dev
• https://localhost:5000
• You will be prompted for Github-Trello
  • allow OAuth token

Both time estimations and time tracked through Harvest will be updated on the server

Note: You must open the server app and authenticate with Trello before opening Trello with the Chrome extension

4. Chrome extension:

• Open Chrome, go to Extensions tab
• Enable Developer Mode (checkbox on the top right)
• Click Load unpacked extension.. and select the Trello-estimates-chrome-extension directory you cloned above
• Reload the extension

4.1 Track time on Harvest from the Trello cards

• Install the Harvest Time Tracker Chrome extension

Deploy

1. Heroku

https://devcenter.heroku.com/articles/getting-started-with-rails4

1.1 Rails 4: pre-compile assets locally

• RAILS_ENV=production bundle exec rake assets:precompile
• git add public/assets
• git commit -m "vendor compiled assets"

1.2 Heroku

• heroku login
• Either create the Heroku app: heroku create estimation-fi
• Or push to the exisint app: heroku git:remote -a estimation-fi
• git push heroku master

Heroku configs/setup:

• figaro heroku:set -e production
• heroku run rake db:migrate
• heroku ps:scale importer=1

Schedule task to reconcile daily Harvest logs:

• heroku addons:create scheduler:standard
• heroku addons:open scheduler
• bundle exec rake harvest:reconcile_daily_logs in the text field after $
• set Dyno Size: Free, Frequency: Every 10 minutes

1.3 open the Heroku app in the browser

• https://estimation-fi.herokuapp.com/