Docker コンテナイメージを使用した Lambda 関数 - Java を使用して Lambda 関数を開発およびデプロイするパートフロー (ランタイム)-＆＃＆チュートリアル-php.cn

導入

この記事では、Docker Container Image と Java ランタイムを使用して Lambda 関数を開発およびデプロイする方法を探っていきたいと思います。この記事では、Java 21 Corretto ランタイムを使用します。ただし、コンテナーイメージと同様に、Java 17 や 21 のような長期サポート (LTS) Java ランタイムだけでなく、Java 22 などの最近の Java ランタイムも使用できます。新しい Java バージョンがリリースされる場合 (Java など)、この例を更新するのは簡単です。 2024 年 9 月にバージョン 23)。

AWS Lambda ベースの Docker コンテナイメージと Java (21) ランタイムを使用して Lambda 関数を開発およびデプロイする方法

AWS ベースイメージには、言語ランタイム、Lambda と関数コード間の対話を管理するランタイムインターフェイスクライアント、ローカルテスト用のランタイムインターフェイスエミュレーターがプリロードされています。 Java 用の AWS ベースイメージの使用については、この記事を参照してください。

説明のために、サンプルアプリケーションを使用し、Lambda 関数に Java 21 ランタイムを使用します。

Lambda function using Docker Container Image -Part ow to develop and deploy Lambda function with Java ( runtime

このアプリケーションでは、プロダクトを作成および取得し、NoSQL データベースとして DynamoDB を使用します。 DynamoProductDao.java 実装はここにあります。また、AWS SAM テンプレートで定義されているように、Amazon API Gateway をその前に配置します。このテンプレートでは、PutProductWithPureJava21DockerImage と GetProductByIdWithPureJava21DockerImage という 2 つの Lambda 関数も定義しました。

パブリック Amazon ECR リポジトリからの Java 21 用の AWS Lambda ベース Docker イメージ public.ecr.aws/lambda/java:21 を使用する Dockerfile を定義する必要があります。ここでは、AWS が提供する Java 用のすべての Lambda ベース Docker イメージを見つけることができます。

Docker イメージでは、関数コードとランタイム依存関係も Maven レイアウトからランタイム環境変数 LAMBDA_TASK_ROOT – Lambda 関数コードへのパスにコピーします。

リーリー

その他すべては、AWS SAM テンプレートの Lambda 関数宣言で定義されます。

リーリー

重要な部分は次のとおりです:

PackageType: Lambda 関数を Docker コンテナーイメージとしてパッケージ化することを示すイメージ
ImageUri: Docker コンテナのパスを参照する !Sub ${AWS::AccountId}.dkr.ecr.eu-central-1.amazonaws.com/aws-pure-lambda-java21-custom-docker-image:v1 Amazon Elastic Container Registry のイメージ。そこに画像をプッシュする方法については後で詳しく説明します。 -ImageConfig: コマンド: ["software.amazonaws.example.product.handler.GetProductByIdHandler::handleRequest"] は、GetProductById ハンドラーに対する CMD をオーバーライドします。この CMD は Lambda 関数ごとに一意であるため、Docker ファイルと同様に Lambda 関数のレベルで宣言することをお勧めします。

それでは、Docker コンテナイメージを作成して ECR リポジトリにプッシュする方法についての質問に答えてみましょう。これを自動的に実行して、sam build および samdeployコマンドチェーンを実行することもできます。または、SAM の外部でアプリケーションをビルドしてパッケージ化し、SAM でのみデプロイする場合は、次のように手動で行う必要があります

リーリー

samdeploy -g を使用して関数をデプロイする場合は、sam パラメーターオプション --image-repository を使用して Amazon ECR URL を追加で提供する必要があります。samdeploy パラメーターを参照してください。

AWS OS のみのベースイメージと Java (21) ランタイムを使用して Lambda 関数を開発およびデプロイする方法

AWS OS のみのベースイメージには、Amazon Linux ディストリビューションとランタイムインターフェイスエミュレーターが含まれています。これらのイメージは、Java や Rust などのコンパイル済み言語、および Lambda が基本イメージを提供していない言語または言語バージョン (Node.js 19 など) のコンテナイメージを作成するためによく使用されます。また、OS を使用することもできます。カスタムランタイムを実装するためのベースイメージのみ。

Java 用の AWS OS のみのベースイメージを使用したい場合は、イメージまたは依存関係の管理にランタイムインターフェイスクライアントを含める必要があります。ランタイムインターフェイスクライアントは、Lambda と関数コード間の対話を管理する Lambda ランタイム API を拡張します。

このユースケース用にもサンプルアプリケーションを提供しました。

次のように AWS Lambda Java Runtime Interface Client を pom.xml に含めました:

リーリー

この場合、Dockerfile も少し異なって見えます。
amazoncorretto:21-alpine をベース Docker イメージとして使用し、AWS Lambda Java ランタイムインターフェイスクライアントからエントリクラス AWSLambda を明示的に指すエントリポイントを定義する必要がありました。

リーリー

その他すべて: SAM テンプレート、ソースコード、アプリケーション、Docker イメージの構築とデプロイの手順は、AWS Lambda ベースの Docker コンテナイメージの例と同じです。