Django連携¶

Django アプリケーションでは、pocket.django モジュールを使って pocket.toml と AWS リソースから設定を取得します。

STORAGES と CACHES¶

Django の STORAGES と CACHES は、pocket.toml の設定から自動生成されます。

from pocket.django.utils import get_caches, get_storages

STORAGES = get_storages()
CACHES = get_caches()

これらの関数は、環境変数 POCKET_STAGE を参照して動作を切り替えます（実行環境 を参照）。

{
    "default": {"BACKEND": "django.core.files.storage.FileSystemStorage"},
    "staticfiles": {"BACKEND": "django.contrib.staticfiles.storage.StaticFilesStorage"},
}

{"default": {"BACKEND": "django.core.cache.backends.locmem.LocMemCache"}}

DATABASES¶

DATABASE_URL 環境変数からは get_databases() で DATABASES を構築できます。

from pocket.django.utils import get_databases

DATABASES = get_databases()

DATABASE_URL が未設定の場合は SQLite（pocket.toml と同じディレクトリの db.sqlite3）にフォールバックします。engine はステージの設定 （[tidb] / [rds] など）から自動判別されます。

持続接続（CONN_MAX_AGE）¶

pocket 管理の DB（TiDB / Neon / RDS）には、Lambda の warm リクエストから 接続確立（TLS handshake 含む。実測で平均 0.1 秒超）を省くため、 既定で持続接続を設定します: CONN_MAX_AGE = 300（秒）+ CONN_HEALTH_CHECKS = True。idle 切断された接続はリクエスト開始時の health check（1 往復、実測 数 ms）が検知して張り直すので、Neon の autosuspend や DB 再起動があっても安全です。[rds] の master password 自動ローテーションも、再接続経路が最新パスワードを取り直すため追従します。

conn_max_age 引数で調整できます:

DATABASES = get_databases(conn_max_age=None)  # 年齢上限なしの持続接続
DATABASES = get_databases(conn_max_age=0)     # Django 既定（毎リクエスト接続）

ローカル開発（stage 解決されない DATABASE_URL）には適用されません。

EMAIL_BACKEND¶

pocket.toml に [ses] セクションを設定すると、Django のメール送信バックエンドを SES に切り替えられます。

from pocket.django.utils import get_email_backend

vars().update(get_email_backend())

返される dict のキー:

環境変数の登録 (set_envs)¶

set_envs() は、AWSリソースから取得した情報を環境変数に登録します。セットされる環境変数の一覧は「実行環境」を参照してください。

from pocket.django.runtime import set_envs

set_envs()

# この後で環境変数を読み取る
# SECRET_KEY = os.environ.get("SECRET_KEY")

追加で登録される情報:

• Secrets Manager — pocket_secrets で定義したシークレット（SECRET_KEY、DATABASE_URL など）
• RDS シークレット — [rds] が設定されている場合、AWS 管理シークレットから DATABASE_URL を自動構築
• CloudFormation Output — API GatewayのホストとCloudFrontドメインをDjangoの ALLOWED_HOSTS と CSRF_TRUSTED_ORIGINS に追加

Django settings の直接設定¶

pocket.toml に記述したsettings値を、settings.py に直接読み込めます。

# ローカル
[general.django_fallback.settings]
CORS_ALLOWED_ORIGINS = [
    "http://localhost:5173",
    "http://localhost:4173",
]

# dev
[dev.container.main.django.settings]
DEFAULT_FROM_EMAIL = '"Dev" <test@example.com>'
CORS_ALLOWED_ORIGINS = ["https://dev.example.com"]

# prod
[prod.container.main.django.settings]
DEFAULT_FROM_EMAIL = '"Production" <noreply@example.com>'
CORS_ALLOWED_ORIGINS = ["https://www.example.com"]

settings.py で読み込みます。

from pocket.django.runtime import get_django_settings

vars().update(get_django_settings())

この関数も POCKET_STAGE で切り替わります。ローカルでは general.django_fallback.settings、Lambda上では対応するステージの container.main.django.settings が返されます。

