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 und Python mithilfe verwalteter Laufzeiten direkt in der Konsole oder programmgesteuert erstellen. infrastructure-as-code Dauerhafte Funktionen in Java (Preview) können derzeit nur über Container-Images bereitgestellt werden.

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 Projekt Node.js:

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 (Vorschau)

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
      

Eine Vorschauversion des Java-SDK ist verfügbar. Die Operationen waitForCondition, waitForCallback, Parallel und Map befinden sich noch in der Entwicklung.

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 (Preview)

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: Nehmen Sie das Durable Execution SDK in Ihr Bereitstellungspaket oder Container-Image auf. Dadurch wird sichergestellt, dass Ihre Funktion eine bestimmte SDK-Version verwendet und nicht durch Runtime-Updates beeinträchtigt wird. Stecken Sie SDK-Versionen in Ihren PC package.jsonrequirements.txt, um zu kontrollieren, wann Sie ein Upgrade durchführen.

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.