AWS Basisimages für.NET Verwenden eines AWS Basis-Images Verwenden eines AWS Nicht-Basis-Images

Bereitstellen von.NET-Lambda-Ereignisfunktionen mit Container-Images

Es gibt drei Möglichkeiten, ein Container-Image für eine.NET-Lambda-Ereignisfunktion zu erstellen:

Mit einem AWS Basisimage für.NET

Die AWS -Basis-Images sind mit einer Sprachlaufzeit, einem Laufzeitschnittstellen-Client zur Verwaltung der Interaktion zwischen Lambda und Ihrem Funktionscode und einem Laufzeitschnittstellen-Emulator für lokale Tests vorinstalliert.
Mit einem AWS OS-only Basisbild

AWS OS-only Basis-Images enthalten eine Amazon Linux-Distribution und den Runtime-Interface-Emulator. Diese Images werden häufig verwendet, um Container-Images für kompilierte Sprachen wie Go und Rust und für eine Sprache oder Sprachversion zu erstellen, für die Lambda kein Basis-Image bereitstellt, wie z. B. Node.js 19. Sie können auch OS-only Basis-Images verwenden, um eine benutzerdefinierte Laufzeit zu implementieren. Um das Image mit Lambda kompatibel zu machen, müssen Sie den Laufzeitschnittstellen-Client für .NET in das Image aufnehmen.
Verwenden eines AWS Nicht-Basis-Images

Sie können auch ein alternatives Basis-Image aus einer anderen Container-Registry verwenden. Sie können auch ein von Ihrer Organisation erstelltes benutzerdefiniertes Image verwenden. Um das Image mit Lambda kompatibel zu machen, müssen Sie den Laufzeitschnittstellen-Client für .NET in das Image aufnehmen.

Tipp

Um die Zeit zu reduzieren, die benötigt wird, bis Lambda-Container-Funktionen aktiv werden, siehe die Docker-Dokumentation unter Verwenden mehrstufiger Builds. Um effiziente Container-Images zu erstellen, folgen Sie den Bewährte Methoden für das Schreiben von Dockerfiles.

Auf dieser Seite wird erklärt, wie Sie Container-Images für Lambda erstellen, testen und bereitstellen.

Themen

AWS Basisimages für.NET
Mit einem AWS Basisimage für.NET
Verwenden eines alternativen Basis-Images mit dem Laufzeitschnittstellen-Client

AWS Basisimages für.NET

AWS stellt die folgenden Basisimages für.NET bereit:

Tags (Markierungen)	Laufzeit	Betriebssystem	Dockerfile	Ablehnung
10	.NET 10	Amazon Linux 2023	Dockerfile für .NET 10 auf GitHub	14. November 2028
9	.NET 9	Amazon Linux 2023	Dockerfile für .NET 9 auf GitHub	10. November 2026
8	.NET 8	Amazon Linux 2023	Dockerfile für .NET 8 auf GitHub	10. November 2026

Amazon ECR-Repository: gallery.ecr. aws/lambda/dotnet

Mit einem AWS Basisimage für.NET

Voraussetzungen

Zur Durchführung der Schritte in diesem Abschnitt benötigen Sie Folgendes:

.NET SDK – Die folgenden Schritte verwenden das .NET 8-Basis-Image. Stellen Sie sicher, dass Ihre .NET-Version mit der Version des Basis-Images übereinstimmt, die Sie in Ihrer Docker-Datei angeben.
Docker (Mindestversion 25.0.0)
Das Docker-buildx-Plugin.

Erstellen und Bereitstellen eines Images mithilfe eines Basis-Images

In den folgenden Schritten verwenden Sie Amazon.Lambda.Templatesund, Amazon.Lambda.Toolsum ein .NET-Projekt zu erstellen. Anschließend erstellen Sie ein Docker-Image, laden das Image auf Amazon ECR hoch und stellen es auf einer Lambda-Funktion bereit.

