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.

Unterstützte Laufzeiten für langlebige Funktionen

Dauerhafte Funktionen sind für ausgewählte verwaltete Laufzeiten und OCI-Container-Images für zusätzliche Flexibilität bei Laufzeitversionen verfügbar. Sie können dauerhafte Funktionen für Node.js Python und Java mithilfe verwalteter Laufzeiten direkt in der Konsole oder programmgesteuert über Infrastructure-as-Code erstellen.

Von Lambda verwaltete Laufzeiten

Die folgenden verwalteten Laufzeiten unterstützen dauerhafte Funktionen, wenn Sie Funktionen in der Lambda-Konsole erstellen oder AWS CLI mit dem --durable-config '{"ExecutionTimeout": 3600, "RetentionPeriodInDays": 7}' Parameter verwenden. Vollständige Informationen zu Lambda-Laufzeiten finden Sie unter Lambda-Laufzeiten.

Node.js

Installieren Sie das SDK in Ihrem Node.js Projekt:

npm install @aws/durable-execution-sdk-js
      

Das SDK unterstützt JavaScript und TypeScript. Für TypeScript Projekte enthält das SDK Typdefinitionen.

Python

Installieren Sie das SDK in Ihrem Python-Projekt:

pip install aws-durable-execution-sdk-python
      

Das Python-SDK verwendet synchrone Methoden und benötigt async/await keine.

Java

Fügen Sie eine Abhängigkeit hinzu zupom.xml:

<dependency>
    <groupId>software.amazon.lambda.durable</groupId>
    <artifactId>aws-durable-execution-sdk-java</artifactId>
    <version>VERSION</version>
</dependency>
      

Installieren Sie das SDK in Ihrem Java-Projekt:

mvn install
      

Das Java-SDK bietet sowohl synchrone als auch asynchrone Versionen jeder Methode.

Container-Images

Sie können dauerhafte Funktionen mit Container-Images verwenden, um zusätzliche Laufzeitversionen oder benutzerdefinierte Laufzeitkonfigurationen zu unterstützen. Mit Container-Images können Sie Laufzeitversionen verwenden, die nicht als verwaltete Laufzeiten verfügbar sind, oder Ihre Laufzeitumgebung anpassen.

So erstellen Sie eine dauerhafte Funktion mithilfe eines Container-Images:

Beispiel für einen Container

Erstellen Sie ein Dockerfile:

Python

Erstellen Sie ein Dockerfile für Python 3.11:

FROM public.ecr.aws/lambda/python:3.11

# Copy requirements file
COPY requirements.txt ${LAMBDA_TASK_ROOT}/

# Install dependencies including durable SDK
RUN pip install -r requirements.txt

# Copy function code
COPY lambda_function.py ${LAMBDA_TASK_ROOT}/

# Set the handler
CMD [ "lambda_function.handler" ]
              

Erstelle eine Datei: requirements.txt

aws-durable-execution-sdk-python
              

Java

Erstellen Sie ein Dockerfile für Java 25:

FROM --platform=linux/amd64 public.ecr.aws/lambda/java:25

# Install Maven
RUN dnf install -y maven

WORKDIR /var/task

# Copy Maven configuration and source code
COPY pom.xml .
COPY src ./src

# Build
RUN mvn clean package -DskipTests

# Move JAR to lib directory
RUN mv target/*.jar lib/

# Set the handler
CMD ["src.path.to.lambdaFunction::handler"]
              

Erstellen Sie das Image und übertragen Sie es:

# Build the image
docker build -t my-durable-function .

# Tag for ECR
docker tag my-durable-function:latest 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-durable-function:latest

# Push to ECR
docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/my-durable-function:latest
      

Erstellen Sie die Funktion mit aktivierter dauerhafter Ausführung:

aws lambda create-function \
  --function-name myDurableFunction \
  --package-type Image \
  --code ImageUri=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-durable-function:latest \
  --role arn:aws:iam::123456789012:role/lambda-execution-role \
  --durable-config '{"ExecutionTimeout": 3600, "RetentionPeriodInDays": 7}'
      

Weitere Informationen zur Verwendung von Container-Images mit Lambda finden Sie unter Creating Lambda container images im Lambda Developer Guide.

Überlegungen zur Laufzeit

SDK-Versionsverwaltung: Um die volle Kontrolle über Ihre Abhängigkeiten zu behalten und mögliche Probleme mit Versionsfehlern zu vermeiden, empfehlen wir Ihnen, alle Abhängigkeiten Ihrer Funktion zu Ihrem Bereitstellungspaket hinzuzufügen, auch wenn Versionen davon standardmäßig in der Lambda-Laufzeit enthalten sind. Dazu gehört auch das Durable Execution SDK. Sperren Sie das SDK für die dauerhafte Ausführung auf eine Hauptversion in Ihrer Abhängigkeitsdatei. Eine neue Hauptversion kann Änderungen mit sich bringen, die dazu führen können, dass die Ausführung während des Fluges fehlschlägt. Verwenden Sie nummerierte Versionen oder Aliase für langlebige Produktionsfunktionen, anstatt sicherzustellen, dass $LATEST sich Änderungen der SDK-Version nicht auf die Ausführung während des Betriebs auswirken.

AWS Runtime-Updates: aktualisiert verwaltete Laufzeiten um Sicherheitspatches und Bugfixes. Diese Updates können neue SDK-Versionen enthalten. Um unerwartetes Verhalten zu vermeiden, nehmen Sie das SDK in Ihr Bereitstellungspaket auf und testen Sie es gründlich, bevor Sie es in der Produktion einsetzen.

Größe des Container-Images: Container-Images haben eine maximale unkomprimierte Größe von 10 GB. Das Durable Execution SDK fügt Ihrem Bild eine minimale Größe hinzu. Optimieren Sie Ihren Container, indem Sie mehrstufige Builds verwenden und unnötige Abhängigkeiten entfernen.

Kaltstartleistung: Container-Images haben möglicherweise längere Kaltstartzeiten als verwaltete Laufzeiten. Das langlebige Ausführungs-SDK hat nur minimale Auswirkungen auf die Kaltstartleistung. Verwenden Sie die bereitgestellte Parallelität, wenn die Kaltstart-Latenz für Ihre Anwendung entscheidend ist.