翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

基本 AWS Lambda Docker イメージの作成プロジェクト

Toolkit for Visual Studio を使用して、 AWS Lambda 関数を Docker イメージとしてデプロイできます。Docker を使用すると、ランタイムをより細かく制御できます。例えば、 などのカスタムランタイムを選択できます。NET 8.0。Docker イメージは、他のコンテナイメージと同じ方法でデプロイします。このチュートリアルは、「チュートリアル: 基本的な Lambda プロジェクト」に忠実に従っていますが、2 つには以下の違いがあります。

Lambda コンテナイメージに関する詳細については、AWS Lambda デベロッパーガイドの「Lambda デプロイパッケージ」を参照してください。

Lambda の操作の詳細については AWS Toolkit for Visual Studio、このユーザーガイドのトピックのAWS Lambda 「 テンプレートの使用 AWS Toolkit for Visual Studio」を参照してください。

Visual Studio を作成します。NET Core Lambda プロジェクト

Lambda Visual Studio テンプレートと設計図を使用して、プロジェクトの初期化を高速化できます。Lambda ブループリントには、柔軟なプロジェクト基盤の作成を簡素化する事前記述された関数が含まれています。

プロジェクトファイルの確認

以下のセクションでは、 によって作成された 3 つのプロジェクトファイルについて説明します。NET 8 (コンテナイメージ） 設計図：

1. Dockerfile

Dockerfile は 3 つの主要なアクションを実行します。

以下は、指定できるオプションのDockerfileアクションです。

以下は、 によって作成された Dockerfile の例です。NET 8 (コンテナイメージ) 設計図。

FROM public.ecr.aws/lambda/dotnet:8

WORKDIR /var/task

# This COPY command copies the .NET Lambda project's build artifacts from the host machine into the image. 
# The source of the COPY should match where the .NET Lambda project publishes its build artifacts. If the Lambda function is being built 
# with the AWS .NET Lambda Tooling, the `--docker-host-build-output-dir` switch controls where the .NET Lambda project
# will be built. The .NET Lambda project templates default to having `--docker-host-build-output-dir`
# set in the aws-lambda-tools-defaults.json file to "bin/Release/lambda-publish".
#
# Alternatively Docker multi-stage build could be used to build the .NET Lambda project inside the image.
# For more information on this approach checkout the project's README.md file.
COPY "bin/Release/lambda-publish"  .

2. aws-lambda-tools-defaults.json

このaws-lambda-tools-defaults.jsonファイルは、 Toolkit for Visual Studio デプロイウィザードと のデフォルト値を指定するために使用されます。NET コア CLI。次のリストは、aws-lambda-tools-defaults.jsonファイルで設定できるフィールドを示しています。

以下は、 によって作成された aws-lambda-tools-defaults.json の例です。NET 8 (コンテナイメージ) 設計図。

{
  "Information": [
    "This file provides default values for the deployment wizard inside Visual Studio and the AWS Lambda commands added to the .NET Core CLI.",
    "To learn more about the Lambda commands with the .NET Core CLI execute the following command at the command line in the project root directory.",
    "dotnet lambda help",
    "All the command line options for the Lambda command can be specified in this file."
  ],
  "profile": "default",
  "region": "us-west-2",
  "configuration": "Release",
  "package-type": "image",
  "function-memory-size": 512,
  "function-timeout": 30,
  "image-command": "AWSLambdaDocker::AWSLambdaDocker.Function::FunctionHandler",
  "docker-host-build-output-dir": "./bin/Release/lambda-publish"
}

3. Function.cs

Function.cs ファイルは、Lambda 関数として公開される c# 関数を定義します。-FunctionHandlerは、Lambda 関数の実行時に実行される Lambda 関数です。このプロジェクトでは、 は入力テキストToUpper()をFunctionHandler呼び出します。

Lambda に発行する

ビルドプロセスによって生成された Docker イメージは、Amazon Elastic Container Registry (Amazon ) にアップロードされますECR。Amazon ECRは、Docker コンテナイメージの保存、管理、デプロイに使用するフルマネージド型の Docker コンテナレジストリです。Amazon はイメージをECRホストし、Lambda は呼び出し時にプログラムされた Lambda 機能を提供するために参照します。

クリーンアップ

この例を使用して開発を継続しない場合は、デプロイされた関数とECRイメージを削除して、アカウント内の未使用のリソースに対して請求されないようにします。

次のステップ

Lambda イメージの作成およびテストについては、「Lambda でのコンテナイメージの使用」を参照してください。

コンテナイメージのデプロイ、アクセス許可、および構成設定の上書きの詳細については、「関数の設定」を参照してください。