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 kontainer OCI untuk fleksibilitas versi runtime tambahan. Anda dapat membuat fungsi tahan lama untuk Node.js, Python, dan Java menggunakan runtime terkelola secara langsung di konsol atau secara terprogram melalui infrastruktur-sebagai-kode.

Runtime terkelola Lambda

Runtime terkelola berikut mendukung fungsi tahan lama saat Anda membuat fungsi di konsol Lambda atau menggunakan parameter AWS CLI with--durable-config '{"ExecutionTimeout": 3600, "RetentionPeriodInDays": 7}'. Untuk informasi selengkapnya 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 memerlukan. async/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.

Image kontainer

Anda dapat menggunakan fungsi tahan lama dengan gambar kontainer untuk mendukung versi runtime tambahan atau konfigurasi runtime kustom. 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 kontainer:

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 penggunaan gambar kontainer dengan Lambda, lihat Membuat gambar kontainer Lambda di Panduan Pengembang Lambda.

Pertimbangan runtime

Manajemen versi SDK: Untuk mempertahankan kontrol penuh atas dependensi Anda dan untuk menghindari kemungkinan masalah ketidaksejajaran versi, kami sarankan Anda menambahkan semua dependensi fungsi ke paket penerapan Anda, meskipun versinya disertakan dalam runtime Lambda secara default. Ini termasuk SDK eksekusi yang tahan lama. Kunci SDK eksekusi tahan lama ke versi utama dalam file dependensi Anda. Versi utama baru dapat memperkenalkan perubahan yang dapat mengakibatkan kegagalan eksekusi dalam penerbangan. Gunakan versi bernomor atau alias untuk fungsi tahan lama produksi, bukan $LATEST untuk 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 termasuk 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 kontainer: Gambar kontainer memiliki ukuran maksimum yang tidak terkompresi 10 GB. SDK eksekusi yang tahan lama menambahkan ukuran minimal pada gambar Anda. Optimalkan penampung Anda dengan menggunakan build multi-tahap dan menghapus dependensi yang tidak perlu.

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