Skip to content

Latest commit

 

History

History
295 lines (208 loc) · 7.69 KB

ci.md

File metadata and controls

295 lines (208 loc) · 7.69 KB
Raw

heroku ci

test runner for Heroku Pipelines

heroku ci

display the most recent CI runs for the given pipeline

USAGE
  $ heroku ci [-a <value>] [-r <value>] [--watch] [-p <value>] [--json]

FLAGS
  -a, --app=<value>       app to run command against
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use
      --json              output in json format
      --watch             keep running and watch for new and update tests

DESCRIPTION
  display the most recent CI runs for the given pipeline

EXAMPLES
  $ heroku ci --app murmuring-headland-14719

See code: src/commands/ci/index.ts

heroku ci:config

display CI config vars

USAGE
  $ heroku ci:config [-a <value>] [-r <value>] [-s] [--json] [-p <value>]

FLAGS
  -a, --app=<value>       app to run command against
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use
  -s, --shell             output config vars in shell format
      --json              output config vars in json format

DESCRIPTION
  display CI config vars

EXAMPLES
  $ heroku ci:config --app murmuring-headland-14719 --json

See code: src/commands/ci/config/index.ts

heroku ci:config:get KEY

get a CI config var

USAGE
  $ heroku ci:config:get KEY [-h] [-a <value>] [-r <value>] [-p <value>] [-s]

ARGUMENTS
  KEY  name of the config var key

FLAGS
  -a, --app=<value>       app to run command against
  -h, --help              Show CLI help.
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use
  -s, --shell             output config var in shell format

DESCRIPTION
  get a CI config var

EXAMPLES
  $ heroku ci:config:get --pipeline=PIPELINE RAILS_ENV
      test

See code: src/commands/ci/config/get.ts

heroku ci:config:set

set CI config vars

USAGE
  $ heroku ci:config:set [-a <value>] [-r <value>] [-p <value>]

FLAGS
  -a, --app=<value>       app to run command against
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use

DESCRIPTION
  set CI config vars

EXAMPLES
  $ heroku ci:config:set --pipeline PIPELINE RAILS_ENV=test
      Setting test config vars... done
      RAILS_ENV: test

See code: src/commands/ci/config/set.ts

heroku ci:config:unset

unset CI config vars

USAGE
  $ heroku ci:config:unset [-a <value>] [-r <value>] [-p <value>]

FLAGS
  -a, --app=<value>       app to run command against
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use

DESCRIPTION
  unset CI config vars

EXAMPLES
  $ heroku ci:config:unset RAILS_ENV

See code: src/commands/ci/config/unset.ts

heroku ci:debug

opens an interactive test debugging session with the contents of the current directory

USAGE
  $ heroku ci:debug [-a <value>] [--no-cache] [--no-setup] [-p <value>]

FLAGS
  -a, --app=<value>       app to run command against
  -p, --pipeline=<value>  name of pipeline
      --no-cache          start test run with an empty cache
      --no-setup          start test dyno without running test-setup

DESCRIPTION
  opens an interactive test debugging session with the contents of the current directory

See code: src/commands/ci/debug.ts

heroku ci:info TEST-RUN

show the status of a specific test run

USAGE
  $ heroku ci:info TEST-RUN [-a <value>] [-r <value>] [--node <value>] [-p <value>]

ARGUMENTS
  TEST-RUN  auto-incremented test run number

FLAGS
  -a, --app=<value>       app to run command against
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use
      --node=<value>      the node number to show its setup and output

DESCRIPTION
  show the status of a specific test run

EXAMPLES
  $ heroku ci:info 1288 --app murmuring-headland-14719

See code: src/commands/ci/info.ts

heroku ci:last

looks for the most recent run and returns the output of that run

USAGE
  $ heroku ci:last [-a <value>] [-r <value>] [--node <value>] [-p <value>]

FLAGS
  -a, --app=<value>       app to run command against
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use
      --node=<value>      the node number to show its setup and output

DESCRIPTION
  looks for the most recent run and returns the output of that run

EXAMPLES
  $ heroku ci:last --pipeline=my-pipeline --node 100

See code: src/commands/ci/last.ts

heroku ci:migrate-manifest

app-ci.json is deprecated. Run this command to migrate to app.json with an environments key.

USAGE
  $ heroku ci:migrate-manifest

DESCRIPTION
  app-ci.json is deprecated. Run this command to migrate to app.json with an environments key.

EXAMPLES
  $ heroku ci:migrate-manifest

See code: src/commands/ci/migrate-manifest.ts

heroku ci:open

open the Dashboard version of Heroku CI

USAGE
  $ heroku ci:open -a <value> [-h] [-r <value>] [-p <value>]

FLAGS
  -a, --app=<value>       (required) app to run command against
  -h, --help              Show CLI help.
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use

DESCRIPTION
  open the Dashboard version of Heroku CI

EXAMPLES
  $ heroku ci:open --app murmuring-headland-14719

See code: src/commands/ci/open.ts

heroku ci:rerun [NUMBER]

rerun tests against current directory

USAGE
  $ heroku ci:rerun [NUMBER] [-a <value>] [-r <value>] [-p <value>]

ARGUMENTS
  NUMBER  auto-incremented test run number

FLAGS
  -a, --app=<value>       app to run command against
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use

DESCRIPTION
  rerun tests against current directory

EXAMPLES
  $ heroku ci:rerun 985 --app murmuring-headland-14719

See code: src/commands/ci/rerun.ts

heroku ci:run

run tests against current directory

USAGE
  $ heroku ci:run [-a <value>] [-r <value>] [-p <value>]

FLAGS
  -a, --app=<value>       app to run command against
  -p, --pipeline=<value>  name of pipeline
  -r, --remote=<value>    git remote of app to use

DESCRIPTION
  run tests against current directory

EXAMPLES
  $ heroku ci:run --app murmuring-headland-14719

See code: src/commands/ci/run.ts