UTokyo Project Sprint 用の記事です。主に、Django Sprint で構築した方を想定して書かれています。

この記事では EB CLI は使用せずに、コンソールからデプロイします。
また、この記事の内容は一例で、もちろんアプリ内で使用するフレームワークや、ライブラリによって異なりますので、適宜自分のプロジェクトに対応させてください。

目次

requirements.txt の修正
Elastic Beanstalkのアプリケーションと環境を作成する
データベースの設定を行う
アプリケーションソースバンドルを準備する
アプリケーションソースバンドルを作成する

0. `requirements.txt` の修正

requirements.txt の Django と psycopg2 のバージョンを以下のように書き換えてください。
Django Sprint で構築した方は、 Django のバージョンは大丈夫かと思いますが、 psycopg2 のバージョンが変わっていることに注意してください。（今後ローカルの開発環境もこのバージョン指定で問題ありません。）

requirements.txt

...
Django>=2.1,<2.2
psycopg2==2.8.5
...

1. Elastic Beanstalkのアプリケーションと環境を作成する

AWS マネジメントコンソールにログインしてください。
ただし、AWS Educate のアカウントからの場合はこの記事を参考にしてください。

AWS Educate のアカウントで AWS マネジメントコンソールにログインする

Elastic Beanstalk を選び、Create Application からアプリケーションを作成します。

アプリケーション情報 > アプリケーション名 : 自身のアプリ名
アプリケーションタグ : 任意。
プラットフォーム : 今回は、プラットフォーム は Python、プラットフォームのブランチ は Python 3.6 running on 64bit Amazon Linux、プラットフォームのバージョン は 2.9.10 を選択しました。
アプリケーションコード : とりあえず「サンプルアプリケーション」を選んでおきます。あとから自分のソースをアップロードします。

[アプリケーションの作成] を押します。あとは自動で環境まで作成してくれるので数分待っておきます。
無事終了したら、その環境のダッシュボードのような画面になると思います。左のメニューの、「環境に移動する」をクリックするとサンプルアプリケーションの画面が出てきます。
出てきたURLの http:// などの部分を除く XXX.YYY.ZZZ.elasticbeanstalk.com が自身のアプリのドメインになります。
あとでこれを使うので控えておいてください。

2. データベースの設定を行う

左のメニューから設定を選びます。一番下の データベース の右の編集ボタンを押します。
データベース設定 の各欄について以下の選択をします。Amazon RDS DB に作成されます。

エンジン : postgres
エンジンバージョン : 今回は 11.5 を選択
インスタンスクラス : とりあえず db.t2.micro を選択
ストレージ : 今回は特に変えずに 5 にしておきました。
ユーザー名 : 各自作成して(一応)覚えておいてください。
パスワード : 各自作成して(一応)覚えておいてください。
保持期間 : スナップショットの作成 にしておきました。
アベイラビリティー : 低(1つのAZ) にしておきました。

[適用] を押してください。変更が反映されるまで待っておいてください。

3. アプリケーションソースバンドルを準備する

ここから主にローカルでの作業に移ります。以下、cms というアプリを作成している前提で進めているで、適宜自分のアプリ名に置き換えてください。
最初に、このセクションをすべて終えたときに出来上がるディレクトリ構造の一例を以下に示します。適宜参考にしてください。

├─ .ebextensions         # Added
│  └─ python.config      # Added
├─ requirements.txt
├─ manage.py             # Updated
├─ cms
│  ├─ management         # Added
│  |  ├─ commands        # Added
|  |  |  ├─ createsu.py  # Added
|  |  |  └─ __init__.py  # Added
|  |  └─ __init__.py     # Added
│  ├─ templates
|  ︙
│  └─ views.py
├─ config
│  ├─ __init__.py
│  ├─ settings           # Added (settings.py removed)
|  |  ├─ common.py       # Added
|  |  ├─ local.py        # Added
|  |  └─ production.py   # Added
│  ├─ urls.py
│  └─ wsgi.py            # Updated
├─ docker-compose.yml
└─ Dockerfile

3-1. `.ebextensions` ディレクトリを作成する

Elastic Beanstalk にデプロイする際に必要となるディレクトリです。
プロジェクトのディレクトリ直下に .ebextensions ディレクトリを作成し、その中に python.config というファイルを作成してください。そのファイルに、以下を書き込んでください。一例なので、適宜書き換えてください。

なお、このファイルのインデントはtabだとエラーが出るので必ずspaceを使用してください。（コピペするとtabになると思うので、spaceに直してください。）

