本番環境向けの静的ファイル

CoddyのDjangoジャーニー「JSON API」セクションの一部。レッスン 19/19。

本番環境では、Gunicornのようなプログラムがrunserverの代わりにDjangoを実行し、app.jsなどの静的ファイルは配信しません。これらのファイルは、ウェブサーバーまたはWhiteNoiseのようなパッケージによって、1つのフォルダーから配信されます。

そのフォルダーがSTATIC_ROOTで、絶対パスです。python manage.py collectstaticは、すべてのアプリのstatic/ファイルをそこにコピーします。このコマンドはデプロイのたびに実行します。STATIC_ROOTがないと、ImproperlyConfiguredで処理が停止します。

設定内のパスは、manage.pyが置かれているフォルダーであるBASE_DIRと、pathlibの/演算子を使って構築します。訪問者がアップロードするファイル用のフォルダーは次のとおりです。

MEDIA_ROOT = BASE_DIR / "uploads"

公開前に、python manage.py check --deployを実行すると、準備が整っていない設定が一覧表示されます。

チャレンジ

簡単

mysite/settings.pyで、STATIC_URLの下にあるSTATIC_ROOTを、manage.pyと同じ場所にあるフォルダーstaticfilesの絶対パスに設定します。

Runを押し、次にShellタブでfrom django.core.management import call_command; call_command("collectstatic", interactive=False)を実行すると、コピーされたファイル数が表示されます。

自分で試してみよう

import os
from pathlib import Path

BASE_DIR = Path(__file__).resolve().parent.parent

SECRET_KEY = os.environ.get("DJANGO_SECRET_KEY", "django-insecure-change-me")
DEBUG = os.environ.get("DJANGO_DEBUG", "False") == "True"
ALLOWED_HOSTS = os.environ.get("DJANGO_ALLOWED_HOSTS", "localhost,127.0.0.1").split(",")

INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    "tasks",
]

MIDDLEWARE = [
    "django.middleware.security.SecurityMiddleware",
    "django.contrib.sessions.middleware.SessionMiddleware",
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",
    "django.contrib.auth.middleware.AuthenticationMiddleware",
    "django.contrib.messages.middleware.MessageMiddleware",
    "django.middleware.clickjacking.XFrameOptionsMiddleware",
]

ROOT_URLCONF = "mysite.urls"

TEMPLATES = [
    {
        "BACKEND": "django.template.backends.django.DjangoTemplates",
        "DIRS": [],
        "APP_DIRS": True,
        "OPTIONS": {
            "context_processors": [
                "django.template.context_processors.request",
                "django.contrib.auth.context_processors.auth",
                "django.contrib.messages.context_processors.messages",
            ],
        },
    },
]

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.sqlite3",
        "NAME": BASE_DIR / "db.sqlite3",
    }
}

LANGUAGE_CODE = "en-us"
TIME_ZONE = "UTC"
USE_I18N = True
USE_TZ = True

STATIC_URL = "static/"