
AWS Lambda Durable Execution SDK for Rust が GA になったので試してみた
はじめに
2026年11月19日に、AWS Lambda Durable Execution SDK for Rust の一般提供開始(GA)が発表されました。
この SDK では、Lambda durable functions の処理を通常の async な Rust 関数として書けます。この記事では、Quickstart の関数をデプロイして実行記録を確認する流れを扱います。
検証環境
SDK の動作条件は Rust 1.94.1 以降です。検証に使った環境は次のとおりです。
- 実施日:2026年11月20日
- リージョン:東京(ap-northeast-1)
- 関数のアーキテクチャ:x86_64
- ランタイム:provided.al2023
- aws-durable-execution-sdk 1.0.0、lambda_runtime 1.5.0
- rustc / cargo 1.96.1、Cargo Lambda 1.9.2
- AWS CLI 2.41.2
- ビルドは、aarch64 Linux ホスト上の Docker で実行
Docker イメージは rust:1.96-bookworm に pip で Cargo Lambda を導入したものです。cargo と cargo lambda のコマンドはこのイメージのコンテナ内で実行しました。
ビルド用の Dockerfile
Dockerfile として保存し、docker build -t durable-rust-build . でイメージを作ります。
FROM rust:1.96-bookworm
# cargo-lambda は公式の手順どおり pip3 で入れる(Zig も一緒に入る)
RUN apt-get update \
&& apt-get install -y --no-install-recommends python3-venv \
&& rm -rf /var/lib/apt/lists/* \
&& python3 -m venv /opt/venv \
&& /opt/venv/bin/pip install --no-cache-dir cargo-lambda \
&& rustup target add x86_64-unknown-linux-gnu
ENV PATH="/opt/venv/bin:${PATH}"
関数の実装
プロジェクトを作り、必要な crate を追加します。
cargo new my-function && cd my-function \
&& cargo add aws-durable-execution-sdk \
&& cargo add lambda_runtime serde_json tracing \
&& cargo add serde --features derive \
&& cargo add tokio --features macros
src/main.rs には、Quickstart の Rust 版ハンドラーを置きます。
use std::time::Duration;
use aws_durable_execution_sdk as durable;
use serde::{Deserialize, Serialize};
#[derive(Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
struct Response {
status_code: u16,
body: String,
}
async fn handler(
_event: serde_json::Value,
ctx: durable::DurableContext,
) -> Result<Response, durable::BoxError> {
let message = ctx
.step(|_| async {
tracing::info!("Hello from step-1");
Ok("Hello from Durable Lambda!".to_owned())
})
.name("step-1")
.await?;
ctx.wait(Duration::from_secs(10)).await?;
// Replay-aware: logs once even though the function replays after the wait
tracing::info!("Resumed after wait");
Ok(Response {
status_code: 200,
body: message,
})
}
#[tokio::main]
async fn main() -> Result<(), lambda_runtime::Error> {
durable::init_default_subscriber()?;
durable::run(handler).await
}
コードの要点は次のとおりです。
- ハンドラー: イベントと DurableContext を受け取り、Result を返す通常の async 関数です。イベント型に Deserialize、出力型に Serialize が必要で、SDK が serde_json で変換します。
- step: 結果を保存する単位です。名前を付けると、実行履歴にその名前で載ります。
- wait: 指定した時間だけ実行を止めます。
- main: init_default_subscriber でログ出力を設定し、ハンドラーを durable::run に渡します。
step と wait のほかに、invoke、wait_for_callback、wait_for_condition、map、parallel、with_retry が使えます。各操作のオプションと戻り値は、公式ガイドから辿れるリファレンスに載っています。
ビルドとデプロイ
ビルドは Cargo Lambda で行います。
cargo lambda build --release --x86-64 --output-format zip
出力先は target/lambda/my-function/bootstrap.zip です。
公式ガイドによると、provided.al2023 の glibc は 2.34 で、素の cargo build でこれより新しい glibc にリンクしたバイナリは起動時に失敗します。Cargo Lambda は Zig 経由でリンクして glibc のバージョンを固定します。provided.al2023 向けのビルドに Cargo Lambda を使うのはこのためです。
実行ロールを作成します。信頼ポリシーを trust-policy.json として保存し、ロールの作成後にマネージドポリシーを付与します。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": { "Service": "lambda.amazonaws.com" },
"Action": "sts:AssumeRole"
}
]
}
aws iam create-role \
--role-name devio-rust-durable-verify-role \
--assume-role-policy-document file://trust-policy.json
aws iam attach-role-policy \
--role-name devio-rust-durable-verify-role \
--policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicDurableExecutionRolePolicy
AWSLambdaBasicDurableExecutionRolePolicy の内容
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents",
"lambda:CheckpointDurableExecution",
"lambda:GetDurableExecutionState"
],
"Resource": "*"
}
]
}
関数は create-function で作成します。今回は、作成時に --durable-config を指定して durable 関数にします。
aws lambda create-function \
--function-name rust-durable-quickstart \
--runtime provided.al2023 \
--role arn:aws:iam::123456789012:role/devio-rust-durable-verify-role \
--handler bootstrap \
--architectures x86_64 \
--zip-file fileb://target/lambda/my-function/bootstrap.zip \
--durable-config '{"ExecutionTimeout": 900, "RetentionPeriodInDays": 1}'
作成直後の State は Pending だったので、Active になるまで待ってから invoke します。
aws lambda wait function-active-v2 --function-name rust-durable-quickstart
同期 invoke と実行記録
関数を同期 invoke します。
aws lambda invoke \
--function-name 'rust-durable-quickstart:$LATEST' \
--cli-binary-format raw-in-base64-out \
--payload '{}' \
response.json
{
"StatusCode": 200,
"ExecutedVersion": "$LATEST",
"DurableExecutionArn": "arn:aws:lambda:ap-northeast-1:123456789012:function:rust-durable-quickstart:$LATEST/durable-execution/<execution-name>/<execution-id>"
}
response.json には、ハンドラーの戻り値が入っていました。
{"statusCode":200,"body":"Hello from Durable Lambda!"}
応答が返ったのは 01:01:40(UTC)でした。DurableExecutionArn は、後述の get-durable-execution と get-durable-execution-history で実行を指定するときに使います。
実行記録は、まず CloudWatch Logs の filter-log-events で取得しました。
aws logs filter-log-events --log-group-name /aws/lambda/rust-durable-quickstart
7 件のイベントを時刻順に並べたものが次の表です。時刻は UTC です。
| 時刻 | 種別 | 内容 |
|---|---|---|
| 01:01:27.765 | platform.initStart | initializationType: on-demand |
| 01:01:27.827 | platform.start | 1 回目の呼び出し |
| 01:01:28.682 | アプリのログ | Hello from step-1(operationName: step-1、attempt: 1) |
| 01:01:30.056 | platform.report | status: success |
| 01:01:40.122 | platform.start | 2 回目の呼び出し |
| 01:01:40.123 | アプリのログ | Resumed after wait(operationName なし) |
| 01:01:40.124 | platform.report | status: success |
1 回の実行が、wait をはさんで 2 回の Lambda 呼び出しに分かれました。1 回目は 01:01:30.056 に終わり、2 回目は 01:01:40.122 に始まりました。step のログは 1 回目の呼び出しにだけ出力されました。
2 回目の呼び出しのログは、発生した 01:01:40.122 から約 9 秒後の 01:01:49.137 に CloudWatch Logs へ取り込まれました。filter-log-events を実行したのは応答の約 12 秒後の 01:01:52 だったので、7 件が揃っていました。
7 件のイベントにある status は、呼び出しごとの platform.report のものです。durable execution 全体の status と終了時刻は、get-durable-execution で取得します。
aws lambda get-durable-execution --durable-execution-arn "<DurableExecutionArn>"
次に示すのは、応答から Result、開始時刻、Status、終了時刻を抜き出したものです。+09:00 で返った時刻は UTC に直しています。
{
"Result": "{\"statusCode\":200,\"body\":\"Hello from Durable Lambda!\"}",
"StartTimestamp": "2026-11-20T01:01:27.567000Z",
"Status": "SUCCEEDED",
"EndTimestamp": "2026-11-20T01:01:40.132000Z"
}
この 1 回の実行は、開始から終了まで約 12.6 秒でした。
実行履歴は get-durable-execution-history で取得します。
aws lambda get-durable-execution-history --durable-execution-arn "<DurableExecutionArn>"
Events の EventType は、次の順に並びました。
ExecutionStarted
StepStarted
StepSucceeded
WaitStarted
InvocationCompleted
WaitSucceeded
InvocationCompleted
ExecutionSucceeded
InvocationCompleted が 2 回記録されていました。
まとめ
GA になった AWS Lambda Durable Execution SDK for Rust で、durable 関数を通常の async 関数として書けることを確認できました。
Rust で実装するワークロードの実行環境として、長時間のタスクを扱える Lambda durable functions を採用する場合は、今回 GA になった SDK をお試しください。








