This library is a command line tool that orchestrates [Heroku](https://www.heroku.com/) and [Amazon S3](https://aws.amazon.com/s3/) deployments for [Next](https://github.com/Financial-Times/next/wiki), based on configurations in the [Next service registry


stars šŸŒŸissues āš ļøupdated šŸ› created šŸ£size šŸ‹ļøā€ā™€ļø
Minified + gzip package size for @financial-times/n-heroku-tools in KB


n-heroku-tools (nht) CircleCI

This library is a command line tool that orchestrates Heroku and Amazon S3 deployments for Next, based on configurations in the Next service registry and Vault.

šŸ¤– This file is generated automatically. If you need to make updates please modify /scripts/readme-template.md and afterwards run make docs.


  • Node version defined by engines.node in package.json. Run command nvm use to switch your local Node version to the one specified in .nvmrc.


git clone git@github.com:Financial-Times/n-heroku-tools.git
cd n-heroku-tools
make install


Running locally

In order to run a CLI command locally you'll need to run:

./bin/n-heroku-tools.js COMMAND

For example, to check if a service is up and running:

./bin/n-heroku-tools.js gtg ft-next-health-eu

# ā³ polling: http://ft-next-health-eu.herokuapp.com/__gtg
# āœ… http://ft-next-health-eu.herokuapp.com/__gtg ok!


In order to run the tests locally you'll need to run:

make test

Install from NPM

npm install --save-dev @financial-times/n-heroku-tools


Use nht or n-heroku-tools on the command line:

Usage: n-heroku-tools [options] [command]

  -V, --version                                       output the version number
  -h, --help                                          output usage information

  configure [options] [source] [target]               gets environment variables from Vault and uploads them to the current app
  deploy-static [options] <source> [otherSources...]  Deploys static <source> to S3.  Requires AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY env vars
  run [options]                                       Runs the local app through the router
  rebuild [options] [apps...]                         DEPRECATED. Trigger a rebuild of the latest master on Circle
  gtg [app]                                           Runs gtg checks for an app
  review-app [options] [appName]                      Create or find an existing heroku review app and print out the app name. [appName] is the package.json name (which is also the value of VAULT_NAME). On the first build of a branch, Heroku will create a review app with a build. On subsequent builds, Heroku will automatically generate a new build, which this task looks for. See https://devcenter.heroku.com/articles/review-apps-beta for more details of the internals
  upload-assets-to-s3 [options]                       Uploads a folder of assets to an S3 bucket

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.