AWS LambdaコンテナイメージをDockerfileで作成する手順|ローカルテストから本番デプロイまで

運営:リナックスマスター.JP(代表 宮崎智広)
HOME > Linux技術 リナックスマスター.JP(Linuxマスター.JP) > Docker > AWS LambdaコンテナイメージをDockerfileで作成する手順|ローカルテストから本番デプロイまで
「Lambdaでサードパーティのライブラリを使いたいのに、zip形式では250MBの上限に引っかかってしまう」

機械学習ライブラリや大きなデータ処理パッケージを入れようとすると、すぐにこの壁にあたります。
そのような場面で有効なのが、コンテナイメージとして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倍)で依存関係を自由に管理できる


「このままじゃマズい」と感じていませんか?
参考書を開く気力もない、同年代に取り残される不安——
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

なぜ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!"}

RIEはLambdaと完全に同じ挙動を再現するわけではありませんが、
ハンドラーのロジックや依存パッケージの動作確認には十分です。

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 .

LambdaをARM64アーキテクチャで動かす場合は、関数作成時に --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 .
現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、
コンテナ技術の基礎からDockerfileの実践的な書き方まで、ハンズオンで習得できます。
>>Dockerコンテナ実践講座の詳細はこちら

無料メルマガで学習を続ける

Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。

登録無料・いつでも解除できます

暗記不要・1時間後にはサーバーが動く

3,100名以上が実践した「型」を無料で公開中

プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。

姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

Linux無料マニュアル(図解60P) 名前とメールで30秒登録

運営

リナックスマスター.JP(代表 宮崎智広)

株式会社イーネットマーキュリーが運営するLinux教育サイトです。代表の宮崎智広は現役のLinuxサーバー管理者として20年以上の実務経験を持ち、累計3,100名以上のエンジニアを指導してきました。実践型のLinuxセミナーや無料マニュアルの配布を通じてLinux人材の育成に取り組んでいます。