.ebextensions/python.config

packages:
  yum:
    postgresql95-devel: []

container_commands:
  01_migrate:
    command: 'python manage.py migrate'
    leader_only: true
  02_collectstatic:
    command: 'python manage.py collectstatic --noinput'
  03_createsu:
    command: 'python manage.py createsu'
    leader_only: true

option_settings:
  'aws:elasticbeanstalk:application:environment':
    DJANGO_SETTINGS_MODULE: 'config.settings.production'
    PYTHONPATH: '$PYTHONPATH'
  'aws:elasticbeanstalk:container:python':
    StaticFiles: '/static/=www/static/'
    WSGIPath: 'config/wsgi.py'

以下、上記の内容の解説です。

3-1-1. `packages`

ここで必要なパッケージをインストールします。具体的には、今回は requirements.txt が以下のようになっていて、 psycopg2 をインストールする際に必要となるため、postgresql95-devel を入れています。

requirements.txt

Django>=2.1,<2.2
psycopg2==2.8.5

3-1-2. `container_commands`

01_migrate ではマイグレーション
02_collectstatic 静的ファイルの処理
03_createsu スーパーユーザーの作成
のコマンドを実行しています。なお、03_createsu の python manage.py createsu については後述します。

3-1-3. `option_settings`

DJANGO_SETTINGS_MODULE の部分で、後ほど作成する、 production.py を読み込むように環境変数を設定しています。
WSGIPath や StaticFiles などについては、コンソールの設定のところでも変更可能です。
option_settings について詳しく知りたい方は、以下を参照してください。

3-2. `settings.py` を分割する

次に、/config/settings.py を、開発用（Local）と本番用（Production）に分割します。
/config/settings.py は、Local 環境と Production 環境で別々のものを読み込む必要があるのですが、毎回書き換えていると大変なので、自動で切り替わるようにします。
具体的には、

common.py に Local 環境と Production 環境で共通の設定項目を書き込む
local.py は、 common.py の内容に加えて、Local 環境固有の設定項目を書き込む
production.py は、 common.py の内容に加えて、Production 環境固有の設定項目を書き込む
manage.py と wsgi.py を修正する

どちらの環境にも共通している設定項目は、 common.py に書き込みます。

個別に設定すべき内容

Local 環境と Production 環境でそれぞれ固有の設定は例えば以下のようなものです。

DEBUG
DATABASE
ALLOWED_HOSTS
MEDIA_ROOT
STATIC_ROOT
LOGGING

ただし、common.py に書いている設定項目に、local.py や production.py で追加したい場合は、例えば以下のようにします。（配列に追加）

INSTALLED_APPS += (
    'django.contrib.admin',
)

3-2-1. `common.py`, `local.py`, `production.py` を作成する

まず、 /config 直下に、 settings というディレクトリを作成し、その中に /config 下の settings.py を移動させ、 common.py にリネームしてください。
また、 /config/settings ディレクトリの中に local.py, production.py の2つのファイルを新規に作成してください。
以下のようなディレクトリ構造になっていることを確認してください。

...
├─ config
│  ├─ settings           # Added
|  |  ├─ common.py       # Added (settings.py をリネームしたもの)
|  |  ├─ local.py        # Added
|  |  └─ production.py   # Added
...

3-2-2. `BASE_DIR` を修正する

common.py の最初のほうにある BASE_DIR を以下のように変更してください。

/config/settings/common.py

...
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
...

↓

/config/settings/common.py

...
BASE_DIR = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
...

3-2-3. `local.py` にLocal 環境固有の設定を書き込む

local.py に、 common.py の内容に加えて、Local 環境で固有の設定項目を書き込みます。
common.py の内容を以下のようにimportします。

/config/settings/local.py

from .common import *

あとは、個別に設定すべき内容を書けばよいだけです。
これを踏まえると、 local.py は例えば以下のようになります。

/config/settings/local.py

from .common import *

DEBUG = True

ALLOWED_HOSTS = [
    '0.0.0.0',
    '127.0.0.1',
]

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'postgres',
        'USER': 'postgres',
        'HOST': 'db',
        'PORT': 5432,
        'PASSWORD': 'somepassword',
    }
}

3-2-3. `production.py` にProduction 環境固有の設定を書き込む

production.py に、 common.py の内容に加えて、Production 環境で固有の設定項目を書き込みます。
local.py と同様に、 common.py の内容を以下のようにimportします。