AWS Lambdaのコンテナサポートを使う

docker buildコマンドを用いてビルドする。Dockerfile内にlocalでAWS Lambdaをエミュレーションするaws-lambda-rieをダウンロードして梱包してい る。

RUN curl -Lo ~/aws-lambda-rie https://github.com/aws/aws-lambda-runtime-interface-emulator/releases/latest/download/aws-lambda-rie && chmod +x ~/aws-lambda-rie && mv ~/aws-lambda-rie /usr/bin/

Dockerfileの全体は次のようになっている。

# image: sximada/example_lambda_runtime_interface_client
FROM python:3.9.6-slim-buster
RUN apt-get update && \
  apt-get install -y \
  g++ \
  make \
  cmake \
  unzip \
  curl \
  libcurl4-openssl-dev

RUN curl -Lo ~/aws-lambda-rie https://github.com/aws/aws-lambda-runtime-interface-emulator/releases/latest/download/aws-lambda-rie && chmod +x ~/aws-lambda-rie && mv ~/aws-lambda-rie /usr/bin/

RUN mkdir -p /app
COPY main.py /app/main.py
WORKDIR /app
RUN pip install awslambdaric
COPY docker-entrypoint.sh /app/
ENTRYPOINT [ "/bin/bash"]
CMD [ "docker-entrypoint.sh" ]

docker-entrypoint.shではAWS_LAMBDA_RUNTIME_API環境変数の有無によってエ ミュレーターを使って起動するのかを切り替えている。この方法は公式の READMEに記載がある¹。

#!/bin/sh

if [ -z "${AWS_LAMBDA_RUNTIME_API}" ]
then
    echo "START AWS LAMBDA INTERFACE EMULATOR"
    exec aws-lambda-rie python -m awslambdaric main.lambda_handler
else
    echo "START AWS LAMBDA FUNCTION"
    exec python -m awslambdaric main.lambda_handler
fi

これはAWS Lambdaで動作させるアプリケーションコードだ。それぞれの要求に よって変わる。今回はテスト用のため、OKという文字列を表示するだけのシン プルな関数lambda_handlerを一つだけ実装した。

def lambda_handler(context, environment):
    print("OK")

docker buildコマンドでイメージをビルドする。

docker build --tag sximada/example_lambda_runtime_interface_client  -f ./Dockerfile .

docker runコマンドで起動する。エミュレータを用いるためには AWS_LAMBDA_API環境変数を設定する。9000ポートを8080ポートに流すように設 定した。

docker run --env AWS_LAMBDA_API=1 -p 9000:8080 sximada/example_lambda_runtime_interface_client

エミュレーターがWeb APIを提供しているのでそれに対してHTTPリクエストを 送信することでAWS Lambda関数を呼び出せる。

curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'

AWSはPython用のクライアントを提供している。DockerコンテナサポートのAWS LambdaをPythonで実装する場合は概ねこれを使うことになる。

https://github.com/aws/aws-lambda-python-runtime-interface-client/

aws-lambda-rieはAWS Lmabdaの動作をエミュレーションする。AWS Lmabda Interfaceに準拠したものを実行できる。

https://github.com/aws/aws-lambda-runtime-interface-emulator