Heroku スターターガイド (Python)
この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。
最終更新日 2023年06月07日(水)
Table of Contents
はじめに
このチュートリアルを完了して、サンプル Python Django アプリを Heroku にデプロイします。
このチュートリアルでは、以下が用意されていることを前提としています。
- 確認済みの Heroku アカウント
- ローカルにインストールされた Python 3.11。インストールについては、OS X、Windows、Linux のガイドを参照してください。
- Eco dyno プランのサブスクリプション (推奨)
dyno とデータベースを使用してこのチュートリアルを完了した場合、使用量のカウントに入ります。低料金プランを使用してこのチュートリアルを完了することをお勧めします。資格のある学生の皆様は、新しい Heroku for GitHub Students プログラムを通じてプラットフォームクレジットを申請できます。
設定する
Heroku CLI には、一般によく使われている Git というバージョン管理システムが必要です。Git がインストールされていない場合は、先に進む前に次の手順を完了してください。
Heroku Command Line Interface (CLI) をインストールします。CLI は、アプリケーションの管理やスケール、アドオンのプロビジョニング、ログの表示、アプリケーションのローカル実行に使用できます。
お使いのプラットフォーム用のインストーラをダウンロードし、実行してください。
$ brew tap heroku/brew && brew install heroku
インストール後、コマンドシェルで heroku
コマンドを使用できます。
Heroku CLI にログインするには、heroku login
コマンドを使用します。
$ heroku login
heroku: Press any key to open up the browser to login or q to exit:
Opening browser to https://cli-auth.heroku.com/auth/cli/browser/***
Logging in... done
Logged in as me@example.com
このコマンドにより、Web ブラウザで Heroku ログインページが開きます。ブラウザですでに Heroku にログインしている場合は、ページに表示されている[Log in] (ログイン) ボタンをクリックします。
この認証は、heroku
と git
コマンドが正常に動作するために必要な操作です。
Heroku CLI のインストールや使用に問題がある場合は、アドバイスとトラブルシューティングステップについて、Heroku CLI のメイン記事を参照してください。
外部の HTTP/HTTPS サービスへの接続にプロキシを使用するファイアウォールを利用している場合は、heroku
コマンドを実行する前に、ローカルの開発環境で HTTP_PROXY
または HTTPS_PROXY
環境変数を設定してください。
アプリを複製する
Heroku をはじめて使う場合は、 Heroku が提供するサンプルアプリケーションを使ってこのチュートリアルを行うことをお勧めします。
デプロイする既存のアプリケーションを用意してある場合は、 代わりにこの記事に従います。
コードのローカルバージョンを得るために、サンプルアプリケーションを複製します。以下のコマンドをローカルのコマンドシェルまたはターミナルで実行します。
$ git clone https://github.com/heroku/python-getting-started.git
$ cd python-getting-started
これで、シンプルなアプリケーションを格納した、正常な Git リポジトリを準備できました。これには、使用する Python バージョンを指定する runtime.txt
と、Python の依存関係マネージャー Pip によって使用される requirements.txt
が含まれています。
Procfile を定義する
Procfile は、アプリケーションのルートディレクトリにあるテキストファイルです。このファイルを使って、アプリの起動時に実行するコマンドを明示的に宣言します。
サンプルアプリの Procfile
は、次のようになっています。
web: gunicorn gettingstarted.wsgi
この Procfile では、単一のプロセスタイプの web
と、その実行に必要なコマンドを宣言しています。 ここでは、web
という名前が重要です。 これは、このプロセスタイプを Heroku の HTTP ルーティングスタックにアタッチし、デプロイ後に Web トラフィックを受信することを宣言しています。 ここで使われているコマンドは、Gunicorn (Web サーバー) を実行し、設定ファイルを渡しています。
Procfile には追加のプロセスタイプを含めることができます。 たとえば、キューからアイテムを取り出して処理するバックグラウンドワーカープロセスを宣言できます。
Microsoft Windows
サンプルアプリには、Microsoft Windows でローカル開発を行うための追加 Procfile
があり、ファイル Procfile.windows
内に配置されています。 チュートリアルの後半のステップでは、代わりにこの Procfile を使用して、Windows と互換性のある別の Web サーバーを起動します。
web: python manage.py runserver 0.0.0.0:5000
アプリを作成してデプロイする
Eco にサブスクライブしている場合、アプリではデフォルトで Eco dyno が使用されます。それ以外の場合は、デフォルトで Basic dyno が使用されます。Eco dyno プランは、アカウントのすべての Eco dyno 間で共有され、多数の小さなアプリを Heroku にデプロイする場合にお勧めします。詳細は、こちらを参照してください。資格のある学生の皆様は、Heroku for GitHub Students プログラムを通じてプラットフォームクレジットを申請できます。
Heroku でソースコードを受け取る準備をするには、アプリを作成します。
$ heroku create
Creating app... done, ⬢ serene-caverns-82714
https://serene-caverns-82714.herokuapp.com/ | https://git.heroku.com/serene-caverns-82714.git
アプリを作成すると、heroku
という名前の Git リモートリポジトリも作成され、ローカルの Git リポジトリと関連付けられます。Git リモートは、他のサーバー上で稼働するリポジトリのバージョンです。アプリに関連付けられた、Heroku でホストされる特別なリモートにコードをプッシュすることにより、アプリをデプロイします。
Heroku によってランダムなアプリ名 (このケースでは serene-caverns-82714
) が生成されます。独自のアプリ名を指定できます。
コードをデプロイします。このコマンドは、サンプルリポジトリの main
ブランチを heroku
リモートにプッシュし、次に Heroku にデプロイします。
$ git push heroku main
Enumerating objects: 558, done.
Counting objects: 100% (558/558), done.
Delta compression using up to 10 threads
Compressing objects: 100% (260/260), done.
Writing objects: 100% (558/558), 109.23 KiB | 109.23 MiB/s, done.
Total 558 (delta 251), reused 558 (delta 251), pack-reused 0
remote: Compressing source files... done.
remote: Building source:
remote:
remote: -----> Building on the Heroku-22 stack
remote: -----> Determining which buildpack to use for this app
remote: -----> Python app detected
remote: -----> Using Python version specified in runtime.txt
remote: -----> Installing python-3.11.4
remote: -----> Installing pip 23.1.2, setuptools 67.7.2 and wheel 0.40.0
remote: -----> Installing SQLite3
remote: -----> Installing requirements with pip
remote: Collecting django<5.0,>=4.2 (from -r requirements.txt (line 1))
remote: Downloading Django-4.2.2-py3-none-any.whl (8.0 MB)
remote: Collecting gunicorn<21.0,>=20.0 (from -r requirements.txt (line 2))
remote: Downloading gunicorn-20.1.0-py3-none-any.whl (79 kB)
remote: Collecting dj-database-url<3.0,>=2.0 (from -r requirements.txt (line 3))
remote: Downloading dj_database_url-2.0.0-py3-none-any.whl (7.6 kB)
remote: Collecting whitenoise[brotli]<7.0,>=6.0 (from -r requirements.txt (line 4))
remote: Downloading whitenoise-6.4.0-py3-none-any.whl (19 kB)
remote: Collecting asgiref<4,>=3.6.0 (from django<5.0,>=4.2->-r requirements.txt (line 1))
remote: Downloading asgiref-3.7.2-py3-none-any.whl (24 kB)
remote: Collecting sqlparse>=0.3.1 (from django<5.0,>=4.2->-r requirements.txt (line 1))
remote: Downloading sqlparse-0.4.4-py3-none-any.whl (41 kB)
remote: Collecting typing-extensions>=3.10.0.0 (from dj-database-url<3.0,>=2.0->-r requirements.txt (line 3))
remote: Downloading typing_extensions-4.6.3-py3-none-any.whl (31 kB)
remote: Collecting Brotli (from whitenoise[brotli]<7.0,>=6.0->-r requirements.txt (line 4))
remote: Downloading Brotli-1.0.9-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.7 MB)
remote: Installing collected packages: Brotli, whitenoise, typing-extensions, sqlparse, gunicorn, asgiref, django, dj-database-url
remote: Successfully installed Brotli-1.0.9 asgiref-3.7.2 dj-database-url-2.0.0 django-4.2.2 gunicorn-20.1.0 sqlparse-0.4.4 typing-extensions-4.6.3 whitenoise-6.4.0
remote: -----> $ python manage.py collectstatic --noinput
remote: WARNING:root:No DATABASE_URL environment variable set, and so no databases setup
remote: 1 static file copied to '/tmp/build_968e7f49/staticfiles', 1 post-processed.
remote:
remote: -----> Discovering process types
remote: Procfile declares types -> web
remote:
remote: -----> Compressing...
remote: Done: 34.2M
remote: -----> Launching...
remote: Released v3
remote: https://serene-caverns-82714.herokuapp.com/ deployed to Heroku
remote:
remote: Verifying deploy... done.
To https://git.heroku.com/serene-caverns-82714.git
* [new branch] main -> main
アプリケーションがデプロイされました。アプリのインスタンスが 1 つ以上実行されていることを確認します。
$ heroku ps:scale web=1
ps:scale
の実行時にエラー Couldn't find that process type (web)
が表示された場合は、アプリがまだデプロイ中であることを意味します。数分待ってから、再試行してください。
デプロイの出力に示されている URL でアプリにアクセスします。 次のショートカットを使って、Web サイトを簡単に開くこともできます。
$ heroku open
ログを表示する
Heroku では、すべてのアプリと Heroku のコンポーネントの出力ストリームから集約した時系列イベントのストリームとして、ログが扱われます。Heroku は、すべてのイベントに単一のストリームを提供します。
実行中のアプリに関する情報を表示するには、ログコマンドの 1 つである、heroku logs --tail
を使います。
$ heroku logs --tail
2023-05-21T19:43:55.517618+00:00 heroku[web.1]: Starting process with command `gunicorn gettingstarted.wsgi`
2023-05-21T19:43:57.648597+00:00 app[web.1]: [2023-05-21 19:43:57 +0000] [2] [INFO] Starting gunicorn 20.1.0
2023-05-21T19:43:57.648864+00:00 app[web.1]: [2023-05-21 19:43:57 +0000] [2] [INFO] Listening at: http://0.0.0.0:10251 (2)
2023-05-21T19:43:57.648891+00:00 app[web.1]: [2023-05-21 19:43:57 +0000] [2] [INFO] Using worker: sync
2023-05-21T19:43:57.650832+00:00 app[web.1]: [2023-05-21 19:43:57 +0000] [7] [INFO] Booting worker with pid: 7
2023-05-21T19:43:57.727392+00:00 app[web.1]: [2023-05-21 19:43:57 +0000] [8] [INFO] Booting worker with pid: 8
2023-05-21T19:43:57.756315+00:00 app[web.1]: WARNING:root:No DATABASE_URL environment variable set, and so no databases setup
2023-05-21T19:43:57.819600+00:00 heroku[web.1]: State changed from starting to up
2023-05-21T19:43:57.831493+00:00 app[web.1]: WARNING:root:No DATABASE_URL environment variable set, and so no databases setup
2023-05-21T19:44:11.439451+00:00 heroku[router]: at=info method=GET path="/" host=serene-caverns-82714.herokuapp.com request_id=df14c065-0d94-45b7-b21e-6e69a0ad93e2 fwd="123.45.67.89" dyno=web.1 connect=0ms service=31ms status=200 bytes=7719 protocol=https
さらに他の生成されたログメッセージを表示するには、まずブラウザでアプリケーションにアクセスします。
ログのストリーム出力を停止するには、Control+C
を押します。
アプリをスケールする
サンプルアプリをデプロイすると、1 つの Web dyno で自動的に実行されます。 dyno とは、Procfile
で指定されているコマンドを実行する軽量のコンテナのようなものです。
実行されている dyno の数を確認するには、ps
コマンドを使います。
$ heroku ps
Eco dyno hours quota remaining this month: 999h 50m (99%)
Eco dyno usage for this app: 0h 0m (0%)
For more information on dyno sleeping and how to upgrade, see:
https://devcenter.heroku.com/articles/dyno-sleeping
=== web (Eco): gunicorn gettingstarted.wsgi (1)
web.1: up 2023/01/19 16:49:42 +0000 (~ 3m ago)
Heroku でアプリケーションをスケールするとは、実行中の dyno の数を変更することを意味します。 Web dyno の数を 0 にスケールしてみます。
$ heroku ps:scale web=0
Scaling dynos... done, now running web at 0:Eco
ブラウザのタブで更新ボタンを押してアプリにアクセスするか、heroku open
コマンドを使ってブラウザのタブで開きます。 リクエストに応答できる Web dyno がなくなったので、エラーメッセージが表示されます。
もう一度スケールしてみましょう。
$ heroku ps:scale web=1
Scaling dynos... done, now running web at 1:Eco
Eco にサブスクライブしている場合、アプリではデフォルトで Eco dyno が使用されます。それ以外の場合は、デフォルトで Basic dyno が使用されます。Eco dyno プランは、アカウントのすべての Eco dyno 間で共有され、多数の小さなアプリを Heroku にデプロイする場合にお勧めします。Eco dyno は 30 分間トラフィックを何も受信しないとスリープします。 このスリープ動作により、スリープ解除した最初のリクエストで数秒の遅延が発生します。Eco dyno は、月ごとに割り当てられるアカウント別の Eco dyno 時間を消費します。割り当て時間が残っている限り、アプリは稼働し続けます。
dyno がスリープしないようにするには、「dyno タイプ」の記事で紹介されている Basic 以上の dyno タイプにアップグレードします。少なくとも Standard dyno にアップグレードすることで、プロセスタイプあたり複数の dyno にスケールアップできます。
アプリの依存関係をローカルでインストールする
Heroku では、主要なファイルを探すことでアプリを Python アプリとして認識します。Python アプリを認識する 1 つの方法は、ルートディレクトリに requirements.txt
を格納することです。
デプロイしたデモ用アプリには、事前に次のような requirements.txt
が用意されています。
django>=4.2,<5.0
gunicorn>=20.0,<21.0
dj-database-url>=2.0,<3.0
whitenoise[brotli]>=6.0,<7.0
requirements.txt
ファイルにはアプリの依存関係がリストされています。Heroku がアプリをデプロイすると、プラットフォームはこのファイルを読み出し、pip install -r
コマンドを使用して適切な Python の依存関係をインストールします。
依存関係をローカルでインストールするには、仮想環境 (venv
とも呼ばれる) を作成します。この環境を使用すると、システム Python のインストールに影響を与えずに、パッケージをインストールできます。次のコマンドで、サンプルアプリのディレクトリ内に仮想環境を作成します。
$ python3 -m venv --upgrade-deps .venv
次に、仮想環境をアクティブにします。
Microsoft Windows システム をご使用の場合は、次のコマンドでアクティブにします。
.\.venv\Scripts\activate
macOS/Linux システムをご使用の場合は、次のコマンドでアクティブにします。
source .venv/bin/activate
仮想環境の設定に関するヘルプについては、Python のドキュメントを参照してください。
最後に、新しく作成した環境に依存関係をインストールします。
$ pip install -r requirements.txt
依存関係をインストールすると、それらの依存関係もインストールされます。インストールされる依存関係は、Pip の list
機能を使用して表示できます。
$ pip list
Package Version
----------------- -------
asgiref 3.6.0
Brotli 1.0.9
dj-database-url 2.0.0
Django 4.2.1
gunicorn 20.1.0
pip 23.1.2
setuptools 67.8.0
sqlparse 0.4.4
typing_extensions 4.5.0
whitenoise 6.4.0
依存関係がインストールされたら、アプリをローカルで実行できます。
アプリをローカルで実行する
続行する前にアプリの依存関係をローカルで インストールしていることを確認します。
heroku local
を使ってアプリケーションをローカルで起動します。このコマンドは、Heroku CLI の一部です。
Microsoft Windows システム をご使用の場合は、次のコマンドを実行します。
$ heroku local -f Procfile.windows
macOS/Linux システムをご使用の場合は、次のコマンドを実行して、デフォルトの Procfile
を使用します。
$ heroku local
コマンドを実行するとローカル Web サーバーが起動します。
[OKAY] Loaded ENV .env File as KEY=VALUE Format
17:39:12 web.1 | [2023-01-19 17:39:12 +0000] [18471] [INFO] Starting gunicorn 20.1.0
17:39:12 web.1 | [2023-01-19 17:39:12 +0000] [18471] [INFO] Listening at: http://0.0.0.0:5000 (18471)
17:39:12 web.1 | [2023-01-19 17:39:12 +0000] [18471] [INFO] Using worker: sync
17:39:12 web.1 | [2023-01-19 17:39:12 +0000] [18472] [INFO] Booting worker with pid: 18472
Connection in use
エラーが表示された場合は、他の実行中のプログラムがポート 5000 を使用していないことを確認します。macOS Monterey では、Airplay Receiver がポート 5000 上で実行します。これを無効にするには、System Preferences
(システム設定) -> Sharing
(共有) にアクセスし、Airplay Receiver
をオフにします。
Heroku と同じように、heroku local
は Procfile
を使用して実行するコマンドを認識します。
アプリケーションがローカルで実行していることを確認するには、Web ブラウザで「http://localhost:5001」を開きます。
アプリのローカル実行を停止するには、CLI で Control + C
を押して終了します。
ローカルの変更をプッシュする
このステップでは、アプリケーションへのローカルでの変更を Heroku に反映させます。
requests
パッケージを requirements.txt
ファイルに追加します。
django>=4.2,<5.0
gunicorn>=20.0,<21.0
dj-database-url>=2.0,<3.0
whitenoise[brotli]>=6.0,<7.0
requests
pip を使用して requests
パッケージを更新された requirements.txt
ファイル経由でインストールします。
$ pip install -r requirements.txt
hello/views.py
を変更して、requests
モジュールと Django HttpResponse
クラスをファイルの上部にインポートします。
import requests
from django.http import HttpResponse
次に、モジュールを使用するように、index
メソッドを変更します。 現在の index
メソッドを次のコードで置き換えてみます。
def index(request):
r = requests.get('https://httpbin.org/status/418')
print(r.text)
return HttpResponse('<pre>' + r.text + '</pre>')
次にローカルで再びテストします。
Microsoft Windows システム をご使用の場合は、次のコマンドを実行します。
$ heroku local -f Procfile.windows
macOS/Linux システムをご使用の場合は、次のコマンドを実行して、デフォルトの Procfile
を使用します。
$ heroku local
http://localhost:5000 でアプリケーションにアクセスし、http://httpbin.org/status/418 のフェッチの出力を確認します。
-=[ teapot ]=-
_...._
.' _ _ `.
| ."` ^ `". _,
\_;`"---"`|//
| ;/
\_ _/
`"""`
ブラウザにエラー Internal Server Error
が表示され、ターミナルログ出力にエラー ModuleNotFoundError: No module named 'requests'
が表示されている場合、requests
パッケージが正常にインストールされたことを確認します。
次にデプロイします。 Heroku へのデプロイは、ほとんどの場合、このパターンで行います。 まず、変更したファイルをローカルの git リポジトリに追加します。
$ git add .
次に、変更内容をリポジトリにコミットします。
$ git commit -m "Demo"
次に、以前と同じようにデプロイします。
$ git push heroku main
最後に、すべて正常に動作しているかどうかを確認します。
$ heroku open
ログ記録アドオンをプロビジョニングする
アドオンは、アプリケーションですぐに使える追加サービスを提供するサードパーティのクラウドサービスです。永続性、ログ記録、モニタリングなど、さまざまなアドオンがあります。
Heroku では、デフォルトで 1500 行のアプリケーションログが記録されますが、完全なログストリームはサービスとして提供されています。複数のアドオンプロバイダが、ログの永続化、検索、メールや SMS 通知などの機能を提供するログサービスを用意しています。
このステップでは、このようなログ関連アドオンの 1 つである、Papertrail をプロビジョニングします。
Papertrail ログ記録アドオンをプロビジョニングします。
$ heroku addons:create papertrail
Creating papertrail on ⬢ serene-caverns-82714... free
Welcome to Papertrail. Questions and ideas are welcome (technicalsupport@solarwinds.com). Happy logging!
Created papertrail-convex-88929 as PAPERTRAIL_API_TOKEN
Use heroku addons:docs papertrail to view documentation
アドオンがデプロイされ、アプリケーション用に設定されました。 アプリのアドオンは、次のコマンドで一覧表示できます。
$ heroku addons
このアドオンが動作していることを確認するため、アプリケーションの Heroku URL に数回アクセスします。アクセスするたびにログメッセージが生成され、Papertrail のアドオンに送られます。 Papertrail のコンソールにアクセスし、ログメッセージを確認します。
$ heroku addons:open papertrail
ブラウザで Papertrail の Web コンソールが開き、最新のログイベントが表示されます。このインターフェースでは、検索したり通知を設定したりできます。
コンソールを起動する
One-off dyno で、heroku run
コマンドを使ってコマンド (通常はアプリの一部を構成するスクリプトやアプリケーション) を実行できます。アプリの環境で試行するためにローカルターミナルにアタッチされた REPL プロセスを起動することもできます。
$ heroku run python manage.py shell
Running python manage.py shell on ⬢ serene-caverns-82714... up, run.9594 (Eco)
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>>
Error connecting to process
というエラーが表示された場合は、ファイアウォールを設定します。
アプリとアプリのすべての依存関係の環境で Python シェルが実行されます。ここから、一部のアプリケーションファイルをインポートできます。 たとえば、次のコードを実行できます。
>>> import requests
>>> print(requests.get('https://httpbin.org/status/418').text)
-=[ teapot ]=-
_...._
.' _ _ `.
| ."` ^ `". _,
\_;`"---"`|//
| ;/
\_ _/
`"""`
Python シェルを終了するには、exit()
コマンドを実行します。
別の例を試してみましょう。別の One-off dyno を作成し、bash
コマンドを実行して、その dyno でシェルを開きます。シェルが開いたら、そこでコマンドを実行できます。それぞれの dyno には専用の一時的ファイル領域があり、アプリとその依存関係が入力されています。コマンドが完了したら (このケースでは bash
)、dyno が終了します。:
$ heroku run bash
Running bash on ⬢ serene-caverns-82714... up, run.3789 (Eco)
~ $ ls
app.json gettingstarted hello manage.py Procfile Procfile.windows README.md requirements.txt runtime.txt staticfiles
~ $ exit
exit
必ず exit
と入力してシェルを閉じ、dyno を終了してください。
環境設定を定義する
Heroku では、暗号鍵や外部リソースのアドレスなどのデータを環境設定に保存して、設定を外部に置くことができます。
環境設定は、ランタイムに環境変数としてアプリケーションに提供されます。
hello/views.py
を編集します。ファイルの先頭に、os
モジュールをインポートする行を追加します。
import os
from django.http import HttpResponse
index
メソッドを編集し、環境変数 TIMES
の値に応じてあるアクションを繰り返し実行するようにします。
def index(request):
times = int(os.environ.get('TIMES', 3))
return HttpResponse('Hello! ' * times)
heroku local
は、ローカルディレクトリにある .env
ファイルの内容に応じて、環境を自動的に設定します。 サンプルプロジェクトのトップレベルディレクトリにはすでに .env
ファイルがあり、以下の行が含まれています。
TIMES=2
heroku local
でアプリを実行し、http://localhost:5000 にアクセスすると、「Hello!」が 2 回表示されます。
Heroku で環境設定を設定するには、次のコマンドを実行します。
$ heroku config:set TIMES=2
heroku config
を使用して、アプリの環境設定を表示します。
$ heroku config
=== serene-caverns-82714 Config Vars
PAPERTRAIL_API_TOKEN: <SECRET_TOKEN>
TIMES: 2
このアクションの変更を確認するには、変更したアプリケーションを Heroku にデプロイします。
データベースをプロビジョニングして使用する
add-on marketplace には、Redis や MongoDB、Postgres、MySQL など、多数のデータストアが揃っています。
mini
Postgres のサイズのコストは月額 5 ドルで、分単位で課金されます。このチュートリアルの最後で、データベースを削除して、コストを最小限に抑えるように求められます。
Heroku Mini Postgres アドオンをプロビジョニングするには、addons:create
コマンドを使用します。
$ heroku addons:create heroku-postgresql:mini
Creating heroku-postgresql:mini on ⬢ serene-caverns-82714... $5/month
Database has been created and is available
! This database is empty. If upgrading, you can transfer
! data from another database with pg:copy
Created postgresql-aerodynamic-21282 as DATABASE_URL
Use heroku addons:docs heroku-postgresql to view documentation
CLI で addons
コマンドを使うと、アプリにプロビジョニングされたデータベースの詳細について確認できます。
$ heroku addons
Add-on Plan Price State
──────────────────────────────────────────────── ──── ──────── ───────
heroku-postgresql (postgresql-aerodynamic-21282) mini $5/month created
└─ as DATABASE
...
アプリの環境設定を一覧表示すると、アプリがデータベースに接続するときに使用する URL (DATABASE_URL
) が表示されます。
$ heroku config
=== serene-caverns-82714 Config Vars
DATABASE_URL: postgres://emhmpvrhtwgqhx:<PASSWORD>@ec2-52-205-45-222.compute-1.amazonaws.com:5432/daacqaueosis8n
...
Heroku には、さらに詳細を表示する pg
コマンドもあります。
$ heroku pg
=== DATABASE_URL
Plan: Mini
Status: Available
Connections: 0/20
PG Version: 15.3
Created: 2023-05-21 20:31 UTC
Data Size: 7.6 MB/1.00 GB (In compliance)
Tables: 0
Rows: 0/10000 (In compliance)
Fork/Follow: Unsupported
Rollback: Unsupported
Continuous Protection: Off
Add-on: postgresql-aerodynamic-21282
この情報には、Mini データベースが Postgres v15.3 を実行しており、データがないことが示されます。
デプロイしたサンプルアプリにはすでにデータベース機能が備わっていますが、それを有効にするには、2 つの小さな変更を行う必要があります。
まず、requirements.txt
ファイルの末尾にある 2 行の psycopg
のコメントを解除します。
psycopg; sys_platform == "linux"
psycopg[binary]; sys_platform != "linux"
これらの行により、ビルド時に、Postgres データベースアダプターパッケージがインストールされます。
次に、Procfile
ファイルの末尾にある release
プロセス行のコメントを解除します。
release: ./manage.py migrate --no-input
この release
プロセスエントリによって、Heroku リリースフェーズ機能が有効になり、それを使用して、アプリのデプロイ時に常に Django データベース移行が実行されます。
前と同じデプロイプロセスを使用して、変更したアプリケーションを Heroku にデプロイします。ビルド後に Django のデータベース移行が実行されることを確認できます。
remote: Running release command...
remote:
remote: Operations to perform:
remote: Apply all migrations: auth, contenttypes, hello, sessions
remote: Running migrations:
remote: Applying contenttypes.0001_initial... OK
remote: Applying contenttypes.0002_remove_content_type_name... OK
remote: Applying auth.0001_initial... OK
remote: Applying auth.0002_alter_permission_name_max_length... OK
remote: Applying auth.0003_alter_user_email_max_length... OK
remote: Applying auth.0004_alter_user_username_opts... OK
remote: Applying auth.0005_alter_user_last_login_null... OK
remote: Applying auth.0006_require_contenttypes_0002... OK
remote: Applying auth.0007_alter_validators_add_error_messages... OK
remote: Applying auth.0008_alter_user_username_max_length... OK
remote: Applying auth.0009_alter_user_last_name_max_length... OK
remote: Applying auth.0010_alter_group_name_max_length... OK
remote: Applying auth.0011_update_proxy_permissions... OK
remote: Applying auth.0012_alter_user_first_name_max_length... OK
remote: Applying hello.0001_initial... OK
remote: Applying sessions.0001_initial... OK
remote: Waiting for release.... done.
ビルドが settings.DATABASES is improperly configured
エラーで失敗した場合は、デプロイの前にデータベースアドオンをプロビジョニングしていることを確認します。
アプリの URL にアクセスし、/db
を追加して、データベースデモンストレーションページにアクセスします。 たとえば、アプリが https://serene-caverns-82714.herokuapp.com/
にデプロイされている場合は、https://serene-caverns-82714.herokuapp.com/db
にアクセスします。
再度 /db
ルートにアクセスすると、アクセスするたびにシンプルなページの更新が表示されます。
Page View Report
May 21, 2023, 8:57 p.m.
May 21, 2023, 8:58 p.m.
データベースにアクセスするためのコードは簡単です。これは Greetings
というシンプルな Django モデルを使用しており、hello/models.py
にあります。
アプリの /db
ルートにアクセスするたびに hello/views.py
ファイル内の次のメソッドが呼び出され、挨拶が作成されます。次に、既存のすべての挨拶がレンダリングされます。
def db(request):
greeting = Greeting()
greeting.save()
greetings = Greeting.objects.all()
return render(request, 'db.html', {'greetings': greetings})
Postgres がローカルでインストールされている場合、heroku pg:psql
コマンドを使ってリモートデータベースに接続し、すべての行を表示します。
$ heroku pg:psql
--> Connecting to postgresql-cubed-97628
psql (14.1, server 14.7 (Ubuntu 14.7-2.pgdg20.04+1))
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.
serene-caverns-82714::DATABASE=>
詳細は、「Heroku PostgreSQL」を参照してください。
同様のテクニックを使用して、MongoDB または Redis アドオンをインストールできます。
次のステップ
ここまで、アプリのデプロイ、アプリの設定変更、ログの表示、スケール、アドオンのアタッチを行う方法を説明しました。
次にお勧めするリソースを紹介します。
- 「Heroku の仕組み」では、アプリケーションの作成、設定、デプロイ、および実行時に必要な技術的な概念の概要を紹介しています。
- 既存の Python または Django アプリを Heroku にデプロイするには、「Heroku での Python および Django アプリのデプロイ」を参照してください。
- Python アプリケーションの開発とデプロイの詳細については、Python カテゴリを参照してください。
コストを抑制するために、チュートリアルを完了したらすぐにサンプルアプリを削除し、データベースも削除してください。
アプリとアドオンを削除する
アカウントからアプリとデータベースを削除します。使用したリソースに対してのみ課金されます。
この操作により、アドオンとデータベースに保存されたすべてのデータが削除されます。
$ heroku addons:destroy heroku-postgresql
▸ WARNING: Destructive Action
▸ This command will affect the app serene-caverns-82714
▸ To proceed, type serene-caverns-82714 or re-run this command with
▸ --confirm serene-caverns-82714
>
この操作により、アプリケーションが完全に削除されます。
$ heroku apps:destroy
▸ WARNING: This will delete ⬢ serene-caverns-82714 including all add-ons.
▸ To proceed, type serene-caverns-82714 or re-run this command with
▸ --confirm serene-caverns-82714
>
以下のコマンドによって、アドオンとアプリが消去されたことを確認できます。
$ heroku addons --all
$ heroku apps --all