機械学習ライブラリや大きなデータ処理パッケージを入れようとすると、すぐにこの壁にあたります。
そのような場面で有効なのが、コンテナイメージとしてLambdaをデプロイする方法です。
この記事では、Amazon Linux 2023相当の環境を前提に、lambda dockerfileの書き方からローカルでの動作確認(Lambda Runtime Interface Emulator使用)、ECRへのプッシュ、Lambda関数の作成まで手順を解説します。
この記事のポイント
・ AWSの公式ベースイメージ(public.ecr.aws/lambda)をFROMに指定する
・ ローカルテストはRIEで本番と同じ動きを事前に確認できる
・ ECRへのプッシュはdocker tag→docker pushで完了する
・ コンテナイメージはサイズ上限10GB(zip形式の40倍)で依存関係を自由に管理できる
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
なぜLambdaにコンテナイメージを使うのか
Lambdaのデプロイ方式には、zip形式とコンテナイメージ形式の2つがあります。zip形式は手軽ですが、展開後のサイズが250MBに制限されています。
scikit-learnやPandasなどを含めると、あっという間にこの上限に近づきます。
コンテナイメージ形式には次のような利点があります。
・ サイズ上限が10GBまで拡張される
・ Dockerfileで依存関係をすべて自分で制御できる
・ ローカルのDockerと同じ流れでテストできる
・ ECRに上げたイメージを複数のLambda関数で使い回せる
一方で、コンテナイメージはビルドとECRへのプッシュが必要です。
zip形式よりも手順が増えますが、慣れれば管理しやすい運用ができます。
DockerfileとAWSの公式ベースイメージ
1. 公式ベースイメージを選ぶ
AWSはLambda用の公式ベースイメージを提供しています。リポジトリは
public.ecr.aws/lambda です。主なランタイムのイメージは次のとおりです。
・
public.ecr.aws/lambda/python:3.12(Python 3.12)・
public.ecr.aws/lambda/python:3.11(Python 3.11)・
public.ecr.aws/lambda/nodejs:20(Node.js 20)・
public.ecr.aws/lambda/java:21(Java 21)独自のベースイメージ(Ubuntu、AlmaLinuxなど)を使うこともできますが、
その場合はLambda Runtime Interface Client(RIC)を別途インストールする必要があります。
最初は公式ベースイメージを使うのが確実です。
2. 最小構成のDockerfileを書く
Python 3.12のLambda関数を例に、最小構成のDockerfileを確認します。FROM public.ecr.aws/lambda/python:3.12 # 依存パッケージをインストール COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt # ハンドラーファイルをコピー COPY handler.py . # Lambdaハンドラーを指定(ファイル名.関数名) CMD ["handler.handler"]
・
FROM:公式ベースイメージを指定する・
COPY requirements.txt .:依存パッケージのリストをコピーする・
RUN pip install:パッケージをインストールする・
COPY handler.py .:ハンドラー関数のファイルをコピーする・
CMD:ハンドラーを「ファイル名.関数名」の形式で指定するCMD の値は "ファイル名.関数名" の形式で指定します。ここでは
handler.py の handler 関数を実行するよう設定しています。3. ハンドラー関数(handler.py)を用意する
Lambdaハンドラーの基本的な構造は次のとおりです。def handler(event, context): # event: Lambdaに渡されたJSONデータ # context: 実行環境のメタ情報 name = event.get("name", "World") return { "statusCode": 200, "body": f"Hello, {name}!" }
event には呼び出し時に渡したJSONが入ります。context には関数のタイムアウトや残り実行時間などのメタ情報が入ります。API Gateway経由で使う場合は、戻り値に
statusCode と body が必要です。作業ディレクトリの構成は次のようになります。
・
Dockerfile・
handler.py・
requirements.txt(依存パッケージがなければ空ファイルでよい)ローカルでテストする方法
コンテナイメージをECRにプッシュする前に、ローカルで動作確認できます。Lambda Runtime Interface Emulator(RIE)が公式ベースイメージに含まれているため、
特別なツールをインストールしなくてもテストできます。
1. コンテナイメージをビルドする
docker build -t my-lambda-fn .
# 出力例(環境により異なります) [+] Building 12.4s (8/8) FINISHED => [internal] load build definition from Dockerfile => [1/3] FROM public.ecr.aws/lambda/python:3.12 => [2/3] COPY requirements.txt . => [3/3] RUN pip install --no-cache-dir -r requirements.txt => exporting to image => naming to docker.io/library/my-lambda-fn
2. RIEで起動して動作確認する
コンテナを起動して、Lambdaの実行環境をローカルで再現します。docker run -p 9000:8080 my-lambda-fn
curl コマンドで呼び出して動作を確認します。curl -X POST \ "http://localhost:9000/2015-03-31/functions/function/invocations" \ -d '{"name": "Tomohiro"}'
# 出力例(環境により異なります) {"statusCode": 200, "body": "Hello, Tomohiro!"}
ハンドラーのロジックや依存パッケージの動作確認には十分です。
Dockerfileの設計やコンテナ操作をさらに深く学びたい方は、
Docker実践講座(docker.linuxmaster.jp)もあわせて確認してみてください。
ECRへのプッシュとLambda関数のデプロイ
ローカルでの動作を確認したら、ECR(Elastic Container Registry)にイメージをプッシュします。1. ECRリポジトリを作成する
aws ecr create-repository \ --repository-name my-lambda-fn \ --region ap-northeast-1
repositoryUri を控えておきます(環境により異なります)。# 出力例(環境により異なります) { "repository": { "repositoryArn": "arn:aws:ecr:ap-northeast-1:123456789012:repository/my-lambda-fn", "repositoryName": "my-lambda-fn", "repositoryUri": "123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-lambda-fn", "createdAt": "2026-11-15T10:00:00+09:00" } }
2. Dockerにログインしてイメージをプッシュする
AWSのクレデンシャルが設定済みであることを前提にします。ACCOUNT_ID の部分は実際のAWSアカウントIDに置き換えてください。ACCOUNT_ID=123456789012 REGION=ap-northeast-1 REPO_URI=${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com/my-lambda-fn # ECRにDockerログイン aws ecr get-login-password --region ${REGION} | \ docker login --username AWS --password-stdin \ ${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com # タグをつける docker tag my-lambda-fn:latest ${REPO_URI}:latest # プッシュする docker push ${REPO_URI}:latest
# 出力例(環境により異なります) latest: digest: sha256:a1b2c3d4... size: 1234
3. Lambda関数を作成して動作確認する
IAMロールはあらかじめAWSLambdaBasicExecutionRole をアタッチした実行ロールを用意しておきます。# Lambda関数を作成する(ACCOUNT_IDとROLE_ARNは実際の値に置き換える) aws lambda create-function \ --function-name my-lambda-fn \ --package-type Image \ --code ImageUri=123456789012.dkr.ecr.ap-northeast-1.amazonaws.com/my-lambda-fn:latest \ --role arn:aws:iam::123456789012:role/lambda-execution-role \ --region ap-northeast-1
aws lambda invoke \ --function-name my-lambda-fn \ --payload '{"name": "Lambda"}' \ output.json cat output.json
# 出力例(環境により異なります) {"statusCode": 200, "body": "Hello, Lambda!"}
イメージを更新してデプロイし直す手順
ハンドラーや依存パッケージを変更したときは、ビルドからやり直します。# イメージを再ビルドしてプッシュ docker build -t my-lambda-fn . docker tag my-lambda-fn:latest ${REPO_URI}:latest docker push ${REPO_URI}:latest # Lambda関数のコードを更新する aws lambda update-function-code \ --function-name my-lambda-fn \ --image-uri ${REPO_URI}:latest \ --region ap-northeast-1
aws lambda update-function-code を実行すると、Lambdaが新しいイメージを参照するようになります。更新が反映されるまで数秒~数十秒かかることがあります。
本番での更新作業は、タグを
:latest で上書きするより、バージョン番号やコミットハッシュを含むタグ(例:
:v1.2.0)を使うと管理しやすくなります。その場合は
aws lambda update-function-code の --image-uri に新しいタグのURIを指定します。エラー対処
「exec format error」が出た時の対処法
ローカルでビルドしたイメージをLambdaで動かすとexec format error が出ることがあります。CPUアーキテクチャの不一致が原因です。
M1/M2/M3のMacでビルドすると、デフォルトでARM64のイメージが作られます。
LambdaはデフォルトでAMD64(x86_64)を使うため、このずれが発生します。
対処するには、ビルド時にプラットフォームを明示します。
docker build --platform linux/amd64 -t my-lambda-fn .
--architectures arm64 を指定して、ビルド時のプラットフォームも
linux/arm64 に統一してください。コンテナイメージが起動しない時の確認手順
aws lambda create-function でエラーが出たり、Lambda実行時に「Task timed out」が続く場合は、次の手順で原因を絞り込みます。
まずCloudWatch Logsでエラーログを確認します。
aws logs tail /aws/lambda/my-lambda-fn --follow
docker run --rm -p 9000:8080 my-lambda-fn
・ CMDのハンドラー指定が間違っている:「ファイル名.関数名」の形式か確認する
・ requirements.txtのパッケージが見つからない:スペルやバージョン指定を確認する
・ ECRからの参照権限がない:ECRのリソースベースポリシーでLambdaからの参照を許可する
・ アーキテクチャの不一致:Lambdaの設定とビルド時の--platformを統一する
本記事のまとめ
lambda dockerfileを使ったコンテナイメージ型Lambdaの手順をまとめます。| やりたいこと | コマンド・設定 |
|---|---|
| 公式ベースイメージを指定する | FROM public.ecr.aws/lambda/python:3.12 |
| ローカルでイメージをビルドする | docker build -t my-lambda-fn . |
| RIEでローカルテストする | docker run -p 9000:8080 my-lambda-fn |
| ECRにDockerログインする | aws ecr get-login-password | docker login --username AWS --password-stdin ... |
| イメージにタグをつけてプッシュする | docker tag my-lambda-fn:latest <URI> && docker push <URI> |
| Lambda関数を作成する | aws lambda create-function --package-type Image --code ImageUri=<URI> ... |
| イメージを更新する | aws lambda update-function-code --image-uri <新しいURI> |
| アーキテクチャ不一致を防ぐ | docker build --platform linux/amd64 -t my-lambda-fn . |
コンテナ技術の基礎からDockerfileの実践的な書き方まで、ハンズオンで習得できます。
>>Dockerコンテナ実践講座の詳細はこちら
3,100名以上が実践した「型」を無料で公開中
プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら
- 前のページへ:PlaywrightをDockerfileに組み込むE2Eテスト環境の構築手順|依存関係の解決
- この記事の属するカテゴリ:Dockerへ戻る

無料メルマガで学習を続ける
Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。
登録無料・いつでも解除できます