Durable functions doc updates and first changefile for preview by GarrettBeatty · Pull Request #2392 · aws/aws-lambda-dotnet

GarrettBeatty · 2026-05-27T17:51:13Z

used java sdk docs as an example https://github.com/aws/aws-durable-execution-sdk-java

Update Durable Execution SDK description in README Clarified description of the Durable Execution SDK and added a link to its README. update readme update docs changefile

normj · 2026-05-28T20:43:07Z

+
+### Your first durable function (managed runtime)
+
+A complete order-processing workflow with two steps and a wait, deployed as a class library on a managed .NET runtime such as `dotnet8`. Register the serializer once with the `LambdaSerializer` assembly attribute and configure your handler as `MyAssembly::OrderProcessor.OrderProcessor::Handler`. `DurableFunction.WrapAsync` resolves the serializer from `ILambdaContext.Serializer`, which the managed runtime populates from the assembly attribute.


Use dotnet10 since it is the more current runtime

normj · 2026-05-28T20:45:37Z

@@ -0,0 +1,129 @@
+# AWS Lambda Durable Execution SDK for .NET
+
+> **Preview.** `Amazon.Lambda.DurableExecution` is in active development (0.x). Public APIs may change before 1.0.


Since we don't have the deployment of new Amazon.Lambda.RuntimeSupport with support for accessing the serializer you should call out only executable programming model is supported for now.

I would suggest making all of the examples be executable mode as well and later we can revise the README once the managed runtime is updated.

normj · 2026-05-28T20:48:07Z

+
+### Executable assembly variant (custom runtime)
+
+If you target a custom runtime (`provided.al2023`) and deploy your function as an executable assembly, host it with `LambdaBootstrap` and pass the serializer in code instead of via an assembly attribute:


People use executable mode directly on the dotnet10 runtime. I would avoid talking about provided.al2023 and just discuss how the executable programming model works at a high level. The README for DurableExecution should be where you explain about custom runtimes or in depth executable programming model

normj · 2026-05-28T20:49:45Z

+dotnet add package Amazon.Lambda.DurableExecution
+```
+
+### Your first durable function (managed runtime)


Do you think it is worth expanding to give a high level about what you need to do to make callbacks work?

https://github.com/aws/aws-lambda-dotnet/blob/dfa8d1e48181eea17e8bb4df82ec93967a67a394/Libraries/src/Amazon.Lambda.DurableExecution/docs/core/callbacks.md thats already in this file

or do you mean how to invoke the callback from somewhere else

updated in e5fe657

normj

Approve with one minor nit

normj · 2026-06-02T16:37:51Z

+
+### Your first durable function
+
+> **Programming model:** the preview only supports the **executable programming model** — your function is an executable assembly that hosts its own bootstrap loop and passes the serializer to the runtime in code. Class-library handlers on the managed runtime will be supported once `Amazon.Lambda.RuntimeSupport` ships the changes that let `DurableFunction.WrapAsync` resolve the serializer from `ILambdaContext.Serializer`. This README will be updated then.


Since you can argue we will have already shipped the changes for Amazon.Lambda.RuntimeSupport to NuGet for executable programming model I suggest changing this to:

Class-library handlers on the managed runtime will be supported once Amazon.Lambda.RuntimeSupport ships the changes that let DurableFunction.WrapAsync resolve the serializer from ILambdaContext.Serializer
to
Class-library handlers on the managed runtime will be supported once the changes made to Amazon.Lambda.RuntimeSupport to support durable functions has been deployed to the managed runtime.

Updated README to clarify programming model support and changes.

GarrettBeatty commented May 27, 2026

View reviewed changes

Comment thread Libraries/src/Amazon.Lambda.DurableExecution/README.md Outdated

GarrettBeatty force-pushed the gcbeatty/durrelease branch from 3de245a to 8dbdaa5 Compare May 28, 2026 15:19

GarrettBeatty marked this pull request as ready for review May 28, 2026 15:35

GarrettBeatty requested review from a team as code owners May 28, 2026 15:35

GarrettBeatty requested review from normj and philasmar and removed request for a team May 28, 2026 15:35

GarrettBeatty changed the title ~~release~~ Durable functions doc updates and first changefile for preview May 28, 2026

Base automatically changed from gcbeatty/durable-callbacks to feature/durablefunction May 28, 2026 15:45

release

dfa8d1e

Update Durable Execution SDK description in README Clarified description of the Durable Execution SDK and added a link to its README. update readme update docs changefile

GarrettBeatty force-pushed the gcbeatty/durrelease branch from b946cba to dfa8d1e Compare May 28, 2026 15:47

philasmar approved these changes May 28, 2026

View reviewed changes

GarrettBeatty mentioned this pull request May 28, 2026

Feature/durablefunction #2394

Merged

normj reviewed May 28, 2026

View reviewed changes

norm comments

71e0040

GarrettBeatty requested a review from normj May 29, 2026 14:29

Add end-to-end callback example with workflow and approver Lambdas

e5fe657

normj approved these changes Jun 2, 2026

View reviewed changes

Revise README for DurableExecution programming model

2983098

Updated README to clarify programming model support and changes.

GarrettBeatty merged commit 110135d into feature/durablefunction Jun 2, 2026
3 checks passed

GarrettBeatty deleted the gcbeatty/durrelease branch June 2, 2026 16:41


		### Your first durable function (managed runtime)

		A complete order-processing workflow with two steps and a wait, deployed as a class library on a managed .NET runtime such as `dotnet8`. Register the serializer once with the `LambdaSerializer` assembly attribute and configure your handler as `MyAssembly::OrderProcessor.OrderProcessor::Handler`. `DurableFunction.WrapAsync` resolves the serializer from `ILambdaContext.Serializer`, which the managed runtime populates from the assembly attribute.

		@@ -0,0 +1,129 @@
		# AWS Lambda Durable Execution SDK for .NET

		> Preview. `Amazon.Lambda.DurableExecution` is in active development (0.x). Public APIs may change before 1.0.


		### Executable assembly variant (custom runtime)

		If you target a custom runtime (`provided.al2023`) and deploy your function as an executable assembly, host it with `LambdaBootstrap` and pass the serializer in code instead of via an assembly attribute:


		### Your first durable function

		> Programming model: the preview only supports the executable programming model — your function is an executable assembly that hosts its own bootstrap loop and passes the serializer to the runtime in code. Class-library handlers on the managed runtime will be supported once `Amazon.Lambda.RuntimeSupport` ships the changes that let `DurableFunction.WrapAsync` resolve the serializer from `ILambdaContext.Serializer`. This README will be updated then.

Uh oh!

Conversation

GarrettBeatty commented May 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

normj left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

GarrettBeatty commented May 27, 2026 •

edited

Loading