Tutorial: Erstellen einer Lambda-Funktion zum Streamen von Antworten mit einer Funktions-URL

In diesem Tutorial erstellen Sie eine Lambda-Funktion, die als ZIP-Dateiarchiv mit einem Funktions-URL-Endpunkt definiert ist, der einen Antwort-Stream zurückgibt. Weitere Hinweise zum Konfigurieren von Funktions-URLs finden Sie unter Funktion URLs.

Voraussetzungen

In diesem Tutorial wird davon ausgegangen, dass Sie über Kenntnisse zu den grundlegenden Lambda-Operationen und der Lambda-Konsole verfügen. Sofern noch nicht geschehen, befolgen Sie die Anweisungen unter Erstellen einer Lambda-Funktion mit der Konsole, um Ihre erste Lambda-Funktion zu erstellen.

Um die folgenden Schritte durchzuführen, benötigen Sie die AWS Command Line Interface (AWS CLI) Version 2. Befehle und die erwartete Ausgabe werden in separaten Blöcken aufgeführt:

aws --version

Die Ausgabe sollte folgendermaßen aussehen:

aws-cli/2.13.27 Python/3.11.6 Linux/4.14.328-248.540.amzn2.x86_64 exe/x86_64.amzn.2

Bei langen Befehlen wird ein Escape-Zeichen (\) wird verwendet, um einen Befehl über mehrere Zeilen zu teilen.

Verwenden Sie auf Linux und macOS Ihren bevorzugten Shell- und Paket-Manager.

Anmerkung

In Windows werden einige Bash-CLI-Befehle, die Sie häufig mit Lambda verwenden (z. B. zip), von den integrierten Terminals des Betriebssystems nicht unterstützt. Um eine in Windows integrierte Version von Ubuntu und Bash zu erhalten, installieren Sie das Windows-Subsystem für Linux. Die CLI-Beispielbefehle in diesem Handbuch verwenden die Linux-Formatierung. Befehle, die Inline-JSON-Dokumente enthalten, müssen neu formatiert werden, wenn Sie die Windows-CLI verwenden.

Erstellen einer Ausführungsrolle

Erstellen Sie die Ausführungsrolle die Ihrer Lambda-Funktion die Berechtigung für den Zugriff auf AWS -Ressourcen erteilt.

So erstellen Sie eine Ausführungsrolle

1. Öffnen Sie die Seite Rollen der AWS Identity and Access Management (IAM)-Konsole.

2. Wählen Sie Rolle erstellen aus.

3. Erstellen Sie eine Rolle mit den folgenden Eigenschaften:

   • Vertrauenswürdiger Entitätstyp – AWS -Service

   • Anwendungsfall – Lambda

   • Berechtigungen — AWSLambdaBasicExecutionRole

   • Role name (Name der Rolle – response-streaming-role

Die AWSLambdaBasicExecutionRoleRichtlinie verfügt über die Berechtigungen, die die Funktion benötigt, um Protokolle in Amazon CloudWatch Logs zu schreiben. Nachdem Sie die Rolle erstellt haben, notieren Sie sich den Amazon-Ressourcennamen (ARN). Sie benötigen ihn im nächsten Schritt.

Erstellen Sie eine Antwort-Streaming-Funktion (AWS CLI)

Erstellen Sie eine Antwort-Streaming-Lambda-Funktion mit einem Funktions-URL-Endpunkt unter Verwendung der AWS Command Line Interface (AWS CLI).

Um eine Funktion zu erstellen, die Antworten streamen kann

1. Kopieren Sie das folgende Codebeispiel in eine Datei mit dem Namen index.mjs.

   import util from 'util';
   import stream from 'stream';
   const { Readable } = stream;
   const pipeline = util.promisify(stream.pipeline);
   
   /* global awslambda */
   export const handler = awslambda.streamifyResponse(async (event, responseStream, _context) => {
     const requestStream = Readable.from(Buffer.from(JSON.stringify(event)));
     await pipeline(requestStream, responseStream);
   });

2. Erstellen Sie ein Bereitstellungspaket.

   zip function.zip index.mjs

3. Erstellen Sie eine Lambda-Funktion mit dem Befehl create-function. Ersetzen Sie den Wert von --role durch den Rollen-ARN aus dem vorherigen Schritt.

   aws lambda create-function \
     --function-name my-streaming-function \
     --runtime nodejs16.x \
     --zip-file fileb://function.zip \
     --handler index.handler \
     --role arn:aws:iam::123456789012:role/response-streaming-role

Um eine Funktions-URL zu erstellen

1. Fügen Sie Ihrer Funktion eine ressourcenbasierte Richtlinie hinzu, um den Zugriff auf Ihre Funktions-URL zu ermöglichen. Ersetzen Sie den Wert von --principal durch Ihre AWS-Konto ID.

   aws lambda add-permission \
     --function-name my-streaming-function \
     --action lambda:InvokeFunctionUrl \
     --statement-id 12345 \
     --principal 123456789012 \
     --function-url-auth-type AWS_IAM \
     --statement-id url

2. Erstellen Sie einen URL-Endpunkt für die Funktion mit dem Befehl create-function-url-config.

   aws lambda create-function-url-config \
     --function-name my-streaming-function \
     --auth-type AWS_IAM \
     --invoke-mode RESPONSE_STREAM 

Testen des Funktions-URL-Endpunkts

Testen Sie Ihre Integration, indem Sie Ihre Funktion aufrufen. Sie können die URL Ihrer Funktion in einem Browser öffnen oder curl verwenden.

curl --request GET "<function_url>" --user "<key:token>" --aws-sigv4 "aws:amz:us-east-1:lambda" --no-buffer

Unsere Funktions-URL nutzt den Authentifizierungstyp IAM_AUTH. Das bedeutet, dass Sie Anfragen sowohl mit Ihrem AWS Zugriffsschlüssel als auch mit Ihrem geheimen Schlüssel signieren müssen. Ersetzen Sie dies im vorherigen Befehl <key:token> durch die AWS Zugriffsschlüssel-ID. Geben Sie Ihren AWS geheimen Schlüssel ein, wenn Sie dazu aufgefordert werden. Wenn Sie Ihren AWS geheimen Schlüssel nicht haben, können Sie stattdessen temporäre AWS Anmeldeinformationen verwenden.

Bereinigen Ihrer Ressourcen

Sie können jetzt die Ressourcen, die Sie für dieses Tutorial erstellt haben, löschen, es sei denn, Sie möchten sie behalten. Durch das Löschen von AWS Ressourcen, die Sie nicht mehr verwenden, vermeiden Sie unnötige Kosten für Ihre AWS-Konto.

So löschen Sie die Ausführungsrolle

1. Öffnen Sie die Seite Roles in der IAM-Konsole.

2. Wählen Sie die von Ihnen erstellte Ausführungsrolle aus.

3. Wählen Sie Löschen aus.

4. Geben Sie den Namen der Rolle in das Texteingabefeld ein und wählen Sie Delete (Löschen) aus.

So löschen Sie die Lambda-Funktion:

1. Öffnen Sie die Seite Funktionen der Lambda-Konsole.

2. Wählen Sie die Funktion aus, die Sie erstellt haben.

3. Wählen Sie Aktionen, Löschen aus.

4. Geben Sie delete in das Texteingabefeld ein und wählen Sie Delete (Löschen) aus.