使用容器映像部署 .NET Lambda 函數

您可以透過三種方式為 .NET Lambda 函數建置容器映像：

使用 .NET AWS 的基礎映像

AWS 基礎映像會預先載入語言執行期、用來管理 Lambda 與函數程式碼之間互動的執行期界面用戶端，以及用於本機測試的執行期界面模擬器。
使用僅限 AWS 作業系統的基礎映像

AWS 僅限作業系統的基礎映像包含 Amazon Linux 發行版本和執行期界面模擬器。這些映像常用於為編譯語言 (如 Go 和 Rust) 和 Lambda 不提供基礎映像的語言或語言版本 (如 Node.js 19) 建置容器映像。您還可以使用僅限作業系統的基礎映像來實作自訂執行期。若要使映像檔與 Lambda 相容，您必須在映像中加入適用於 .NET 的執行期介面用戶端。
使用非AWS 基礎映像

您可以使用其他容器登錄檔中的替代基礎映像 (例如 Alpine Linux 或 Debian)。您也可以使用組織建立的自訂映像。若要使映像檔與 Lambda 相容，您必須在映像中加入適用於 .NET 的執行期介面用戶端。

提示

若要縮短 Lambda 容器函數變成作用中狀態所需的時間，請參閱 Docker 文件中的使用多階段建置。若要建置有效率的容器映像，請遵循撰寫 Dockerfiles 的最佳實務。

本頁面會說明如何為 Lambda 建置、測試和部署容器映像。

AWS .NET 的基礎映像

AWS 為 .NET 提供下列基本映像：

標籤	執行期	作業系統	Dockerfile	棄用
8	.NET 8	Amazon Linux 2023	Dockerfile for .NET 8 on GitHub	2026 年 11 月 10 日

Amazon ECR 儲存庫︰gallery.ecr.aws/lambda/dotnet

使用 .NET AWS 的基礎映像

先決條件

若要完成本節中的步驟，您必須執行下列各項：

.NET SDK – 下列步驟使用 .NET 8 基礎映像。確保您的 .NET 版本與您在 Dockerfile 中指定的基礎映像的版本相符。
Docker （最低版本 25.0.0)
Docker buildx 外掛程式。

使用基礎映像建立和部署映像

