CLI の使用法

最終更新日 2021年12月02日(木)

heroku help​ を実行すると、使用法の概要が表示されます。

Usage: heroku COMMAND

Help topics, type heroku help TOPIC for more details:

 access          manage user access to apps
 addons          manage add-ons
 apps            manage apps
 authorizations  OAuth authorizations
 buildpacks      manage the buildpacks for an app
 certs           a topic for the ssl plugin
 ci              run an application test suite on Heroku
 clients         OAuth clients on the platform
 config          manage app config vars
 domains         manage the domains for an app
 drains          list all log drains
 features        manage optional features
 git             manage local git repository for app
 keys            manage ssh keys
 labs            experimental features
 local           run heroku app locally
 logs            display recent log output
 maintenance     manage maintenance mode for an app
 members         manage organization members
 notifications   display notifications
 orgs            manage organizations
 pg              manage postgresql databases
 pipelines       manage collections of apps in pipelines
 plugins         manage plugins
 ps              manage dynos (dynos, workers)
 redis           manage heroku redis instances
 regions         list available regions
 releases        manage app releases
 run             run a one-off process inside a Heroku dyno
 sessions        OAuth sessions
 spaces          manage heroku private spaces
 status          status of the Heroku platform
 teams           manage teams

コマンドは一般コマンドとアプリコマンドの 2 種類に分けられます。

一般コマンド

一般コマンドは Heroku アカウント全体に作用し、特定のアプリに固有ではありません。 たとえば、自分が作成したアプリと、共同作業者として関わっているアプリの一覧を表示するには、次のようにします。

$ heroku apps
=== user@example.org Apps
example
example2

=== Collaborated Apps
collabapp                 owner@example.org

アプリコマンド

アプリコマンドは通常、アプリのローカル Git クローン内から実行されます。 アプリ名は、現在の作業コピーの Git リモートをスキャンすることによって自動的に検出されるため、操作するアプリを明示的に指定する必要はありません。たとえば、heroku apps:info​ コマンドは --app​ を指定して呼び出すか、作業コピー内で引数なしで実行することができます。

$ cd example
$ heroku apps:info
=== example-app-69977
Auto Cert Mgmt: false
Dynos:
Git URL:        https://git.heroku.com/example-app-69977.git
Owner:          your@emailaddress.com
Region:         us
Repo Size:      0 B
Slug Size:      0 B
Stack:          heroku-18
Web URL:        https://example-app-69977.herokuapp.com/

複数の Heroku リモートがあるか、ローカル作業コピーの外でアプリコマンドを実行する場合、次のようにリモート名または明示的なアプリ名を指定できます。

$ heroku apps:info --app example
$ heroku apps:info --remote production

あるいは、HEROKU_APP​ 環境変数を設定することによってもアプリ名を指定できます。

HTTP プロキシの使用

外部の HTTP/HTTPS サービスへの接続にプロキシの使用が必要なファイアウォールを使っている場合は、heroku​ コマンドを実行する前に、ローカルの開発者環境で HTTP_PROXY​ または HTTPS_PROXY​ 環境変数を設定できます。

UNABLE_TO_GET_ISSUER_CERT_LOCALLY​ または ECONNREFUSED​ エラーが発生した場合、おそらくこれが原因です。

たとえば、Unix システムでは次のようにして設定できます。

$ export HTTP_PROXY=http://proxy.server.com:portnumber
or
$ export HTTPS_PROXY=https://proxy.server.com:portnumber
$ heroku login

Windows マシンでは、[システムのプロパティ] の [環境変数] で設定するか、ターミナルから次のようにして設定します。

> set HTTP_PROXY=http://proxy.server.com:portnumber
or
> set HTTPS_PROXY=https://proxy.server.com:portnumber
> heroku login

~/.bashrc​ (または同等の設定ファイル) にこれを保存しておけば、新しいシェルセッションを開くたびに実行する必要はありません。

会社のインターネットで MITM プロキシを使用する必要がある場合、SELF_SIGNED_CERT_IN_CHAIN​ エラーが発生することがあります。NODE_EXTRA_CA_CERTS​ には、プロキシの認証局 (CA) 証明書 (pem 形式) のファイルの場所を設定する必要があります。または、自己署名証明書を直接発行した場合は、SSL_CERT_FILE​ または SSL_CERT_DIR​ を MITM 証明書を含むファイル/ディレクトリに設定します。

$ export NODE_EXTRA_CA_CERTS=/path/to/ca_cert.pem
$ heroku whoami