Deploy on Heroku

A fast guide on how to deploy icare on Heroku

The Easy Way™

Note: you will probably need to edit source code in order to customize icare according to your needs

The Hard Way™

Prerequisites

1. *nix based OS (we don't support Microsoft Windows)
2. git version control system
3. Heroku Toolbelt
4. A working Facebook Application
5. A valid Google Maps JavaScript API key

Instructions for a new application

Replace appname with a name of your choice.

1. Setup a new application

heroku create appname --remote production

2. Enable branch tracking

git config push.default tracking

3. Add add-ons

heroku addons:create mongolab:sandbox # Database
heroku addons:create redistogo:nano # Background jobs
heroku addons:create newrelic # App monitoring
heroku addons:create papertrail # Log monitoring

4. Setup environment variables

heroku config:add APP_BASE_URL=CHANGEME_WITH_YOUR_APPNAME.herokuapp.com
heroku config:add GOOGLE_MAPS_API_KEY=CHANGEME_WITH_YOUR_GOOGLE_MAPS_API_KEY
heroku config:add FACEBOOK_NAMESPACE=CHANGEME_WITH_YOUR_FACEBOOK_NAMESPACE
heroku config:add FACEBOOK_APP_ID=CHANGEME_WITH_YOUR_FACEBOOK_APP_ID
heroku config:add FACEBOOK_SECRET=CHANGEME_WITH_YOUR_FACEBOOK_SECRET
heroku config:add RUBY_GC_HEAP_OLDOBJECT_LIMIT_FACTOR=1.3
heroku config:add DEVISE_SECRET_KEY="$(bundle exec rake secret)" DEVISE_PEPPER="$(bundle exec rake secret)"

5. Setup Google Analytics, Airbrake and New Relic (optional)

heroku config:add GOOGLE_ANALYTICS_ID=UA-XXXXXXXX-X

heroku config:add AIRBRAKE_API_KEY=xxx
heroku config:add AIRBRAKE_HOST=xxx

6. Push!

git checkout master
git push production master

7. Create db indexes and populate db with some default objects

heroku run rake db:mongoid:create_indexes db:seed

8. Set up to track remote branch production/master from master. In this way you can simply launch git push from master branch instead of git push production master to deploy on Heroku

git branch master --set-upstream-to production/master

Instructions for an existing application

Replace appname with the name of the existing application. We suppose you already have forked this repository.

1. Add the heroku remote

heroku git:remote -a appname -r production

2. Enable branch tracking

git config push.default tracking

3. After pushing for the first time to production master, set up to track remote branch production/master from master

git branch master --set-upstream-to production/master

Notes

On free Heroku hosting, the "Share on Facebook Timeline" will use a background worker inside the web dyno, by using defunkt/unicorn and the following instructions from Diaspora

References

• Managing Multiple Environments for an App