【AWS】AWS Lambdaで外部モジュール（ライブラリ）を含むPythonをzipデブロイする方法

背景

AWS LambdaでPythonを実行する際、pandasなどの外部ライブラリはLambdaに事前にinstallされていないため、いずれかの方法でLambdaに外部ライブラリ等をinstallさせる必要があります。
私が知る限りでは、AWS LambdaでPythonを実行する際に、外部ライブラリを使用できるようにする方法は以下の3つです。
1. Lambda レイヤーを使用する方法。
2. zip デブロイを用いる方法。
3. コンテナイメージデブロイを用いる方法。
それぞれの方法にメリット・デメリットがありますが、今回は、最もよく使用されているであろう「 2. zip デブロイを用いる方法。」についてご紹介します。

目標

外部ライブラリを含むPython codeをzipデブロイ方式によって、AWS Lambdaで関数を実行できるようになる。

AWS Lambdaとは

本題に入る前に、AWS Lambdaというサービスについて少しご紹介します。
なお、ここの解説は私の脳みその記憶ベースで記載していることにご留意ください。
AWS LambdaはAWSの代表的なサーバーレスサービスの一つで、サーバーを構築することなく手軽にプログラムを動かすことができるサービスとして知られています。
様々な用途に使用できるサービスですが、よく使用される方法の一つとしては、Amazon API GatewayをトリガーとしてAPIサービスを構築するのに使用されたりします。
APIなどの必要な時にちょっことプログラムが動けば良いようなサービスの場合は、AWS Lambdaを使用することにより、Amazon EC2などを使用してずっとサーバーを起動させているよりサーバーコストが安くなるなどのメリットがあります。
また、今回の内容につながりますが、AWS Lambdaを支える裏側の技術はコンテナ仮想化技術を使用しています。
そのため、実行時におそらくAmazon linuxをベースとしたイメージを用いたコンテナで処理が実行されているため、外部ライブラリを使用する際は何かしらの方法で外部ライブラリデータをAWS Lambdaに渡す必要があります。
今回ご紹介する方法は、zipファイルに外部ライブラリのデータも含ませておくことにより、Python関数で外部ライブラリ等もimportして使用できるようにする方法になります。

デブロイするzipファイルを作成するDocker環境の構築

今回のデブロイ方法は、AWSのLambda公式ページでは.zip ファイルアーカイブで Python Lambda 関数をデプロイするのページの「依存関係のあるデプロイパッケージ」の項目に該当します。
公式ページでは、ローカル環境でzipファイルを作成していましたが、私はDocker信者（Dockerならどんな環境でも動くから安心と信じてるマン、私の造語です。）ですので、今回はDockerでzipファイルを作成する環境作成からご紹介します。
下記のgithubリポジトリをクーロンもしくはDLしていただき、$docker-compose up --buildでPythonを実行できるコンテナを立ち上げます。

GitHub - takuma-competition/docker-python-lambda-zip-use

Contribute to takuma-competition/docker-python-lambda-zip-use development by creating an account on GitHub.

下記の記事を参考に立ち上げたコンテナ内部にVS Codeで入ります。
続きの解説は、「小ネタ：コンテナのルートディレクトリでフォルダを開く方法」まで実施した想定で進めています。

【環境構築】Docker container内部にVS Codeで入って作業する方法 - Qiita
背景docker container内部に入ってコマンド操作をしたい時がある。docker-compose exec /bin/shを使用して入るという方法は煩雑。docker container上でvs codeを起動しているような状態で作業したい…
qiita.com

VS Codeを使用してDocker環境でデブロイ用のzipファイルを作成する方法

コンテナに接続したVS Codeでターミナルを開きます。

$cd workdirでworkdirディレクトリに移動します。

$mkdirコマンドで、新しいディレクトリを作成します。

$mkdir zip_lambda_deploy

$cdコマンドで、新しいディレクトリに移動します。

$cd zip_lambda_deploy

$touchコマンドで新しいpyファイルを作成します。

$touch lambda_function.py

$touchコマンドで新しいtxtファイルを作成します。

$touch requirements.txt

lambda_function.pyに以下のcodeを記載します。

#はじめにimportの検索pathを追加するcodeを記載する。
import os
import sys
sys.path.append(os.path.join(os.path.dirname(__file__), './packages'))

import requests
def lambda_handler(event, context):   
    response = requests.get("https://www.example.com/")
    print(response.text)
    return response.text

ここまでのコマンドとlambda_function.pyを記載したVS Code画面
requirements.txtに必要な外部ライブラリ名を記載します。<br>
ここでは、requestsが必要なので、requestsを記載しています。

requests==2.28.2

必要なライブラリをpipでinstallします。

#requirements.txtを使用して一気にinstall
$pip install --target ./packages -r requirements.txt

#補足：ライブラリ名を個別に指定してinstallする方法
$pip install --target ./packages requests

zipコマンドでライブラリごとzip化します。

$zip -r ../zip_lambda_deploy .

Lmabdaにzipデブロイを行う方法

最後に作成したzipファイルをLmabdaにデブロイします。

AWSのコンソール画面から「Lmabda」のコンソール画面に移動します。

サイドバーから「関数」をクリックしてから、「関数の作成」をクリックします。

「関数」ボタンが表示されていない場合は、左側の3本のバーをクリックしてくるとサイドバーが表示されます。

Lmabda関数を「一から作成」で作成します。

ここでは、「関数名」はzip_lambdaとします。
「ランタイム」はPython3.9を選択します。
「アーキテクチャ」はzipファイルを作成した環境に合わせて選択してください。<br>
なお、docker-python-lambda-zip-useからクローンしたdockerfileを用いて、ここまで解説通りに進めてきた方はx86_64を選択して進めてください。