Binnacle Heroku Add-on Test Instructions

binnacle-heroku-add-on-test-instructions.asc

• Go to Heroku (https://www.heroku.com/) and create an account if you don’t have one

• Install the heroku toolbelt from https://toolbelt.heroku.com/ or using Homebrew:

  /> brew install heroku-toolbelt

• Send you heroku account email to brian@binnacle.io

• You’ll receive an email from heroku about being invited to test the alpha version of the binnacle add-on

• Go to https://dashboard.heroku.com/apps to create a new app (+)

• Clone https://github.com/binnacle-io/binnacle-rails-showcase:

  /> git clone https://github.com/binnacle-io/binnacle-rails-showcase

• Copy the git remote of the newly created Heroku app and add it to the the cloned app:

  /> cd binnacle-rails-showcase
  binnacle-rails-showcase/> heroku git:remote -a binnacle-heroku-addon-test

• Provision the add-on:

  binnacle-rails-showcase/> heroku addons:create binnacle:developer

  Creating binnacle-solid-28143... done, (free)
  Adding binnacle-solid-28143 to binnacle-heroku-addon-test... done
  Setting BINNACLE_API_KEY, BINNACLE_API_SECRET, BINNACLE_APP, BINNACLE_APP_ERR_CTX, BINNACLE_APP_LOG_CTX, BINNACLE_CTX, BINNACLE_ENDPOINT and restarting binnacle-heroku-addon-test... done, v5
  Binnacle Add-on provisioned successfully!
  Use `heroku addons:docs binnacle` to view documentation.
  WARNING: Toolbelt v3.43.0 update available.

• Display the Binnacle Added ENV Variables:

  binnacle-rails-showcase/> heroku config

  === binnacle-heroku-addon-test Config Vars
  BINNACLE_API_KEY:     pnuedcalmk8d3xob29u3
  BINNACLE_API_SECRET:  opp9vmv6ocf6s5beljf6
  BINNACLE_APP:         4k63i3yt03ezni9ymc45
  BINNACLE_APP_ERR_CTX: zperwzemlr5oef4df1br
  BINNACLE_APP_LOG_CTX: 10zyy87otott5bzsxbd6
  BINNACLE_CTX:         4jwj59hhangpcol4j6oj
  BINNACLE_ENDPOINT:    api6.binnacle-api.io

• Add the BINNACLE_AR_CTX, BINNACLE_CHAT_CTX and BINNACLE_VOTING_CTX env vars needed for the demo app using the value of the BINNACLE_CTX :

  binnacle-rails-showcase/> heroku config:set BINNACLE_AR_CTX=4jwj59hhangpcol4j6oj

  Setting BINNACLE_AR_CTX and restarting ⬢ binnacle-heroku-addon-test... done, v6
  BINNACLE_AR_CTX: 4jwj59hhangpcol4j6oj

  binnacle-rails-showcase/> heroku config:set BINNACLE_CHAT_CTX=4jwj59hhangpcol4j6oj

  Setting BINNACLE_CHAT_CTX and restarting ⬢ binnacle-heroku-addon-test... done, v7
  BINNACLE_CHAT_CTX: 4jwj59hhangpcol4j6oj

  binnacle-rails-showcase/> heroku config:set BINNACLE_VOTING_CTX=4jwj59hhangpcol4j6oj

  Setting BINNACLE_VOTING_CTX and restarting ⬢ binnacle-heroku-addon-test... done, v8
  BINNACLE_VOTING_CTX: 4jwj59hhangpcol4j6oj

• Deploy the application:

  binnacle-rails-showcase/> git push heroku master

• Migrate the database:

  binnacle-rails-showcase/> heroku run rake db:migrate

• Seed the database with sample data:

  binnacle-rails-showcase/> heroku run rake db:seed

• Launch the application on your default browser:

  binnacle-rails-showcase/> heroku open

• You can launch the Binnacle app using Heroku’s Single-Sign-On (SSO) directly from Heroku.

• Go to the resources page of your app: your-heroku-app-name/resources

• Under the Add-ons section click on the binnacle Add-on Name

• Create a user on the sample App and explore around.

• On the Binnacle App, go to "General Log" context and select the "Tail General Log" button (one the action buttons next to the context log)

• The current documentation for the add on can be found at: https://devcenter.heroku.com/articles/binnacle?preview=1 (it’s not publicly available until the add-on is moved to beta)