Runtime yang didukung untuk fungsi yang tahan lama

Fungsi tahan lama tersedia untuk runtime Node.js dan Python. Anda dapat membuat fungsi tahan lama menggunakan runtime terkelola di konsol Lambda atau menerapkannya menggunakan gambar kontainer untuk fleksibilitas versi runtime tambahan.

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": 10, "RetentionPeriodInDays":1}'. Untuk informasi selengkapnya tentang runtime Lambda, lihat runtime Lambda.

Bahasa	Waktu Aktif
Node.js	nodejs22.x
Node.js	nodejs24.x
Python	python3.13
Python	python3.14

catatan

Runtime Lambda mencakup SDK eksekusi yang tahan lama untuk pengujian dan pengembangan. Namun, sebaiknya sertakan SDK dalam paket penerapan Anda untuk produksi. Ini memastikan konsistensi versi dan menghindari kemungkinan pembaruan runtime yang mungkin memengaruhi perilaku fungsi Anda.

Node.js

Instal SDK di proyek Node.js 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

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:

1. Buat Dockerfile berdasarkan gambar dasar Lambda

2. Instal SDK eksekusi yang tahan lama di container Anda

3. Buat dan dorong gambar kontainer ke Amazon Elastic Container Registry

4. Buat fungsi Lambda dari gambar kontainer dengan eksekusi tahan lama diaktifkan

Contoh wadah 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
      

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": 10, "RetentionPeriodInDays":1}'
      

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

Pertimbangan runtime

Manajemen versi SDK: Sertakan SDK eksekusi tahan lama dalam paket penerapan atau image kontainer Anda. Ini memastikan fungsi Anda menggunakan versi SDK tertentu dan tidak terpengaruh oleh pembaruan runtime. Sematkan versi SDK di package.json atau requirements.txt untuk mengontrol saat Anda memutakhirkan.

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.