在下面的步驟中，您可以使用 Amazon.Lambda.Templates 和 Amazon.Lambda.Tools 來建立 .NET 專案。然後，您可以建置 Docker 映像檔，將該映像檔上傳到 Amazon ECR，然後將其部署到 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 目錄。這是儲存專案檔案的位置。檢查下列檔案：
- aws-lambda-tools-defaults.json – 您在部署 Lambda 函數時，在此檔案中指定命令列選項。
- Function.cs – 您的 Lambda 處理常式函數程式碼。這是 C# 範本，包含了預設的 Amazon.Lambda.Core 程式庫和預設的 LambdaSerializer 屬性。如需有關序列化需求及選項的詳細資訊，請參閱 C# Lambda 函數中的序列化。可以使用提供的程式碼進行測試，也可以將其替換為您自己的程式碼。
- MyFunction.csproj – 一個 .NET 專案檔案，列出了構成您的應用程式的檔案和組件。
- Readme.md：此檔案包含有關範例 Lambda 函數的詳細資訊。
檢查 src/MyFunction 目錄中的 Dockerfile。可以使用提供的 Dockerfile 進行測試，也可以將其替換為您自己的 Dockerfile。如果使用自己的，請確保：
- 將 FROM 屬性設定為基礎映像的 URI。您的 .NET 版本必須與基礎映像的版本相符。
- 將 CMD 引數設定為 Lambda 函數處理常式。這應符合 aws-lambda-tools-defaults.json 中的 image-command。
請注意，範例 Dockerfile 不包含 USER 指令。當您將容器映像部署到 Lambda 時，Lambda 會自動定義一個具有最低權限許可的預設 Linux 使用者。這與標準 Docker 行為不同，後者會在未提供 USER 指令時預設為 root 使用者。
範例 Dockerfile
```
# 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/src/MyFunction。
```
cd src/MyFunction
```
使用 Amazon.Lambda.Tools 建置 Docker 映像檔，將其推送至新的 Amazon ECR 儲存庫，然後部署 Lambda 函數。

對於 --function-role，指定函數執行角色的角色名稱 (而非 Amazon Resource Name (ARN))。例如：lambda-role。
```
dotnet lambda deploy-function MyFunction --function-role lambda-role
```
如需有關 Amazon.Lambda.Tools .NET Global Tool 的詳細資訊，請參閱 GitHub 上的 .NET CLI 的AWS 延伸模組儲存庫。

調用函數。


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

透過執行期介面用戶端使用替代基礎映像

如果您使用僅限作業系統的基礎映像或替代的基礎映像，則必須在映像中加入執行期介面用戶端。執行期介面用戶端會讓您擴充針對自訂執行時期使用 Lambda 執行時期 API，管理 Lambda 與函數程式碼之間的互動。

下列範例示範如何使用非AWS 基礎映像為 .NET 建置容器映像，以及如何新增 Amazon.Lambda.RuntimeSupport 套件，這是 .NET 的 Lambda 執行期介面用戶端。範例 Dockerfile 使用了 Microsoft .NET 8 基礎映像。

先決條件

若要完成本節中的步驟，您必須執行下列各項：

.NET SDK：下列步驟使用 .NET 8 基礎映像。確保您的 .NET 版本與您在 Dockerfile 中指定的基礎映像的版本相符。
Docker （最低版本 25.0.0)
Docker buildx 外掛程式。

使用替代基礎映像建立和部署映像

安裝 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 – 您在部署 Lambda 函數時，在此檔案中指定命令列選項。
- Function.cs：此程式碼含有一個類別，其中包含可將 Amazon.Lambda.RuntimeSupport 程式庫初始化為自舉的 Main 方法。Main 方法是函數處理過程的進入點。Main 方法會將函數處理常式包裝在自舉可以使用的包裝函式之中。如需詳細資訊，請參閱 GitHub 儲存庫中的 Using Amazon.Lambda.RuntimeSupport as a class library。
- MyFunction.csproj – 一個 .NET 專案檔案，列出了構成您的應用程式的檔案和組件。
- Readme.md：此檔案包含有關範例 Lambda 函數的詳細資訊。

開啓 aws-lambda-tools-defaults.json 檔案並「新增」下列幾行程式碼：


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

package-type：將部署套件定義為容器映像。
docker-host-build-output-dir：為建置過程設定輸出目錄。

範例 aws-lambda-tools-defaults.json


{
  "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 使用 Microsoft .NET 基礎映像，而非 AWS 基礎映像。
- 將 FROM 屬性設為基礎映像識別符。您的 .NET 版本必須與基礎映像的版本相符。
- 使用 COPY 命令將函數複製到 /var/task 目錄。
- 將 ENTRYPOINT 設為您希望 Docker 容器在啟動時執行的模組。在這種情況下，該模組是會初始化 Amazon.Lambda.RuntimeSupport 程式庫的自舉。
請注意，範例 Dockerfile 不包含 USER 指令。當您將容器映像部署到 Lambda 時，Lambda 會自動定義一個具有最低權限許可的預設 Linux 使用者。這與標準 Docker 行為不同，後者會在未提供 USER 指令時預設為 root 使用者。
範例 Dockerfile
```
# 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 Tools 延伸模組。
```
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 Resource Name (ARN))。例如：lambda-role。
```
dotnet lambda deploy-function MyFunction --function-role lambda-role
```
如需有關 Amazon.Lambda.Tools .NET CLI 延伸模組的詳細資訊，請參閱 GitHub 上的 .NET CLI 的AWS 延伸模組儲存庫。

調用函數。


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

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

ASP.NET

原生 AOT 編譯