AWS Lambda Durable Functions を Kotlin(Java SDK)で動かしてみた

2026.06.15
AWS Lambda Durable Functions を Kotlin(Java SDK)で動かしてみた
この記事をシェアする

AWS Lambda Durable Functions の Java SDKを Kotlin から使い、step によるチェックポイントと wait による中断・再開が動作するところまでを確認しました。本記事では、Gradle プロジェクトのセットアップからAWSへのデプロイ・実行までの手順を紹介します。

この記事の要約

  • Java SDKは Kotlin からそのまま利用でき、DurableHandler の継承や step() の SAM 変換も問題なく動作する
  • デプロイにはコンテナイメージ方式が必須(マネージドランタイムは非対応)で、バージョンの publish も必要
  • IAM の Resource 指定には function:<name>:* のようにサブリソースまで含むワイルドカードが必要

Lambda Durable Functions とは

AWS Lambda Durable Functions は re:Invent 2025 で発表された機能で、Lambda 上でステートフルかつ耐障害性のある実行を実現します。

  • step() で囲んだ処理が自動的にチェックポイントされ、障害時にはリプレイで復旧する
  • wait() で最大1年間の中断が可能(中断中はコンピュート課金なし)
  • Step Functions のようなワークフローをコードで直接記述できる

JavaScript/TypeScript と Python が GA、Java は 2026年2月に Developer Preview が開始されました。Kotlin 専用の SDK はありませんが、Java SDK を Kotlin からそのまま利用できます。

この記事をずっと下書きに置いている間に、GAされました!(2026/5/27)

https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html

https://github.com/aws/aws-durable-execution-sdk-java

プロジェクトのセットアップ

Gradle の依存関係

build.gradle.kts で SDK と Shadow Plugin を設定します。

plugins {
    kotlin("jvm") version "2.1.10"
    id("com.gradleup.shadow") version "9.0.0-beta12"
}

java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

kotlin {
    jvmToolchain(17)
}

repositories {
    mavenCentral()
}

dependencies {
    implementation("software.amazon.lambda.durable:aws-durable-execution-sdk-java:0.5.0-beta")
    implementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.18.3")

    testImplementation("software.amazon.lambda.durable:aws-durable-execution-sdk-java-testing:0.5.0-beta")
    testImplementation(kotlin("test"))
}

tasks.test {
    useJUnitPlatform()
}

tasks.shadowJar {
    archiveClassifier.set("")
    mergeServiceFiles()
}
  • SDK は Maven Central に公開済みなので、追加リポジトリは不要です
  • jackson-module-kotlin を依存に追加するだけで、Kotlin の data class をそのまま入出力に使えます(SDK 側の ObjectMapper への明示的な登録は不要でした)
  • ビルドには Shadow Plugin で fat jar を作成します

ハンドラの実装

入力の data class を定義します。

data class GreetingRequest(
    val name: String = "World"
)
  • デフォルト引数を設定しておくと、Jackson のデシリアライズ時にフィールドが省略されても動作します

DurableHandler を継承してハンドラを実装します。

class GreetingHandler : DurableHandler<GreetingRequest, String>() {

    override fun handleRequest(input: GreetingRequest, context: DurableContext): String {
        val greeting = context.step("create-greeting", String::class.java) {
            "Hello, ${input.name}"
        }

        // 10秒間待機(この間コンピュート課金なし、Lambda は中断される)
        context.wait("pause", Duration.ofSeconds(10))

        val result = context.step("finalize", String::class.java) {
            "$greeting - completed at ${Instant.now()}"
        }

        return result
    }
}
  • step() の型パラメータには String::class.java のように Kotlin の Class リテラルを渡します
  • step() のラムダは Supplier<T> への SAM 変換で動作するため、引数なしのラムダをそのまま渡せます
  • wait() で Lambda の実行が中断され、指定時間後に自動的に再開します。再開時は関数が最初から再実行されますが、完了済みの step() はチェックポイントから結果が復元されるためスキップされます

ローカルテスト

SDK にはローカル実行用の LocalDurableTestRunner が付属しています。

class GreetingHandlerTest {

    private val runner = LocalDurableTestRunner.create(
        GreetingRequest::class.java,
        GreetingHandler()
    )

    @Test
    fun `should greet with name`() {
        val result = runner.runUntilComplete(GreetingRequest(name = "Kotlin"))
        assertTrue(result.isSucceeded)
        val output = result.getResult(String::class.java)
        assertTrue(output.startsWith("Hello, Kotlin - completed at"))
    }
}
  • LocalDurableTestRunner.create() でランナーを作成します(コンストラクタは private)
  • runUntilComplete() は wait を自動スキップして最後まで実行します
  • TestResult の isSucceeded と getResult() で結果を検証します

デプロイ

コンテナイメージが必須

Java SDKではマネージドランタイム(java17 等)に DurableConfig を設定できません。コンテナイメージ方式でデプロイする必要があります。

