Elastic Beanstalk Python プラットフォームを使用する - AWS Elastic Beanstalk

Elastic Beanstalk Python プラットフォームを使用する

重要

Amazon Linux 2 プラットフォームのバージョンは、Amazon Linux AMI プラットフォームのバージョン (前の Amazon Linux 2) とは根本的に異なります。これらの異なるプラットフォーム世代は、いくつかの点で互換性がありません。Amazon Linux 2 プラットフォームのバージョンに移行する場合は、「Elastic Beanstalk Linux アプリケーションを Amazon Linux 2 に移行する」の情報を必ずお読みください。

AWS Elastic Beanstalk Python プラットフォームは、WSGI を使用してプロキシサーバーの背後で実行される Python ウェブアプリケーション用の一連のプラットフォームバージョンです。各プラットフォームブランチは、Python 3.4 などの Python のバージョンに対応しています。

Amazon Linux 2 プラットフォームブランチ以降、Elastic Beanstalk は Gunicorn をデフォルトの WSGI サーバーとして提供します。

ソースバンドルに Procfile を追加して、アプリケーションの WSGI サーバーを指定および設定することができます。詳細については、「Procfile を使用した WSGI サーバーの設定」を参照してください。

Pipenv によって作成された Pipfile ファイルと Pipfile.lock ファイルを使用して、Python パッケージの依存関係やその他の要件を指定できます。依存関係の指定の詳細については、「要件ファイルを使用した依存関係の指定」を参照してください。

Elastic Beanstalk には、Elastic Beanstalk 環境内の EC2 インスタンスで実行されるソフトウェアのカスタマイズに使用できる設定オプションが用意されています。アプリケーションに必要な環境変数を設定し、Amazon S3 に対してログのローテーションを有効にしたら、アプリケーションのソースで静的ファイルが含まれるフォルダを、プロキシサーバーによって提供されるパスにマッピングできます。

設定オプションは 実行中の環境の設定を変更するために Elastic Beanstalk コンソールで利用できます。環境を終了したときにその設定が失われないようにするため、保存済み設定を使用して設定を保存し、それを後で他の環境に適用することができます。

ソースコードの設定を保存する場合、設定ファイルを含めることができます。設定ファイルの設定は、環境を作成するたびに、またはアプリケーションをデプロイするたびに適用されます。設定ファイルを使用して、デプロイの間にパッケージをインストールしたり、スクリプトを実行したり、他のインスタンスのカスタマイズオペレーションを実行することもできます。

Elastic Beanstalk コンソールで適用される設定は、設定ファイルに同じ設定があれば、それらの設定を上書きします。これにより、設定ファイルでデフォルト設定を定義し、コンソールでそのデフォルト設定を環境固有の設定で上書きできます。設定の優先順位の詳細と設定の他の変更方法については、「設定オプション」を参照してください。

pip から入手可能な Python パッケージの場合、アプリケーションのソースコードのルートに、要件ファイルを含めることができます。Elastic Beanstalk は、デプロイ時に要件ファイルで指定された依存関係パッケージをすべてインストールします。詳細については、「要件ファイルを使用した依存関係の指定」を参照してください。

Elastic Beanstalk Linux ベースのプラットフォームを拡張するさまざまな方法の詳細については、Elastic Beanstalk Linux プラットフォームの拡張 を参照してください。

Python 環境の設定

Python プラットフォーム設定では、Amazon EC2 インスタンスの動作を微調整できます。Elastic Beanstalk 環境の Amazon EC2 インスタンス設定を編集するには、Elastic Beanstalk コンソールを使用します。

Elastic Beanstalk コンソールを使用して、Python プロセス設定の指定、AWS X-Ray の有効化、Amazon S3 へのログローテーションの有効化、およびアプリケーションが環境から読み取ることができる変数の設定を行います。

Elastic Beanstalk コンソールで Python 環境を設定するには

  1. Elastic Beanstalk コンソールを開き、[リージョン] のリストで AWS リージョンを選択します。

  2. ナビゲーションペインで、[環境] を選択し、リストから環境の名前を選択します。

    注記

    環境が多数ある場合は、検索バーを使用して環境リストをフィルタリングします。

  3. ナビゲーションペインで、[設定] を選択します。

  4. [ソフトウェア] 設定カテゴリで、[編集] を選択します。

Python 設定

  • [WSGI パス] – メインアプリケーションファイルの名前またはパス。たとえば、application.pydjango/wsgi.py などです。

  • [NumProcesses] – 各アプリケーションインスタンスで実行するプロセスの数。

  • [NumThreads] – 各プロセスで実行するスレッドの数。

AWS X-Ray の設定

  • [X-Ray デーモン] – AWS X-Ray デーモンを実行して、AWS X-Ray SDK for Python からのトレースデータを処理します。

ログオプション

[Log Options (ログオプション)] セクションには、2 つの設定があります。

  • [Instance profile] – アプリケーションに関連付けられた Amazon S3 バケットへのアクセス許可が付与されているインスタンスプロファイルを指定します。

  • [Amazon S3 へのログファイルローテーションを有効にする] – アプリケーションの Amazon EC2 インスタンスのログファイルを、アプリケーションに関連付けられている Amazon S3 バケットにコピーするかどうかを指定します。

