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:latestLambda 関数を作成します。--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 の設定(実行タイムアウト、保持期間)や実行一覧を確認できます。

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() による中断・再開が正しく動作していることがわかります。

さいごに
Java SDKは Kotlin からも素直に利用でき、DurableHandler の継承、step() への Kotlin ラムダの受け渡し、data class のシリアライズのいずれも問題なく動作しました。
デプロイ時のハマりポイントをまとめます。
- コンテナイメージ方式が必須(マネージドランタイムは非対応)
- IAM の Resource には
function:<name>:*のワイルドカードが必要(function:*ではサブリソースにマッチしない) - IAM のアクション名は
CheckpointDurableExecution(単数形)。 $LATESTでは動作しない。バージョンの publish が必要