Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Anwendungen bereitstellen ASP.NET

Sie können nicht nur ereignisgesteuerte Funktionen hosten, sondern auch .NET mit Lambda verwenden, um einfache Anwendungen zu hosten. ASP.NET Mit dem Paket können Sie ASP.NET Anwendungen erstellen und bereitstellen. Amazon.Lambda.AspNetCoreServer NuGet In diesem Abschnitt erfahren Sie, wie Sie mithilfe des.NET Lambda-CLI-Tools eine ASP.NET Web-API auf Lambda bereitstellen.

Voraussetzungen

Bereitstellung einer ASP.NET Web-API auf Lambda

Um eine Web-API mit bereitzustellen ASP.NET, können Sie die.NET-Lambda-Vorlagen verwenden, um ein neues Web-API-Projekt zu erstellen. Verwenden Sie den folgenden Befehl, um ein neues ASP.NET Web-API-Projekt zu initialisieren. Im Beispielbefehl nennen wir das Projekt AspNetOnLambda.

dotnet new serverless.AspNetCoreWebAPI -n AspNetOnLambda

Mit diesem Befehl werden die folgenden Dateien und Verzeichnisse in Ihrem Projektverzeichnis erstellt.

.
└── AspNetOnLambda
    ├── src
    │   └── AspNetOnLambda
    │       ├── AspNetOnLambda.csproj
    │       ├── Controllers
    │       │   └── ValuesController.cs
    │       ├── LambdaEntryPoint.cs
    │       ├── LocalEntryPoint.cs
    │       ├── Readme.md
    │       ├── Startup.cs
    │       ├── appsettings.Development.json
    │       ├── appsettings.json
    │       ├── aws-lambda-tools-defaults.json
    │       └── serverless.template
    └── test
        └── AspNetOnLambda.Tests
            ├── AspNetOnLambda.Tests.csproj
            ├── SampleRequests
            │   └── ValuesController-Get.json
            ├── ValuesControllerTests.cs
            └── appsettings.json

Wenn Lambda Ihre Funktion aufruft, wird als Einstiegspunkt die Datei LambdaEntryPoint.cs verwendet. Die von der .NET Lambda-Vorlage erstellte Datei enthält den folgenden Code.

namespace AspNetOnLambda;

public class LambdaEntryPoint : Amazon.Lambda.AspNetCoreServer.APIGatewayProxyFunction
{
    protected override void Init(IWebHostBuilder builder)
    {
        builder
            .UseStartup≪Startup≫();
    }

    protected override void Init(IHostBuilder builder)
    {
    }
}

Der von Lambda verwendete Einstiegspunkt muss von einer der drei Basisklassen im Paket Amazon.Lambda.AspNetCoreServer erben. Diese drei Basisklassen sind:

Die Standardklasse, die verwendet wird, wenn Sie Ihre LambdaEntryPoint.cs-Datei mit der bereitgestellten .NET Lambda-Vorlage erstellen, ist APIGatewayProxyFunction. Die Basisklasse, die Sie in Ihrer Funktion verwenden, hängt davon ab, welche API-Schicht vor Ihrer Lambda-Funktion steht.

Jede der drei Basisklassen enthält eine öffentliche Methode namens FunctionHandlerAsync. Der Name dieser Methode ist Teil der Handler-Zeichenfolge, die Lambda zum Aufrufen Ihrer Funktion verwendet. Die FunctionHandlerAsync Methode transformiert die Nutzlast für eingehende Ereignisse in das richtige ASP.NET Format und die ASP.NET Antwort zurück in eine Lambda-Antwort-Nutzlast. Für das gezeigte Beispielprojekt AspNetOnLambda würde der Handler-String wie folgt lauten.

AspNetOnLambda::AspNetOnLambda.LambdaEntryPoint::FunctionHandlerAsync

Um die API in Lambda bereitzustellen, führen Sie die folgenden Befehle aus, um in das Verzeichnis mit Ihrer Quellcodedatei zu navigieren und Ihre Funktion mit CloudFormation bereitzustellen.

cd AspNetOnLambda/src/AspNetOnLambda
dotnet lambda deploy-serverless

Bereitstellung ASP.NET minimaler APIs für Lambda

Um eine ASP.NET minimale API für Lambda bereitzustellen, können Sie die .NET-Lambda-Vorlagen verwenden, um ein neues minimales API-Projekt zu erstellen. Verwenden Sie den folgenden Befehl, um ein neues minimales API-Projekt zu initialisieren. In diesem Beispiel nennen wir das Projekt MinimalApiOnLambda.

dotnet new serverless.AspNetCoreMinimalAPI -n MinimalApiOnLambda

Der Befehl erstellt die folgenden Dateien und Verzeichnisse in Ihrem Projektverzeichnis.

└── MinimalApiOnLambda
    └── src
        └── MinimalApiOnLambda
            ├── Controllers
            │   └── CalculatorController.cs
            ├── MinimalApiOnLambda.csproj
            ├── Program.cs
            ├── Readme.md
            ├── appsettings.Development.json
            ├── appsettings.json
            ├── aws-lambda-tools-defaults.json
            └── serverless.template

Die Datei Program.cs enthält den folgenden Code.

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddControllers();

// Add AWS Lambda support. When application is run in Lambda Kestrel is swapped out as the web server with Amazon.Lambda.AspNetCoreServer. This
// package will act as the webserver translating request and responses between the Lambda event source and ASP.NET Core.
builder.Services.AddAWSLambdaHosting(LambdaEventSource.RestApi);

var app = builder.Build();


app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.MapGet("/", () => "Welcome to running ASP.NET Core Minimal API on AWS Lambda");

app.Run();

Um Ihre Minimal-API für die Ausführung auf Lambda zu konfigurieren, müssen Sie diesen Code möglicherweise bearbeiten, damit Anfragen und Antworten zwischen Lambda und ASP.NET Core ordnungsgemäß übersetzt werden. Standardmäßig ist die Funktion für eine REST-API-Ereignisquelle konfiguriert. Für eine HTTP-API oder einen Application Load Balancer ersetzen Sie (LambdaEventSource.RestApi) durch eine der folgenden Optionen:

Um Ihre Minimal-API in Lambda bereitzustellen, führen Sie die folgenden Befehle aus, um in das Verzeichnis mit Ihrer Quellcodedatei zu navigieren und Ihre Funktion mit CloudFormation bereitzustellen.

cd MinimalApiOnLambda/src/MinimalApiOnLambda
dotnet lambda deploy-serverless