SQS経由のマネジメントコマンド実行¶

Lambda環境内からDjangoマネジメントコマンドを実行する場合、直接実行またはSQS経由で非同期実行できます。

from pocket.django.utils import pocket_call_command

# 直接実行（デフォルト: SQSキューURLが設定されていれば自動でSQS経由）
pocket_call_command("my_command", args=["arg1"], kwargs={"key": "value"})

# 強制的に直接実行
pocket_call_command("my_command", force_direct=True)

# 強制的にSQS経由
pocket_call_command("my_command", force_sqs=True)

公開 PDF / ファイルのダウンロード（非署名 URL）¶

ユーザー生成の PDF などを、署名なしの固定 URL で公開配信するユースケースです。サイネージで生成した PDF を QR コード経由でスマホにダウンロードさせる、といった用途に使えます。

構成¶

[cloudfront.web]
routes = [
    { type = "lambda", handler = "main.wsgi", is_default = true },
    # 公開ダウンロード用 route (signed なし)
    { path_pattern = "/downloads/*", ref = "downloads" },  # origin_path 省略 → downloads/
]

[container.main.django.storages]
default = { store = "s3" }
downloads = { store = "s3", distribution = "web", route = "downloads" }

Django コード¶

from django.core.files.base import ContentFile
from django.core.files.storage import storages

pdf_storage = storages["downloads"]
pdf_storage.save("session-abc123.pdf", ContentFile(pdf_bytes))
url = pdf_storage.url("session-abc123.pdf")
# -> "https://example.com/downloads/session-abc123.pdf"

動作¶

• S3 バケットは PublicAccessBlock で完全ブロックのまま、変更不要
• CloudFront の OAC で bucket policy が自動設定され、/downloads/* を公開配信
• signed = false のため CloudFrontS3Boto3Storage は非署名 URL を返す
• URL の推測を防ぐには、ファイル名に UUID や十分なエントロピーの ID を含める

署名付き（signed = true）との違い¶

ステージ別ファイル配信 (managed_assets)¶

favicon.ico や robots.txt など、ステージごとに異なる内容を返したいファイルを Django view 経由で配信できます。

ディレクトリ構成¶

プロジェクトルートに managed_assets/ ディレクトリを作成します。CloudFront の managed_assets 設定と同じディレクトリ形式です。

managed_assets/
├── default/
│   ├── favicon.ico
│   └── robots.txt
└── sandbox/
    ├── favicon.ico
    └── robots.txt

POCKET_STAGE に応じたディレクトリが使用されます。ステージ名のディレクトリが存在しなければ default/ にフォールバックします。

urls.py への登録¶

from pocket.django.urls import get_managed_assets_urls

urlpatterns = [
    # ...
    *get_managed_assets_urls(),
]

settings.py の完全な例¶

以下は django-environ を利用した settings.py の典型的な構成です。

import environ
from pathlib import Path

from pocket.django.runtime import set_envs, get_django_settings
from pocket.django.utils import get_caches, get_email_backend, get_storages

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

# pocket.toml から STORAGES, CACHES, EMAIL を取得
STORAGES = get_storages()
CACHES = get_caches()
vars().update(get_email_backend())

# .env を読み込み（ローカル用）
environ.Env.read_env(BASE_DIR / ".env")
env = environ.Env(
    SECRET_KEY=str,
    DEBUG=(bool, False),
    ALLOWED_HOSTS=(list, []),
    CSRF_TRUSTED_ORIGINS=(list, []),
)

# AWS リソースから環境変数を登録（Lambda上のみ動作）
set_envs()

# 環境変数から読み込み
SECRET_KEY = env.str("SECRET_KEY")
DEBUG = env.bool("DEBUG")
DATABASES = {"default": env.db()}
ALLOWED_HOSTS = env.list("ALLOWED_HOSTS")
CSRF_TRUSTED_ORIGINS = env.list("CSRF_TRUSTED_ORIGINS")

# pocket.toml の django.settings を反映
vars().update(get_django_settings())