Skip to content

Add Azure Functions Durable V2 samples and migration guide - #219

Merged
andystaples merged 2 commits into
mainfrom
andystaples-add-v2-samples-migration-guide
Jul 29, 2026
Merged

Add Azure Functions Durable V2 samples and migration guide#219
andystaples merged 2 commits into
mainfrom
andystaples-add-v2-samples-migration-guide

Conversation

@andystaples

Copy link
Copy Markdown
Contributor

Summary

  • add runnable Azure Functions Durable 2.x samples for function chaining, fan-out/fan-in, human interaction, and durable entities
  • add a staged migration guide for moving decorator-based applications from 1.x compatibility APIs to durabletask-native APIs
  • document Python, extension bundle, replay, client, retry, and entity migration requirements
  • link the new resources from the provider README and changelog

Validation

  • python -m pyright --project azure-functions-durable\pyrightconfig.json azure-functions-durable\samples
  • python -m flake8 azure-functions-durable\samples
  • python -m pymarkdown -c .pymarkdown.json scan azure-functions-durable\README.md azure-functions-durable\MIGRATION_GUIDE.md azure-functions-durable\samples\README.md
  • loaded each sample function_app.py against the local provider implementation

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 8be112df-948c-4136-a13a-67c8dceb9513
Copilot AI review requested due to automatic review settings July 28, 2026 19:21

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds new end-to-end Azure Functions Durable 2.x (preview) documentation and runnable samples to help users adopt the durabletask-native APIs and migrate decorator-based apps from 1.x compatibility APIs.

Changes:

  • Added four runnable Azure Functions Durable 2.x samples (function chaining, fan-out/fan-in, human interaction, durable entities) with per-sample host/config and dependencies.
  • Added a staged migration guide covering runtime/dependency requirements, API mappings, and compatibility limitations.
  • Updated the provider README and changelog to link to the new samples and migration guide.

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
azure-functions-durable/samples/README.md Entry point for running and invoking the new 2.x samples.
azure-functions-durable/samples/human-interaction/requirements.txt Sample dependency pins for the human-interaction scenario.
azure-functions-durable/samples/human-interaction/local.settings.json Local settings for running the human-interaction sample against Azurite.
azure-functions-durable/samples/human-interaction/host.json Host/extension bundle configuration required for the 2.x preview runtime.
azure-functions-durable/samples/human-interaction/function_app.py Human-interaction orchestration + HTTP endpoints demonstrating external events + timeout.
azure-functions-durable/samples/function-chaining/requirements.txt Sample dependency pins for function chaining.
azure-functions-durable/samples/function-chaining/local.settings.json Local settings for running the function-chaining sample.
azure-functions-durable/samples/function-chaining/host.json Host/extension bundle configuration for function chaining.
azure-functions-durable/samples/function-chaining/function_app.py Function-chaining orchestration + starter + activity sample.
azure-functions-durable/samples/fan-out-fan-in/requirements.txt Sample dependency pins for fan-out/fan-in.
azure-functions-durable/samples/fan-out-fan-in/local.settings.json Local settings for running the fan-out/fan-in sample.
azure-functions-durable/samples/fan-out-fan-in/host.json Host/extension bundle configuration for fan-out/fan-in.
azure-functions-durable/samples/fan-out-fan-in/function_app.py Fan-out/fan-in orchestration + starter + activity sample.
azure-functions-durable/samples/durable-entities/requirements.txt Sample dependency pins for durable entities.
azure-functions-durable/samples/durable-entities/local.settings.json Local settings for running the durable-entities sample.
azure-functions-durable/samples/durable-entities/host.json Host/extension bundle configuration for durable entities.
azure-functions-durable/samples/durable-entities/function_app.py Durable entity class + orchestration + HTTP starter demonstrating entity operations.
azure-functions-durable/README.md Adds links to the new samples and migration guide.
azure-functions-durable/MIGRATION_GUIDE.md New staged migration guide detailing requirements, API mappings, and limitations.
azure-functions-durable/CHANGELOG.md Documents the new samples and migration guide under Unreleased.

Comment thread azure-functions-durable/MIGRATION_GUIDE.md Outdated
Comment thread azure-functions-durable/MIGRATION_GUIDE.md Outdated
Comment thread azure-functions-durable/samples/function-chaining/function_app.py Outdated
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 8be112df-948c-4136-a13a-67c8dceb9513
Copilot AI review requested due to automatic review settings July 28, 2026 19:38

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 20 out of 20 changed files in this pull request and generated no new comments.

@andystaples
andystaples merged commit b229e69 into main Jul 29, 2026
25 checks passed
@andystaples
andystaples deleted the andystaples-add-v2-samples-migration-guide branch July 29, 2026 03:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants