This add-on is operated by Knapsack Sp. z o.o.

Run your 1-hour test suite in 2 minutes with optimal parallelization.

Last updated January 26, 2024

Knapsack Pro wraps your current test runner(s) and works with your existing CI infrastructure to parallelize tests optimally:

• Dynamically splits your tests based on up-to-date test execution data
• Is designed from the ground up for CI and supports all of them
• Tracks your CI builds to detect bottlenecks
• Does not have access to your source code and collects minimal test data (with opt-in encryption)
• Enables you to export historical metrics about your CI builds
• Supports out-of-the-box any Ruby test runners, Cypress, Jest (and provides both SDK and API to integrate with any other language)
• Replaces local dependencies like Redis with an API and runs your tests regardless of network problems

Provisioning the add-on

Knapsack Pro can be attached to a Heroku application using the Heroku CLI:

$ heroku addons:create knapsack-pro --app YOUR_HEROKU_APP_NAME

Once Knapsack Pro has been added, sign into the Knapsack Pro dashboard to get an API token for your test suite, and find the installation guide for your test runner and CI provider.

Knapsack Pro dashboard

The Knapsack Pro dashboard can be accessed via the CLI:

$ heroku addons:open knapsack-pro --app YOUR_HEROKU_APP_NAME

or by visiting the Heroku dashboard, selecting the application, and then selecting Knapsack Pro from the add-ons menu.

Plans

The list of all plans can be found here.

Migrating between plans

Plans migration is easy and instant: it requires no code change and does not affect your existing collected test timing data.

You can use the command below to migrate to a new plan:

# Upgrade to a parallel-10 plan
$ heroku addons:upgrade knapsack-pro:parallel-10 --app YOUR_HEROKU_APP_NAME

Attaching the add-on to another app

The Knapsack Pro add-on is shareable across Heroku apps. This can be useful, for instance, when you have staging and production Heroku apps.

You can provision the Knapsack Pro add-on for the production application and later attach it to the staging application, so all developers can easily access the add-on from the Heroku dashboard.

# Copy the add-on name for Knapsack Pro
$ heroku addons --app YOUR_HEROKU_APP_NAME

# Replace knapsack-pro-production-infinite-32142 with the name copied above
$ heroku addons:attach knapsack-pro-production-infinite-32142 --app YOUR_HEROKU_APP_NAME

Support

All Knapsack Pro Heroku add-on support and runtime issues should be submitted via the Heroku Support channels.

Also, you can send us your suggestions and feedback at knapsackpro.com.

Removing the add-on

Knapsack Pro can be removed using the Heroku CLI.

$ heroku addons:destroy knapsack-pro --app YOUR_HEROKU_APP_NAME