heroku/cli v9.0.0

on GitHub

Version 9.0.0 of the Heroku CLI is mainly an architectural update. With this update, we build all of the core CLI commands on the oclif platform. Previously, many of them used pre-oclif architecture. All the core CLI commands also move into one package, instead of being in many different packages. These changes only apply to the commands included with the core Heroku CLI. It doesn't include commands installed separately via plugins.

Most commands function the same as before. Here are the breaking changes to be aware of, as well as feature updates.

Breaking Changes

Formatting

The switch to oclif/core means a change to the formatting of some of our output. The main differences are additional new lines and whitespace, table formatting, and output colors. If you parse CLI output at all, you can encounter some errors.

Additional Flags

You can pass additional flags to the triggered operation, such as run commands, or to a config object, like with the addons:create command. The syntax for adding additional flags changes with v9.0.0 of the Heroku CLI. Previously, users added additional flags without any separation of those flags from the Heroku CLI command itself. To pass additional flags, you must add a -- separator between the flags and the CLI command. For example:
Before v9.0.0: heroku run bash --norc -a APP_NAME
v9.0.0+: heroku run bash -a APP_NAME -- --norc

certs:update Command

• We removed the --bypass flag as it's no longer necessary. This command functions as normal, but you can get an error if you include the flag.

pg:settings Commands

• We changed the order of the required arguments for several of the pg:settings commands. Previously, we expected the value arg to come before the database arg, but we reversed this to resolve a logic issue. Now, you must add the database arg first and the value arg second.

spaces:vpn Commands

• Previously, these commands accepted the name of the VPN connection as either an argument or the value of the --name flag. With v9.0.0, these commands only accept the VPN connection name as an argument. The --name flag no longer exists.

run:inside Command

• The --env flag has been removed from the run:inside command. This change was not related to the oclif migration work, but needed for other projects.

Removed Commands

• We removed the outbound-rules commands. We removed the API endpoints for these commands in June
• We also removed several hidden and previously deprecated commands
  • pg:repoint
  • orgs:default
  • certs:chain
  • certs:key

Feature Updates

• container commands now print an error when running on stacks that aren't container stacks.
• We added notifications for accounts with delinquent payments.

Commits

• b7bff57 Refactor!: migrate all legacy commands to Typescript and oclif/core and move them to the cli package (#2927)
• c2d1f8d update ci workflow for "Tests" (#2903)
• 22e2951 chore(deps): bump filesize from 4.0.0 to 10.1.2 (#2890)
• 2568e55 Upgrade version of otel semantic conventions to 1.24 (#2887)
• afb6b49 chore(deps): bump @opentelemetry/instrumentation from 0.50.0 to 0.51.1 (#2882)
• b24fbd6 chore(deps-dev): bump @types/supports-color from 5.3.0 to 8.1.3 (#2702)
• c9a810c Updated 'heroku-cli-util' dependency version and its dependencies (#2863)
• 7d12be2 chore: separate unit testing and linting (#2858)