コンテナイメージを使用して.NET の Lambda 関数をデプロイする

Amazon.Lambda.Templates の NuGet パッケージをインストールします。

dotnet new install Amazon.Lambda.Templates

lambda.image.EmptyFunction テンプレートを使用して.NET プロジェクトを作成します。

dotnet new lambda.image.EmptyFunction --name MyFunction --region us-east-1

MyFunction/src/MyFunction ディレクトリに移動します。ここにプロジェクトファイルが保存されます。次のファイルを確認します。

src/MyFunction ディレクトリの Dockerfile を調べます。提供される Dockerfile をテストに使用することも、独自の Dockerfile で置き換えることもできます。独自のものを使用する場合、必ず次のことを行ってください。

この例の Dockerfile には USER 命令が含まれていないことに注意してください。コンテナイメージを Lambda にデプロイすると、最小特権のアクセス許可を付与したデフォルトの Linux ユーザーを Lambda が自動的に定義します。これは標準の Docker 動作とは異なります。標準の動作とは、USER 命令を指定しなかったときに root ユーザーのデフォルトとなる動作のことです。

# You can also pull these images from DockerHub amazon/aws-lambda-dotnet:8
FROM public.ecr.aws/lambda/dotnet:8
  
# Copy function code to Lambda-defined environment variable
COPY publish/* ${LAMBDA_TASK_ROOT}
  
# Set the CMD to your handler (could also be done as a parameter override outside of the Dockerfile)
CMD [ "MyFunction::MyFunction.Function::FunctionHandler" ]

Amazon.Lambda.Tools の「.NET Global Tool」をインストールします。

dotnet tool install -g Amazon.Lambda.Tools

Amazon.Lambda.Tools が既にインストールされている場合、最新バージョンであることを確認します。

dotnet tool update -g Amazon.Lambda.Tools

まだディレクトリが MyFunction ではない場合、ディレクトリを MyFunction/src/MyFunction に変更します。

cd src/MyFunction

Amazon.Lambda.Tools を使用して Docker イメージを構築し、新しい Amazon ECR リポジトリにプッシュして Lambda 関数をデプロイします。

--function-role では、Amazon リソースネーム（ARN）ではなく、関数の「実行ロール」のロール名を指定します。例えば、lambda-role と指定します。

dotnet lambda deploy-function MyFunction --function-role lambda-role

Amazon.Lambda.Tools の .NET Global Tool の詳細については、GitHub の AWS Extensions for .NET CLI リポジトリを参照してください。

関数を呼び出します。

dotnet lambda invoke-function MyFunction --payload "Testing the function"

すべてが成功すると、次のメッセージが表示されます。

Payload:
"TESTING THE FUNCTION"

Log Tail:
START RequestId: id Version: $LATEST
END RequestId: id
REPORT RequestId: id  Duration: 0.99 ms       Billed Duration: 1 ms         Memory Size: 256 MB     Max Memory Used: 12 MB

Lambda 関数を削除する

dotnet lambda delete-function MyFunction

Amazon.Lambda.Templates の NuGet パッケージをインストールします。

dotnet new install Amazon.Lambda.Templates

lambda.CustomRuntimeFunction テンプレートを使用して.NET プロジェクトを作成します。このテンプレートには Amazon.Lambda.RuntimeSupport パッケージが含まれています。

dotnet new lambda.CustomRuntimeFunction --name MyFunction --region us-east-1

MyFunction/src/MyFunction ディレクトリに移動します。ここにプロジェクトファイルが保存されます。次のファイルを確認します。

aws-lambda-tools-defaults.json ファイルを開き、次の行を追加します。

  "package-type": "image",
  "docker-host-build-output-dir": "./bin/Release/lambda-publish"

{
  "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": "",
  "region": "us-east-1",
  "configuration": "Release",
  "function-runtime": "provided.al2023",
  "function-memory-size": 256,
  "function-timeout": 30,
  "function-handler": "bootstrap",
  "msbuild-parameters": "--self-contained true",
  "package-type": "image",
  "docker-host-build-output-dir": "./bin/Release/lambda-publish"
}

MyFunction/src/MyFunction ディレクトリに Dockerfile を作成します。次の Dockerfile の例では、AWS ベースイメージの代わりに Microsoft .NET ベースイメージを使用します。

この例の Dockerfile には USER 命令が含まれていないことに注意してください。コンテナイメージを Lambda にデプロイすると、最小特権のアクセス許可を付与したデフォルトの Linux ユーザーを Lambda が自動的に定義します。これは標準の Docker 動作とは異なります。標準の動作とは、USER 命令を指定しなかったときに root ユーザーのデフォルトとなる動作のことです。

# You can also pull these images from DockerHub amazon/aws-lambda-dotnet:8
FROM mcr.microsoft.com/dotnet/runtime:8.0

# Set the image's internal work directory
WORKDIR /var/task
  
# Copy function code to Lambda-defined environment variable
COPY "bin/Release/net8.0/linux-x64"  .
  
# Set the entrypoint to the bootstrap
ENTRYPOINT ["/usr/bin/dotnet", "exec", "/var/task/bootstrap.dll"]

Amazon.Lambda.Tools の「.NET Global Tool」拡張機能をインストールします。

dotnet tool install -g Amazon.Lambda.Tools

Amazon.Lambda.Tools が既にインストールされている場合、最新バージョンであることを確認します。

dotnet tool update -g Amazon.Lambda.Tools

Amazon.Lambda.Tools を使用して Docker イメージを構築し、新しい Amazon ECR リポジトリにプッシュして Lambda 関数をデプロイします。

--function-role では、Amazon リソースネーム（ARN）ではなく、関数の「実行ロール」のロール名を指定します。例えば、lambda-role と指定します。

dotnet lambda deploy-function MyFunction --function-role lambda-role

Amazon.Lambda.Tools の .NET CLI 拡張機能の詳細については、GitHub の AWS Extensions for .NET CLI リポジトリを参照してください。

関数を呼び出します。

dotnet lambda invoke-function MyFunction --payload "Testing the function"

すべてが成功すると、次のメッセージが表示されます。

Payload:
"TESTING THE FUNCTION"

Log Tail:
START RequestId: id Version: $LATEST
END RequestId: id
REPORT RequestId: id  Duration: 0.99 ms       Billed Duration: 1 ms         Memory Size: 256 MB     Max Memory Used: 12 MB

Lambda 関数を削除する

dotnet lambda delete-function MyFunction