n-heroku-tools (nht)

⚠️ n-heroku-tools is unsupported. FT.com projects should migrate to Tool Kit.

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.

Requirements

• Node 10.x

Installation

git clone [email protected]:Financial-Times/n-heroku-tools.git
cd n-heroku-tools
make install

Development

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!

Testing

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

Usage

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

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

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

Commands:
  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
  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
  *