Dockerfile は以下のように書きます。

FROM amazoncorretto:17-alpine AS builder
WORKDIR /build
COPY . .
RUN ./gradlew shadowJar --no-daemon

FROM public.ecr.aws/lambda/java:17
COPY --from=builder /build/build/libs/lambda-durable-functions-kotlin-1.0.0.jar ${LAMBDA_TASK_ROOT}/lib/
CMD ["com.example.durable.GreetingHandler::handleRequest"]

ECR へのプッシュと Lambda 作成

イメージをビルドして ECR にプッシュします。

aws ecr create-repository --repository-name durable-greeting-kotlin

# ログイン・ビルド・プッシュ
aws ecr get-login-password | docker login --username AWS --password-stdin <account>.dkr.ecr.<region>.amazonaws.com
docker build --platform linux/arm64 -t <account>.dkr.ecr.<region>.amazonaws.com/durable-greeting-kotlin:latest .
docker push <account>.dkr.ecr.<region>.amazonaws.com/durable-greeting-kotlin:latest

Lambda 関数を作成します。--durable-config で Durable Execution を有効化します。

aws lambda create-function \
  --function-name durable-greeting-kotlin \
  --package-type Image \
  --code ImageUri=<account>.dkr.ecr.<region>.amazonaws.com/durable-greeting-kotlin:latest \
  --role arn:aws:iam::<account>:role/lambda-durable-kotlin-role \
  --timeout 900 \
  --memory-size 512 \
  --architectures arm64 \
  --durable-config '{"ExecutionTimeout": 300, "RetentionPeriodInDays": 3}'

IAM ポリシー

Lambda の実行ロールには、通常の AWSLambdaBasicExecutionRole に加えて以下の権限が必要です。

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Action": [
      "lambda:CheckpointDurableExecution",
      "lambda:GetDurableExecutionState"
    ],
    "Resource": "arn:aws:lambda:<region>:<account>:function:durable-greeting-kotlin:*"
  }]
}

Resource の末尾 :* が重要です。Durable Execution のリソース ARN は function:<name>:<version>/durable-execution/<id> という形式になるため、関数名だけでは権限が足りません。

バージョンの publish

Durable Execution は $LATEST では動作しません。必ずバージョンを publish してから呼び出します。

aws lambda publish-version --function-name durable-greeting-kotlin

$LATEST が使えない理由は、リプレイの整合性にあります。Durable Execution は障害時にコードを最初から再実行し、step() の結果はチェックポイントから復元します。$LATEST はミュータブルなので、中断中にデプロイが行われるとリプレイ時のコードが変わり、step 名や順序がチェックポイントと不整合になります。publish されたバージョンはイミュータブルなので、この問題が発生しません。

実行結果

マネジメントコンソールで Lambda 関数を見ると、「永続実行」タブが追加されており、Durable の設定(実行タイムアウト、保持期間)や実行一覧を確認できます。

Lambda 永続実行タブ

Durable Execution の呼び出しには非同期(Event)を使います。同期呼び出しは Lambda の15分制限がそのまま適用されるため、wait() を使った長時間の実行には非同期呼び出しが必要です。

aws lambda invoke \
  --function-name durable-greeting-kotlin:1 \
  --invocation-type Event \
  --cli-binary-format raw-in-base64-out \
  --payload '{"name":"Kotlin"}'

通常の非同期呼び出しとは異なり、Durable Functions では DurableExecutionArn がレスポンスに返ります。これが実行状態の追跡に使う ID です。

{
    "StatusCode": 202,
    "DurableExecutionArn": "arn:aws:lambda:ap-northeast-1:...:function:durable-greeting-kotlin:1/durable-execution/..."
}

実行状態を確認します。

aws lambda get-durable-execution --durable-execution-arn <DurableExecutionArn>

10秒の wait を経て、SUCCEEDED になりました。

{
    "Status": "SUCCEEDED",
    "Result": "\"Hello, Kotlin - completed at 2026-03-11T14:27:55.712636928Z\""
}

マネジメントコンソールの実行詳細では、各オペレーション(create-greeting → pause → finalize)の実行状況がタイムライン付きで確認できます。pause の所要時間が 10秒になっていることから、wait() による中断・再開が正しく動作していることがわかります。

Durable Execution オペレーション一覧

さいごに

Java SDKは Kotlin からも素直に利用でき、DurableHandler の継承、step() への Kotlin ラムダの受け渡し、data class のシリアライズのいずれも問題なく動作しました。

デプロイ時のハマりポイントをまとめます。

  • コンテナイメージ方式が必須(マネージドランタイムは非対応)
  • IAM の Resource には function:<name>:* のワイルドカードが必要(function:* ではサブリソースにマッチしない)
  • IAM のアクション名は CheckpointDurableExecution(単数形)。
  • $LATEST では動作しない。バージョンの publish が必要

この記事をシェアする
著者:酒井亮太郎
シナモロール