AWS Lambda Durable Execution SDK for Rust が GA になったので試してみた

AWS Lambda Durable Execution SDK for Rust が GA になったので試してみた

Lambda durable functions の処理を Rust で書ける SDK が GA になりました。Quickstart の関数を Cargo Lambda でビルドして provided.al2023 に載せ、同期 invoke で実行して、CloudWatch Logs の実行記録を確認しました。
2026.11.20

はじめに

2026年11月19日に、AWS Lambda Durable Execution SDK for Rust の一般提供開始(GA)が発表されました。

https://aws.amazon.com/about-aws/whats-new/2026/11/lambda-durable-execution-sdk-rust/

この 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 が使えます。各操作のオプションと戻り値は、公式ガイドから辿れるリファレンスに載っています。

https://docs.aws.amazon.com/durable-execution/sdk-reference/languages/rust/

ビルドとデプロイ

ビルドは 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 をお試しください。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事