README.md in knapsack_pro-0.52.0 vs README.md in knapsack_pro-0.53.0

- old
+ new

@@ -102,10 +102,11 @@ - [Info for Travis users](#info-for-travis-users) - [Info for semaphoreapp.com users](#info-for-semaphoreappcom-users) - [Info for buildkite.com users](#info-for-buildkitecom-users) - [Info for Gitlab CI users](#info-for-gitlab-ci-users) - [Info for codeship.com users](#info-for-codeshipcom-users) + - [Info for Heroku CI users](#info-for-heroku-ci-users) - [Info for snap-ci.com users](#info-for-snap-cicom-users) - [Info for Jenkins users](#info-for-jenkins-users) - [FAQ](#faq) - [Common problems](#common-problems) - [Why I see API error commit_hash parameter is required?](#why-i-see-api-error-commit_hash-parameter-is-required) @@ -897,9 +898,47 @@ # It will autobalance bulid because it is executed after Cucumber tests. KNAPSACK_PRO_CI_NODE_TOTAL=2 KNAPSACK_PRO_CI_NODE_INDEX=1 bundle exec rake knapsack_pro:queue:rspec ``` Remember to add API tokens like `KNAPSACK_PRO_TEST_SUITE_TOKEN_CUCUMBER` and `KNAPSACK_PRO_TEST_SUITE_TOKEN_RSPEC` to `Environment` page of your project settings in Codeship. + +#### Info for Heroku CI users + +You can parallelize your tests on Heroku CI by configuring `app.json`. + +You can set how many parallel dynos with tests you want to run with `quantity` value. +Use `test` key to run knapsack_pro gem. + +You need to specify also the environment variable with API token for Knapsack Pro. +For any sensitive environment variables (like Knapsack Pro API token) that you do not want in your `app.json` manifest, you can add them to your pipeline’s Heroku CI settings. + +Note the [Heroku CI Parallel Test Runs](https://devcenter.heroku.com/articles/heroku-ci-parallel-test-runs) are in Beta and you may need to ask Heroku support to enabled it for your project. + +``` +# app.json +{ + "environments": { + "test": { + "formation": { + "test": { + "quantity": 2 + } + }, + "addons": [ + "heroku-postgresql" + ], + "scripts": { + "test": "bundle exec rake knapsack_pro:rspec" + }, + "env": { + "KNAPSACK_PRO_TEST_SUITE_TOKEN_RSPEC": "rspec-token" + } + } + } +} +``` + +You can learn more about [Heroku CI](https://devcenter.heroku.com/articles/heroku-ci). #### Info for snap-ci.com users Knapsack Pro supports snap-ci.com ENVs `SNAP_WORKER_TOTAL` and `SNAP_WORKER_INDEX`. The only thing you need to do is to configure number of workers for your project in configuration settings in order to enable parallelism. Next thing is to set below commands to be executed in your stage: