@heroku-cli/plugin-run

heroku-run

Heroku CLI plugin to run one-off dyno processes.

Commands

heroku run

run a one-off process inside a heroku dyno

-s, --size dyno size

--exit-code passthrough the exit code of the remote command

run a one-off process inside a Heroku dyno
Example:

  $ heroku run bash
  Running bash on app... up, run.1
  ~ $

  $ heroku run -s hobby -- myscript.sh -a arg1 -s arg2
  Running myscript.sh -a arg1 -s arg2 on app... up, run.1

Commands

• @heroku-cli/plugin-run logs
• @heroku-cli/plugin-run run
• @heroku-cli/plugin-run run:detached

logs

display recent log output

USAGE
  $ @heroku-cli/plugin-run logs

OPTIONS
  -a, --app=app        (required) app to run command against
  -d, --dyno=dyno      dyno to limit filter by
  -n, --num=num        number of lines to display
  -r, --remote=remote  git remote of app to use
  -s, --source=source  log source to limit filter by
  -t, --tail           continually stream logs
  --force-colors       force use of colors (even on non-tty output)

DESCRIPTION
  Example:

       $ heroku logs
       2012-01-01T12:00:00+00:00 heroku[api]: Config add EXAMPLE by [e-mail]
       2012-01-01T12:00:01+00:00 heroku[api]: Release v1 created by [e-mail]

run

run a one-off process inside a heroku dyno

USAGE
  $ @heroku-cli/plugin-run run

OPTIONS
  -a, --app=app        (required) app to run command against
  -e, --env=env        environment variables to set (use ';' to split multiple vars)
  -r, --remote=remote  git remote of app to use
  -s, --size=size      dyno size
  -x, --exit-code      passthrough the exit code of the remote command
  --no-tty             force the command to not run in a tty
  --type=type          process type

DESCRIPTION
  Examples:

       $ heroku run bash
       Running bash on app.... up, run.1
       ~ $

       $ heroku run -s hobby -- myscript.sh -a arg1 -s arg2
       Running myscript.sh -a arg1 -s arg2 on app.... up, run.1

run:detached

run a detached dyno, where output is sent to your logs

USAGE
  $ @heroku-cli/plugin-run run:detached

OPTIONS
  -a, --app=app        (required) app to run command against
  -e, --env=env        environment variables to set (use ';' to split multiple vars)
  -r, --remote=remote  git remote of app to use
  -s, --size=size      dyno size
  -t, --tail           stream logs from the dyno
  --type=type          process type

DESCRIPTION
  Example:

       $ heroku run:detached ls
       Running ls on app [detached]... up, run.1
       Run heroku logs -a app -p run.1 to view the output.

run:detached

run a detached dyno, where output is sent to your logs

USAGE
  $ @heroku-cli/plugin-run run:detached

OPTIONS
  -a, --app=app        (required) app to run command against
  -e, --env=env        environment variables to set (use ';' to split multiple vars)
  -r, --remote=remote  git remote of app to use
  -s, --size=size      dyno size
  -t, --tail           stream logs from the dyno
  --type=type          process type

DESCRIPTION
  Example:

       $ heroku run:detached ls
       Running ls on app [detached]... up, run.1
       Run heroku logs -a app -p run.1 to view the output.