アプリのローカルでの実行

この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。

最終更新日 2023年03月13日(月)

この記事では、Heroku Local CLI プラグインを使用する方法について説明します。

Heroku Local コマンドラインツールを使用して、アプリをローカルで実行する

Heroku Local は、Procfile​ でバックアップされたアプリを実行するためのコマンドラインツールです。これは、Heroku CLI​ の一部として自動的にインストールされます。Heroku Local は、.env ファイルから環境設定を読み取り​ます。 Heroku Local は、node-foreman​ を使用してそのタスクを実行します。

アプリをローカルで起動する

Procfile​ で定義されているすべてのプロセスタイプをローカルで起動するには、次のようにします。

$ heroku local

heroku local​ は、同じ操作を実行する heroku local:start​ の短い形式です。

特定のプロセスタイプをローカルで起動するには、そのプロセスタイプを指定します。たとえば、"web" または “worker” を指定します。

$ heroku local web

これで、アプリをローカルでテストできるようになります。完了したら、Ctrl+C を押してシャットダウンします。

コマンドラインオプションのいくつかを次に示します。

  • 別の Procfile を使用するには、-f​ フラグを使用します (heroku local -f Procfile.test​)。

  • 別の環境ファイルを使用するには、-e​ フラグを使用します (heroku local -e .env.test​)。

  • 別のポートを使用するには、-p​ フラグを使用します (heroku local -p 7000​)。ポートを指定しない場合は、5000 が使用されます。

詳細情報を表示するには、コマンドラインで「heroku help local​」と入力します。

単発コマンドをローカルで実行する

Heroku Local でも、1 つの単発コマンドをローカルで簡単に実行できます。たとえば、heroku local:run rails console​ とします。これは、Heroku の One-off dyno​ に似ています。

ローカル環境変数を設定する

アプリを実行する場合は、通常、一連の環境設定​を使用してアプリの設定を取得します。 たとえば、アプリで画像の保存のために S3 を使用しています。 資格情報を環境設定として S3 に保存したいとします。アプリをローカルで実行している場合は、通常、本番環境で実行している場合とは別の S3 バケットを使用します。

.env​ ファイルを使用すると、アプリをローカルで実行するために必要なすべての環境設定を取得できます。 heroku local​ コマンドのいずれかを使用してアプリを起動した場合は、.env​ ファイルが読み取られ、環境設定のアクションを模倣するために名前と値の各ペアが環境に挿入されます。

アプリの環境設定を表示する

アプリのすべての環境設定を表示するには、「heroku config​」と入力します。

.env ファイルの内容を確認する

$ cat .env

.env​ ファイルの例を次に示します。

S3_KEY=mykey
S3_SECRET=mysecret

.env ファイルに環境設定を追加する

資格情報やその他の機密の設定値をソース管理にコミットするべきではありません。Git では、echo .env >> .gitignore​ を使用して .env​ ファイルを除外してください。

.env ファイルに環境設定を追加するには、そのファイルを編集し、新しい行に新しい name=value のペアを追加します。

ローカルの .env ファイルに Heroku 環境設定をコピーする

ローカル環境と Heroku 環境の両方で同じ環境設定を使用したい場合があります。 .env​ ファイルに追加する環境設定ごとに、次のコマンドを使用します。

$ heroku config:get CONFIG-VAR-NAME -s  >> .env

.env​ ファイルをソース管理にコミットしないでください。これはローカル設定にだけ使用してください。.env​ ファイルを除外するように .gitignore​ ファイルを更新します。

デプロイされた本番アプリは、ローカルの開発アプリとは別のサービスに接続する可能性があることに注意してください。たとえば、デプロイされた本番アプリには Heroku Postgres データベースを参照する DATABASE_URL​ 環境設定が含まれているが、ローカルアプリには Postgres のローカルインストールを参照する .env​ ファイル内の DATABASE_URL​ 変数が含まれていることがあります。

Foreman を使用してアプリをローカルで実行する

Heroku Local を使用する代わりに、引き続き Foreman を使用してアプリをローカルで実行できます。正式にはサポートされていませんが、これを使用したい場合は、Foreman の GitHub リポジトリ​にアクセスすることによって詳細情報を入手できます。

Foreman は、Procfile​ でバックアップされたアプリを実行するためのコマンドラインツールです。Foreman は、.env ファイルから環境設定を読み取り​ます。

アプリをローカルで起動する

$ foreman start
18:06:23 web.1     | started with pid 47219
18:06:23 worker.1  | started with pid 47220
18:06:25 worker.1  | (in /Users/adam/myapp)
18:06:27 web.1     | => Awesome web application server output

web​ と worker​ の両方のプロセスタイプを含む Procfile があった場合、Foreman は各プロセスタイプの 1 つを起動し、出力がターミナルにインタリーブされます。Web プロセスは、Foreman が $PORT​ 環境変数でデフォルト値として提供するポート 5000 でロードされます。これはデプロイ時に Heroku プラットフォームによって使用されるため、Web プロセスがこの値を順守することが重要です。

これで、アプリをローカルでテストできるようになります。完了したら、Ctrl+C​ を押してシャットダウンします。

あるいは、foreman -e alternate_env start​ のように -e​ フラグを使用して、起動時に別の環境ファイルを選択することもできます。

単発コマンドをローカルで実行する

Foreman でも、1 つの単発コマンドをローカルで簡単に実行できます。たとえば、foreman run rails console​ とします。これは、Heroku の One-off dyno​ に似ています。