静的ファイル

パフォーマンスを向上させるには、[Static files (性的ファイル)] セクションを使用してウェブアプリケーション内のディレクトリセットの静的ファイル (HTML、イメージなど) を処理するようにプロキシサーバーを設定できます。ディレクトリごとに、仮想パスをディレクトリマッピングに設定します。プロキシサーバーは、指定されたパスのファイルに対するリクエストを受け取ると、アプリケーションにリクエストをルーティングする代わりにファイルを直接処理します。

Elastic Beanstalk コンソールによる静的ファイルの設定の詳細については、「静的ファイルの提供」を参照してください。

デフォルトでは、Python 環境のプロキシサーバーは static パスにある /static という名前のフォルダにあるすべてのファイルを提供します。たとえば、アプリケーションソースの logo.png という名前のフォルダに static というファイルが含まれている場合、プロキシサーバーは subdomain.elasticbeanstalk.com/static/logo.png でそれをユーザーに提供します。このセクションで説明しているように、追加のマッピングを設定できます。

環境プロパティ

環境プロパティを使用して、アプリケーションに情報を渡し、環境変数を設定できます。たとえば、CONNECTION_STRING という名前の環境プロパティを作成し、そのプロパティで、データベースへの接続にアプリケーションが使用する接続文字列を指定できます。

Elastic Beanstalk 内で実行している Python 環境の内部では、Python の os.environ ディクショナリを使用してこれらの値にアクセスできます。詳細については、http://docs.python.org/library/os.html を参照してください。

以下のようなコードを使用して、キーとパラメータにアクセスできます。

import os endpoint = os.environ['API_ENDPOINT']

環境プロパティを使用して、フレームワークに情報を渡すこともできます。たとえば、DJANGO_SETTINGS_MODULE という名前のプロパティを作成して、そのプロパティで、特定の設定モジュールを使用するように Django を設定できます。環境によって、値は、development.settingsproduction.settings などになります。

詳細については、「環境プロパティとその他のソフトウェアの設定」を参照してください。

Python 設定の名前空間

設定ファイルを使用して、設定オプションを設定し、デプロイの間、他のインスタンス設定タスクを実行できます。設定オプションは、Elastic Beanstalk サービスまたは使用できるプラットフォームで定義し、名前空間に整理できます。

Python プラットフォームでは、名前空間 (aws:elasticbeanstalk:environment:proxy:staticfiles および aws:elasticbeanstalk:container:python) のオプションを定義します。

以下の設定ファイルの例で指定しているのは、DJANGO_SETTINGS_MODULE という名前の環境プロパティを作成する設定オプション、statichtml という名前のディレクトリを /html パスにマッピングする静的ファイルオプション、staticimages という名前のディレクトリを /images パスにマッピングする静的ファイルオプション、aws:elasticbeanstalk:container:python 名前空間にある追加の設定です。この名前空間には、ソースコードで WSGI スクリプトの場所を指定できるオプションと、WSGI で実行するスレッドとプロセスの数を指定できるオプションが含まれています。

option_settings: aws:elasticbeanstalk:application:environment: DJANGO_SETTINGS_MODULE: production.settings aws:elasticbeanstalk:environment:proxy:staticfiles: /html: statichtml /images: staticimages aws:elasticbeanstalk:container:python: WSGIPath: ebdjango.wsgi:application NumProcesses: 3 NumThreads: 20
コメント
  • Amazon Linux AMI Python プラットフォームバージョン (以前の Amazon Linux 2) を使用している場合は、WSGIPath の値 ebdjango/wsgi.py に置き換えます。この例の値は、Amazon Linux AMI プラットフォームバージョンではサポートされていない Gunicorn WSGI サーバーで動作します。

  • さらに、これらの古いプラットフォームバージョンでは、静的ファイルの設定に異なる名前空間が使用されます (aws:elasticbeanstalk:container:python:staticfiles)。これは、標準の静的ファイル名前空間と同じオプション名とセマンティクスを持っています。

設定ファイルでは、お客様の環境のインスタンスでソフトウェアをさらに変更するためのキーもいくつかサポートされています。この例では、packages キーを使用して、Memcached をインストールし、yum および container コマンドを使用して、デプロイ時にサーバーを設定するコマンドを実行します。

packages: yum: libmemcached-devel: '0.31' container_commands: collectstatic: command: "django-admin.py collectstatic --noinput" 01syncdb: command: "django-admin.py syncdb --noinput" leader_only: true 02migrate: command: "django-admin.py migrate" leader_only: true 03wsgipass: command: 'echo "WSGIPassAuthorization On" >> ../wsgi.conf' 99customize: command: "scripts/customize.sh"

Elastic Beanstalk には、環境をカスタマイズするための多数の設定オプションが用意されています。設定ファイルに加えて、コンソール、保存された設定、EB CLI、または AWS CLI を使用して、設定オプションを指定することもできます。詳細については、「設定オプション」を参照してください。