Installieren Sie das Paket Amazon.Lambda.Templates NuGet .
```
dotnet new install Amazon.Lambda.Templates
```
Erstellen Sie ein .NET-Projekt mithilfe der lambda.image.EmptyFunction-Vorlage.
```
dotnet new lambda.image.EmptyFunction --name MyFunction --region us-east-1
```
Die Projektdateien werden im MyFunction/src/MyFunction-Verzeichnis gespeichert:
- aws-lambda-tools-defaults.json: Gibt die Befehlszeilenoptionen zum Bereitstellen Ihrer Lambda-Funktion an.
- Function.cs: Ihr Lambda-Handler-Funktionscode. Dies ist eine C#-Vorlage mit der Amazon.Lambda.Core-Standardbibliothek und einem LambdaSerializer-Standardattribut. Weitere Informationen über Serialisierungsanforderungen und -optionen finden Sie unter Serialisierung in C#-Lambda-Ereignisfunktionen. Sie können den bereitgestellten Code zum Testen verwenden oder ihn durch Ihren eigenen ersetzen.
- MyFunction.csproj: Eine .NET-Projektdatei, die die Dateien und Assemblys auflistet, aus denen Ihre Anwendung besteht.
- Dockerfile: Sie können die bereitgestellte Docker-Datei zum Testen verwenden oder sie durch Ihre eigene ersetzen. Wenn Sie Ihre eigenen verwenden, stellen Sie sicher, dass Sie:
  - Setzen Sie die FROM-Eigenschaft auf den URI des Basis-Images. Das Basis-Image und das TargetFramework in der Datei MyFunction.csproj müssen beide dieselbe .NET-Version verwenden. Um beispielsweise .NET 9 zu verwenden:
    
    Docker-Datei: FROM public.ecr.aws/lambda/dotnet:9
    
    MyFunction.csproj: <TargetFramework>net9.0</TargetFramework>
  - Legen Sie das CMD-Argument auf den Lambda-Funktionshandler fest. Das sollte mit dem image-command in aws-lambda-tools-defaults.json übereinstimmen.
Installieren Sie Amazon.Lambda.Tools das.NET Global Tool.
```
dotnet tool install -g Amazon.Lambda.Tools
```
Wenn Amazon.Lambda.Tools es bereits installiert ist, stellen Sie sicher, dass Sie die neueste Version haben.
```
dotnet tool update -g Amazon.Lambda.Tools
```
Ändern Sie das Verzeichnis zu MyFunction/src/MyFunction, sofern Sie dies noch nicht getan haben.
```
cd src/MyFunction
```
Wird verwendet Amazon.Lambda.Tools , um das Docker-Image zu erstellen, es in ein neues Amazon ECR-Repository zu übertragen und die Lambda-Funktion bereitzustellen.

Für --function-role geben Sie den Rollennamen – nicht den Amazon-Ressourcenname (ARN) – der Ausführungsrolle für die Funktion an. Beispiel, lambda-role.
```
dotnet lambda deploy-function MyFunction --function-role lambda-role
```
Weitere Informationen zum Amazon.Lambda.Tools .NET Global Tool finden Sie im AWS Extensions for .NET CLI Repository unter GitHub.

Die Funktion aufrufen.


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

Wenn alles erfolgreich ist, sehen Sie eine Antwort ähnlich der folgenden:

Payload:
{"Lower":"testing the function","Upper":"TESTING THE FUNCTION"}

Log Tail:
INIT_REPORT Init Duration: 9999.81 ms   Phase: init     Status: timeout
START RequestId: 12378346-f302-419b-b1f2-deaa1e8423ed Version: $LATEST
END RequestId: 12378346-f302-419b-b1f2-deaa1e8423ed
REPORT RequestId: 12378346-f302-419b-b1f2-deaa1e8423ed  Duration: 3173.06 ms    Billed Duration: 3174 ms        Memory Size: 512 MB     Max Memory Used: 24 MB

Löschen Sie die Lambda-Funktion.


dotnet lambda delete-function MyFunction

Verwenden eines alternativen Basis-Images mit dem Laufzeitschnittstellen-Client

Wenn Sie ein OS-only Basis-Image oder ein alternatives Basis-Image verwenden, müssen Sie den Runtime-Interface-Client in Ihr Image aufnehmen. Der Laufzeitschnittstellen-Client erweitert die Laufzeit-API, die die Interaktion zwischen Lambda und Ihrem Funktionscode verwaltet.

Das folgende Beispiel zeigt, wie ein Container-Image für .NET mithilfe eines AWS Nicht-Basis-Images erstellt wird und wie das Amazon.Lambda.RuntimeSupport Paket hinzugefügt wird, das der Lambda-Runtime-Interface-Client für .NET ist. Das Beispiel-Dockerfile verwendet das Basis-Image „Microsoft .NET 8“.

Voraussetzungen

Zur Durchführung der Schritte in diesem Abschnitt benötigen Sie Folgendes:

.NET SDK — In den folgenden Schritten wird ein .NET 9-Basisimage verwendet. Stellen Sie sicher, dass Ihre .NET-Version mit der Version des Basis-Images übereinstimmt, die Sie in Ihrer Docker-Datei angeben.
Docker (Mindestversion 25.0.0)
Das Docker-buildx-Plugin.

Erstellen und Bereitstellen eines Images mithilfe eines alternativen Basis-Images

