Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Runtime yang didukung untuk fungsi yang tahan lama

Fungsi tahan lama tersedia untuk runtime terkelola yang dipilih dan gambar wadah OCI untuk fleksibilitas versi runtime tambahan. Anda dapat membuat fungsi tahan lama untuk Node.js, Python, Java, dan C# (.NET) menggunakan runtime terkelola langsung di konsol atau secara terprogram melalui infrastruktur-as-code.

Runtime yang dikelola Lambda

Runtime terkelola berikut mendukung fungsi tahan lama saat Anda membuat fungsi di konsol Lambda atau menggunakan AWS CLI dengan parameter. --durable-config '{"ExecutionTimeout": 3600, "RetentionPeriodInDays": 7}' Untuk informasi lengkap tentang runtime Lambda, lihat runtime Lambda.

Node.js

Instal SDK di Node.js proyek Anda:

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

SDK mendukung JavaScript dan TypeScript. Untuk TypeScript proyek, SDK menyertakan definisi tipe.

Python

Instal SDK di proyek Python Anda:

pip install aws-durable-execution-sdk-python
      

Python SDK menggunakan metode sinkron dan tidak memerlukanasync/await.

Java

Tambahkan ketergantungan kepom.xml:

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

Instal SDK di proyek Java Anda:

mvn install
      

Java SDK menyediakan versi sinkron dan asinkron dari setiap metode.

C# (.NET)

Tambahkan SDK ke proyek.NET Anda:

dotnet add package Amazon.Lambda.DurableExecution
      

.NET SDK mengekspos operasi yang tahan lama melaluiIDurableContext. Handler Anda menerima amplop layanan eksekusi tahan lama dan mendelegasikannyaDurableFunction.WrapAsync. Setiap badan operasi membutuhkanCancellationToken.

Image kontainer

Anda dapat menggunakan fungsi tahan lama dengan gambar kontainer untuk mendukung versi runtime tambahan atau konfigurasi runtime khusus. Gambar kontainer memungkinkan Anda menggunakan versi runtime yang tidak tersedia sebagai runtime terkelola atau menyesuaikan lingkungan runtime Anda.

Untuk membuat fungsi tahan lama menggunakan gambar wadah:

Contoh kontainer

Buat Dockerfile:

Python

Buat Dockerfile untuk 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" ]
              

Buat requirements.txt file:

aws-durable-execution-sdk-python
              

Java

Buat Dockerfile untuk 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"]
              

Bangun dan dorong gambar:

# 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
      

Buat fungsi dengan eksekusi tahan lama diaktifkan:

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}'
      

Untuk informasi selengkapnya tentang menggunakan gambar kontainer dengan Lambda, lihat Membuat gambar wadah Lambda di Panduan Pengembang Lambda.

Pertimbangan runtime

Manajemen versi SDK: Untuk mempertahankan kontrol penuh atas dependensi Anda dan untuk menghindari kemungkinan masalah ketidakselarasan versi, kami sarankan Anda menambahkan semua dependensi fungsi Anda ke paket penerapan Anda, bahkan jika versinya disertakan dalam runtime Lambda secara default. Ini termasuk SDK eksekusi tahan lama. Kunci SDK eksekusi tahan lama ke versi utama di file ketergantungan Anda. Versi utama baru dapat memperkenalkan perubahan yang dapat mengakibatkan kegagalan eksekusi dalam penerbangan. Gunakan versi bernomor atau alias untuk fungsi produksi tahan lama daripada $LATEST memastikan perubahan versi SDK tidak memengaruhi eksekusi dalam penerbangan.

Pembaruan runtime: AWS memperbarui runtime terkelola untuk menyertakan patch keamanan dan perbaikan bug. Pembaruan ini mungkin menyertakan versi SDK baru. Untuk menghindari perilaku yang tidak terduga, sertakan SDK dalam paket penerapan Anda dan uji secara menyeluruh sebelum menerapkan ke produksi.

Ukuran gambar kon tainer: Gambar kontainer memiliki ukuran tidak terkompresi maksimum 10 GB. SDK eksekusi tahan lama menambahkan ukuran minimal ke gambar Anda. Optimalkan wadah Anda dengan menggunakan build multi-tahap dan menghapus dependensi yang tidak perlu.

Kinerja start dingin: Gambar kontainer mungkin memiliki waktu start dingin yang lebih lama daripada runtime yang dikelola. SDK eksekusi tahan lama memiliki dampak minimal pada kinerja cold start. Gunakan konkurensi yang disediakan jika latensi start dingin sangat penting untuk aplikasi Anda.