QuickStart: Elastic Beanstalk に Python アプリケーションをデプロイする

この QuickStart チュートリアルでは、Python アプリケーションを作成して AWS Elastic Beanstalk 環境にデプロイする手順を示します。

AWS アカウント

まだ AWS をご利用でない場合は、AWS アカウントを作成する必要があります。サインアップすることによって Elastic Beanstalk とその他の AWS のサービスにアクセスできるようになります。

AWS アカウントが既にある場合は、前提条件 に進むことができます。

前提条件

このガイドの手順に従うには、run command のためのコマンドラインターミナルまたはシェルが必要になります。コマンドは、該当する場合、プロンプト記号 ($) と現在のディレクトリの名前が前に付けられて、リストに示されます。

~/eb-project$ this is a command
this is output

Linux および macOS では、任意のシェルとパッケージ管理者を使用できます。Windows では、Linux 用の Windows サブシステムをインストールして、Ubuntu および Bash の Windows に統合されたバージョンを入手できます。

EB CLI

このチュートリアルでは、Elastic Beanstalk コマンドラインインターフェイス (EB CLI) を使用します。EB CLI をインストールおよび設定する手順の詳細については、「Elastic Beanstalk コマンドラインインターフェイスをインストールする」および「EB CLI の設定」を参照してください。

Python および Flask フレームワーク

次のコマンドを実行して、pip がインストールされ動作している Python バージョンがあることを確認します。

~$ python3 --version
Python 3.N.N
>~$ python3 -m pip --version
pip X.Y.Z from ... (python 3.N.N)

前のコマンドのいずれかが「Python が見つからない」と返す場合は、python3 ではなく python を使用する次のコマンドを実行します。エイリアスとシンボリックリンクの設定は、オペレーティングシステムと個々のカスタマイズによって異なる可能性があるため、python3 コマンドはマシンで機能しない場合があります。

~$ python --version
Python 3.N.N
>~$ python -m pip --version
pip X.Y.Z from ... (python 3.N.N)

ローカルマシンに Python がインストールされていない場合は、Python ウェブサイトの「Python ダウンロード」ページからダウンロードできます。Elastic Beanstalk がサポートする Python 言語バージョンのリストについては、「AWS Elastic Beanstalk プラットフォーム」ガイドの「サポートされている Python プラットフォーム」を参照してください。Python ダウンロードウェブサイトには、「Python デベロッパーガイド」へのリンクがあり、インストールと設定の手順が記載されています。

サポートされているバージョンの Python があるが、pip ではないことが出力で示された場合は、pip.pypa.io ウェブサイトの「インストール」ページを参照してください。pip がない Python 環境に pip をインストールするためのガイダンスがここに記載されています。

次のコマンドを実行して、Flask がインストールされているかどうかを確認します。

~$ pip list | grep Flask

Flask がインストールされていない場合は、次のコマンドを実行してインストールできます。

~$ pip install Flask

ステップ 1: Python アプリケーションを作成する

プロジェクトディレクトリを作成します。

~$ mkdir eb-python
~$ cd eb-python

「Hello Elastic Beanstalk!」というサンプルを作成します。Elastic Beanstalk を使用してデプロイする Python アプリケーション。

作成したばかりのディレクトリに application.py という名前のテキストファイルを次の内容で作成します。

from flask import Flask
application = Flask(__name__)

@application.route('/')
def hello_elastic_beanstalk():
        return 'Hello Elastic Beanstalk!'

次の行がある requirements.txt という名前のテキストファイルを作成します。このファイルには、アプリケーションを実行するために必要な pip パッケージが含まれています。

Flask

ステップ 2: アプリケーションをローカルに実行する

アプリケーションをローカルで実行するには、次のコマンドを実行します。

~/eb-python$ export FLASK_APP=application.py && flask run --port 5000

次のような出力が表示されます。

Serving Flask app 'application.py'
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
127.0.0.1 - - [01/Jan/1970 00:00:00] "GET / HTTP/1.1" 200 -

ウェブブラウザで http://localhost:5000 にアクセスします。ウェブブラウザに「Hello Elastic Beanstalk!」と表示されます。

ステップ 3: EB CLI を使用して Python アプリケーションをデプロイする

次のコマンドを実行して、このアプリケーションの Elastic Beanstalk 環境を作成します。

ステップ 4: Elastic Beanstalk でアプリケーションを実行する

環境を作成するプロセスが完了したら、eb open でウェブサイトを開きます。

~/eb-python$ eb open

お疲れ様でした。Elastic Beanstalk で Python アプリケーションをデプロイしました。これにより、アプリケーション用に作成されたドメイン名を使用してブラウザ Window が開きます。

ステップ 5：クリーンアップ

アプリケーションでの作業が終了したら、環境を終了できます。Elastic Beanstalk は、環境に関連付けられているすべての AWS リソースを終了します。

EB CLI を使用して Elastic Beanstalk 環境を終了するには、次のコマンドを実行します。

~/eb-python$ eb terminate

アプリケーションの AWS リソース

1 つのインスタンスアプリケーションを作成しました。1 つの EC2 インスタンスを持つ簡単なサンプルアプリケーションとして動作するため、ロードバランシングや自動スケーリングは必要ありません。1 つのインスタンスアプリケーションの場合、Elastic Beanstalk は次の AWS リソースを作成します。

Elastic Beanstalk は、これらのリソースをすべて管理します。環境を終了すると、Elastic Beanstalk は含まれているすべてのリソースを終了します。

次のステップ

アプリケーションを実行する環境を手に入れた後、アプリケーションの新しいバージョンや、異なるアプリケーションをいつでもデプロイできるようになります。新しいアプリケーションバージョンのデプロイは、プロビジョニングや EC2 インスタンスの再開が必要ないため、非常に素早く行えます。Elastic Beanstalk コンソールを使用して新しい環境を調べることもできます。詳細な手順については、このガイドの「開始方法」の章の「環境を探索する」を参照してください。

1 つか 2 つのサンプルアプリケーションをデプロイし、ローカルで Python アプリケーションを開発して実行する準備が整ったら、「Elastic Beanstalk 用の Python 開発環境の設定」を参照します。

Elastic Beanstalk コンソールでデプロイする

Elastic Beanstalk コンソールを使用してサンプルアプリケーションを起動することもできます。詳細な手順については、このガイドの「開始方法」の章の「サンプルアプリケーションを作成する」を参照してください。