はじめに
Paasサービスのherokuを使ってwebアプリを構築する機会があり、そのメモ的なもの。
この記事は、Mac上を開発を行う環境とし、herokuを本番環境として扱った例になります。
環境
macOS Monterey 12.2.1
homebrew 3.5.10
Python 3.10.6
git 2.31.0
herokuとは
まずHerokuとはなんですかということですが。。。
Herokuはアプリの構築、提供、監視、スケールに役立つクラウドプラットフォームで、アイデアを出してから運用を開始するまでのプロセスを迅速に進めることが可能です。また、インフラストラクチャの管理の問題からも解放されます。
だそうです。
つまりサーバはherokuが管理し、我々はアプリケーションだけに意識を置くことができる。
残念なのが無料で使える期間がもうすぐ終わるということ。。。
前提作業
前提条件は以下
- homebrewインストール済（まだの方はこちら）
- Python/pipインストール済（まだの方はこちら）
- GitClientインストール済
- herokuアカウント登録済（こちらで普通に登録しましょう）
作業
ではやっていきましょう。
homebrewでherokuClIのインストール
brewコマンドでインストールします。
homebrew未インストール方はこちら
$ brew tap heroku/brew && brew install heroku
herokuコマンドでログイン
下記コマンドをターミナルで実行
$ heroku login
そうすると以下のようなものが出ますので、Enterを押しておきましょう
heroku: Press any key to open up the browser to login or q to exit:
そうするとブラウザが勝手に開き以下の画面が表示されます。
「Log In」を押して
この画面が表示されたら登録したユーザ名とパスワードを入力しましょう。
そうすると以下の表示になりますのでターミナルに戻ると・・・
Logging in... done
Logged in as xxxxxxx@example.com
となればログインオッケーです。
herokuにアプリ作成
heroku上にアプリケーション（置き場）を作成します
$ heroku create
Creating app... done, ⬢ fathomless-sea-24665
https://fathomless-sea-24665.herokuapp.com/ | https://git.heroku.com/fathomless-sea-24665.git
作成できたかの確認
$ heroku apps
=== xxxxxxx@example.com Apps
fathomless-sea-24665
herokuのレポジトリへの連携
まず作業フォルダを作成
（ホームディレクトリの直下にtestというフォルダを作っています。）
$ mkdir ~/test
$ cd ~/test
そこにgitレポジトリを作り、herokuのレポジトリに追加（連携）します
$ git init
$ git remote add heroku https://git.heroku.com/fathomless-sea-24665.git
Flask等のPythonライブラリのインストール
pipでインストールします。
Python/pip未インストールはこちら
$ pip install flask
また、HTTPサーバをインストール
$ pip install gunicorn
そして移動してapp.pyを作成します。
$ cd ~/test
from flask import Flask
app=Flask(__name__)
@app.route('/')
def login_get():
return "Hello World"
if __name__ == '__main__':
app.run(debug=True)
ローカル実行
ローカルで実行させてみます。
$ flask run --debugger --reload
* Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
* Running on http://127.0.0.1:5000
Press CTRL+C to quit
* Restarting with stat
* Debugger is active!
* Debugger PIN: 931-090-321
http://127.0.0.1:5000
にアクセスしましょう
Hello Worldが表示されました。
開発環境としてはローカルでこのapp.pyを中心に構築していく想定です。
ただFlaskとしての挙動が知りたいだけならここまでで十分ですが、heroku
設定ファイル作成
heroku上で動作させるには以下のファイルが必要です。
- runtime.txt
- requirements.txt
- Procfile
以下のディレクトリに作成していきます。
$ cd ~/test
runtime.txt
herokuで実行されるPythonのバージョンを以下のような形で記載します。
python-3.10.6
requirements.txt
heroku上でpythonがインストールするパッケージを記載します。
基本的には以下のコマンドで作成できます。
pip freeze > requirements.txt
click==8.1.3
Flask==2.2.2
gunicorn==20.1.0
itsdangerous==2.1.2
Jinja2==3.1.2
joblib==1.1.0
MarkupSafe==2.1.1
numpy==1.23.2
pandas==1.4.4
python-dateutil==2.8.2
pytz==2022.2.1
scikit-learn==1.1.2
scipy==1.9.1
six==1.16.0
threadpoolctl==3.1.0
Werkzeug==2.2.2
Procfile
unicorn(HTTPサーバ)のプロセスを定義します。
web: gunicorn app:app --log-file -
herokuへのデプロイ
デプロイはherokuレポジトリへpushすることです。
なのでpushしてあげましょう。
git addとcommit
$ git add .
$ git commit -m "update"
[master (root-commit) c2194ce] update
4 files changed, 34 insertions(+)
create mode 100644 Procfile
create mode 100644 app.py
create mode 100644 requirements.txt
create mode 100644 runtime.txt
git push
$ git push heroku master
Enumerating objects: 11, done.
Counting objects: 100% (11/11), done.
Delta compression using up to 8 threads
Compressing objects: 100% (7/7), done.
Writing objects: 100% (11/11), 1.05 KiB | 538.00 KiB/s, done.
Total 11 (delta 1), reused 0 (delta 0), pack-reused 0
remote: Compressing source files... done.
remote: Building source:
~~~~~~~~~~~~中略~~~~~~~~~~~~
remote:
remote: Verifying deploy.... done.
To https://git.heroku.com/fathomless-sea-24665.git
* [new branch] master -> master
runtime.txtを含んでないとエラーになったので気を付けてください。
その後以下のコマンドでネット上に公開できます。（HTTPプロセスの起動）
heroku open
アクセスURLは
https://アプリ名.herokuapp.com
となっているようです。
ここまでがHerokuへデプロイ/公開までになります。
おまけ
herokuレポジトリへの操作
herokuレポジトリへの基本的な操作のみ以下に記載しておきます。
heroku上のレポジトリにpush
$ echo "hoge" > test
$ git add .
$ git commit -m "first commit"
$ git push heroku master
heroku上のレポジトリをclone
$ heroku git:clone --app fathomless-sea-24665
heroku上のレポジトリからpull
$ git fetch
$ git pull heroku master