Installieren Sie das Paket Amazon.Lambda.Templates NuGet .
```
dotnet new install Amazon.Lambda.Templates
```
Erstellen Sie ein .NET-Projekt mithilfe der lambda.CustomRuntimeFunction-Vorlage. Diese Vorlage enthält das Amazon.Lambda.RuntimeSupportPaket.
```
dotnet new lambda.CustomRuntimeFunction --name MyFunction --region us-east-1
```
Navigieren Sie zum MyFunction/src/MyFunction Verzeichnis . Hier werden die Projektdateien gespeichert. Prüfen Sie die folgenden Dateien:
- aws-lambda-tools-defaults.json – In dieser Datei geben Sie die Befehlszeilenoptionen an, wenn Sie Ihre Lambda-Funktion bereitstellen.
- Function.cs— Der Code enthält eine Klasse mit einer Main Methode, die die Amazon.Lambda.RuntimeSupport Bibliothek als Bootstrap initialisiert. Die Main-Methode ist der Einstiegspunkt für den Prozess der Funktion. Die Main-Methode verpackt den Funktionshandler in einen Wrapper, mit dem der Bootstrap arbeiten kann. Weitere Informationen finden Sie unter Amazon.Lambda.RuntimeSupport Als Klassenbibliothek im Repository verwenden. GitHub
- MyFunction.csproj— Eine .NET-Projektdatei, die die Dateien und Assemblys auflistet, aus denen Ihre Anwendung besteht.
- Readme.md— Diese Datei enthält weitere Informationen zur Lambda-Beispielfunktion.

Öffnen Sie die Datei aws-lambda-tools-defaults.json und fügen Sie die folgenden Zeilen hinzu:


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

package-type: Definiert das Bereitstellungspaket als Container-Image.
docker-host-build-output-dir: Legt das Ausgabeverzeichnis für den Build-Prozess fest.

Beispiel 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"
}

Erstellen Sie ein Dockerfile in Verzeichnis MyFunction/src/MyFunction. Das folgende Beispiel-Dockerfile verwendet ein Microsoft .NET-Basisimage anstelle eines AWS -Basis-Images.
- Legen Sie FROM-Eigenschaft auf die Kennung des Basis-Images fest. Das Basis-Image und das TargetFramework in der Datei MyFunction.csproj müssen beide dieselbe .NET-Version verwenden.
- Verwenden Sie den COPY-Befehl, um die Funktion in das Verzeichnis /var/task zu kopieren.
- Legen Sie ENTRYPOINT auf das Modul fest, das der Docker-Container beim Start ausführen soll. In diesem Fall ist das Modul der Bootstrap, der die Bibliothek Amazon.Lambda.RuntimeSupport initialisiert.
Beachten Sie, dass das Dockerfile-Beispiel keine USER-Anweisung enthält. Wenn Sie ein Container-Image für Lambda bereitstellen, definiert Lambda automatisch einen Standard-Linux-Benutzer mit Berechtigungen mit geringsten Rechten. Dies unterscheidet sich vom Standardverhalten von Docker, bei dem standardmäßig der root-Benutzer verwendet wird, wenn keine USER-Anweisung bereitgestellt wird.
Beispiel Dockerfile
```
# You can also pull these images from DockerHub amazon/aws-lambda-dotnet:8
FROM mcr.microsoft.com/dotnet/runtime:9.0

# Set the image's internal work directory
WORKDIR /var/task
  
# Copy function code to Lambda-defined environment variable
COPY "bin/Release/net9.0/linux-x64"  .
  
# Set the entrypoint to the bootstrap
ENTRYPOINT ["/usr/bin/dotnet", "exec", "/var/task/bootstrap.dll"]
```
Installieren Sie die Erweiterung Amazon.Lambda.Tools .NET Global Tools.
```
dotnet tool install -g Amazon.Lambda.Tools
```
Wenn sie bereits installiert Amazon.Lambda.Tools ist, stellen Sie sicher, dass Sie die neueste Version haben.
```
dotnet tool update -g Amazon.Lambda.Tools
```
Wird verwendet Amazon.Lambda.Tools , um das Docker-Image zu erstellen, es in ein neues Amazon ECR-Repository zu übertragen und die Lambda-Funktion bereitzustellen.

Für --function-role geben Sie den Rollennamen – nicht den Amazon-Ressourcenname (ARN) – der Ausführungsrolle für die Funktion an. Beispiel, lambda-role.
```
dotnet lambda deploy-function MyFunction --function-role lambda-role
```
Weitere Informationen zur Amazon.Lambda.Tools .NET-CLI-Erweiterung finden Sie im AWS Extensions for .NET CLI-Repository unter GitHub.

Die Funktion aufrufen.


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

Wenn alles erfolgreich ist, sehen Sie Folgendes:


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

Löschen Sie die Lambda-Funktion.


dotnet lambda delete-function MyFunction

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Layer

Native AOT-Kompilierung

Bereitstellen von.NET-Lambda-Ereignisfunktionen mit Container-Images

Tipp

Themen

AWS Basisimages für.NET

Mit einem AWS Basisimage für.NET

Voraussetzungen

Erstellen und Bereitstellen eines Images mithilfe eines Basis-Images

Verwenden eines alternativen Basis-Images mit dem Laufzeitschnittstellen-Client

Voraussetzungen

Erstellen und Bereitstellen eines Images mithilfe eines alternativen Basis-Images

Beispiel aws-lambda-tools-defaults.json

Beispiel Dockerfile