通常のアプリケーションを AWS Lambda にデプロイする簡単な方法

2025-08-062025-08-29

AWS

AWS Lambda

皆様、ごきげんよう。

今回はサーバー機能を内蔵したフレームワークで構築されたアプリケーションを、簡単に AWS Lambda にデプロイする方法をご紹介します！

使用するもの

今回の主役は aws-lambda-web-adapter です！

AWS Lambda Web Adapter は、AWS Lambda 上の内部拡張機能として稼働し、AWS Lambda のレスポンスを HTTP リクエストに変換するリバースプロキシ機能を持つものです。

デプロイしたい HTTP アプリケーション → AWS Lambda のエントリーポイントに配置するだけ
AWS Lambda Web Adapter → イベント受け取り + HTTP リクエストのフォワード

また、様々な言語・ランタイムの汎用性を持たせるために、今回は OCI コンテナイメージで Lambda 関数を作成する例とします。

ZIP アーカイブによるデプロイでも、拡張機能は Lambda レイヤーとして配置することが可能です。

静的リンクされた実行可能バイナリ (主に Golang, Rust) などでない限り、ZIP でアプリケーションコードと依存ライブラリとランタイムまで同梱することになり、多くの場合で ZIP のサイズ制限を超過することが多いです。

WEB アプリケーション部分の用意

今回は FastAPI + uvucorn でアプリケーション部分を記述します。

ASGI アプリケーションは https://github.com/Kludex/mangum を使用するより低いオーバーヘッドのデプロイ方法も存在します。

準備

今回は仮想環境管理に uv を使用します。必要なパッケージを追加しておきます。

bash

uv init
uv add fastapi uvicorn

アプリケーションコード

メインのアプリケーションコードは非常にシンプルなものとします。

GET / → 固定値を返します
POST /events → 受け取った Event JSON をそのまま返します。

src/main.py

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def greet():
    return {"message": "Hello, World!"}


@app.post("/events")
def read_event(event: dict):
    return event

またモジュール認識させるために、src/__init__.py も空のファイルとして作成します。

HTTP リクエスト以外のイベントについて

AWS Lambda Web Adapter は、HTTP 以外の Lambda イベントも受け取ることができ、このイベントはデフォルトで POST /events にリクエストが転送されます。これを利用することで、バッチサーバーなども簡単に Lambda 化できるということです。

HTTP リクエスト (API Gateway, Function URLs など) → そのままのメソッド・パス
HTTP リクエスト以外 (SQS, SNS, カスタムイベントなど) → POST /events にリクエスト

なお、Event のリクエストパスは設定(環境変数) で変更することができます。

AWS Lambda へのデプロイ

イメージの作成

AWS Lambda にデプロイするためのイメージを作成します。2行目で AWS Lambda Web Adapter を拡張機能に追加しています。

また、エントリーポイントは AWS Lambda の RIC のエントリーポイントではなく、メインの WEB アプリケーションの部分でよいため、非常に直感的です。

docker

FROM ghcr.io/astral-sh/uv:python3.12-alpine
COPY --from=public.ecr.aws/awsguru/aws-lambda-adapter:0.9.1 /lambda-adapter /opt/extensions/lambda-adapter
ENV AWS_LWA_PORT=8000
WORKDIR /var/task
ENV PYTHONPATH=/var/task
COPY ./src ./src
COPY ./pyproject.toml ./uv.lock ./
RUN uv sync
ENV UV_CACHE_DIR=/tmp/uv

CMD ["uv", "run", "uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8000"]

作成したイメージはタグ打ちして ECR に push しておきます。

AWS Lambda へのデプロイ・テスト

特殊な手順は不要で、既に AWS Lambda にデプロイできる状態となっています。

API Gateway Http API のイベントから、GET / にリクエストするようにして確認します。

Function URLs でも確認してみます。

また、HTTP でないイベントも送ってみます。このイベントはエコーするように POST /events で設定したので正常に動いています！

まとめ

AWS Lambda Web Adapter を使用すれば、アプリケーションコードの変更なしで AWS Lambda にデプロイできました！

ただし、Spring などの起動に時間がかかるフレームワークの場合、Provisioned concurrency の設定などの考慮が必要です。

Ikuma Yamashita

Rust が好きです。仕事ではインフラエンジニア、趣味ではアプリケーションエンジニアです。イラストなどを嗜む。