Releases: Azure/durabletask
DurableTask.AzureStorage v2.0.1
https://www.nuget.org/packages/Microsoft.Azure.DurableTask.AzureStorage/2.0.1
Updates
- Add setting to allow replaying terminal orchestrators by @davidmrdavid #1159
Full Changelog: durabletask.azurestorage-v2.0.0...durabletask.azurestorage-v2.0.1
DurableTask.ApplicationInsights v0.2.0
https://www.nuget.org/packages/Microsoft.Azure.DurableTask.ApplicationInsights/0.2.0
Dependency Updates
- DurableTask.Core 2.17.1 --> 3.0.0
DurableTask.AzureStorage v1.17.5
https://www.nuget.org/packages/Microsoft.Azure.DurableTask.AzureStorage/1.17.5
Updates
- Add setting to allow replaying terminal orchestrators by @davidmrdavid in #1163
Full Changelog: durabletask.azurestorage-v1.17.4...durabletask.azurestorage-v1.17.5
DurableTask.Core v3.0.0
https://www.nuget.org/packages/Microsoft.Azure.DurableTask.Core/3.0.0
This is a major release of DurableTask.Core, with some breaking changes, mostly around transitive dependencies. Please read these release notes carefully and note that there may be other unintended side-effects from these updates; report any such cases on our GitHub board for review.
Updates
netstandard2.0
is now the only TFM, dropping explicit targeting ofnet462
(#1125)Newtonsoft.Json
dependency is now13.0.1
(#1125)System.Diagnostics.DiagnosticSource
dependency is now6.0.1
(#1139)Microsoft.Extensions.Logging.Abstractions
is now6.0.1
(#1143)- Reduce telemetry scope in Durable Functions usage (#1100)
Note: Although we have scoped these changes for maximum backwards behavioral compatibility with existing TaskHub data, there may be some unintended issues during live migrations by the nature of the major dependency upgrades. Please test in your test/canary environments before deploying broadly and report any issues in our GitHub board for review.
DurableTask.AzureStorage v.2.0.0
https://www.nuget.org/packages/Microsoft.Azure.DurableTask.AzureStorage/2.0.0
This is a major release of DurableTask.AzureStorage, with some breaking changes, mostly around transitive dependencies. Please read these release notes carefully and note that there may be other unintended side-effects from these updates; report any such cases on our GitHub board for review.
Updates
DurableTask.Core
dependency is now 3.0.0.netstandard2.0
is now the only TFM, dropping explicit targeting ofnet462
(#1125)- Dependency on
Windows.AzureStorage
is dropped in favor ofAzure.Core
1.41.0
,Azure.Data.Tables
12.8.3
,Azure.Storage.Blobs
12.20.0
, andAzure.Storage.Queues
12.18.0
(#1132) - Dependency on
System.Linq.Async
is6.0.1
(#1132) - Dependency on
Microsoft.Bcl.AsyncInterfaces
is version6.0.1
(#1132) - Reduce telemetry scope in Durable Functions usage (#1100)
- Config
UseTablePartitionManagement
set totrue
by default (#1133). This enables the new table-based partition manager algorithm. Users can expect a new<taskHub>partitions
table in their storage account, which will be used for partition load balancing. - Convert timer target to UTC (#1138)
Note:
- Although we have scoped these changes for maximum backwards behavioral compatibility with existing TaskHub data, there may be some unintended issues during live migrations by the nature of the major dependency upgrades. Please test in your test/canary environments before deploying broadly and report any issues in our GitHub board for review.
- To ensure the functions work correctly, if you are using this v2.0.0 version and need to revert to DurableTask.AzureStorage v1.x, please downgrade to v1.17.4, as it maintains backward compatibility with DurableTask.AzureStorage v2.x.
- Partition Manager v3 will be the default partition management starting with this version. This is the algorithm that load balances queues to VMs. You may revert to the old partition manager strategy by setting UseTablePartitionManagement to
false
inAzureStorageOrchestrationServiceSettings
.
Guidance for phased deployments:
- If you're doing a phased deployment of
DurableTask.AzureStorage v2.0.0
, meaning that some VMs in your Task Hub / app will operate with this new package (v2.x) while others will operate withDurableTask.AzureStorage v1.x
, please read the following guidance:- The new partition manager v3 does not interoperate with the default partition manager in
DurableTask.AzureStorage v1.x
. Therefore, set UseTablePartitionManagement tofalse
inAzureStorageOrchestrationServiceSettings
to avoid split brain problems while deployment is ongoing. - Messages generated by
DurableTask.AzureStorage v2.0.0
have a different encoding thanDurableTask.AzureStorage v1.x
. OnlyDurableTask.AzureStorage v1.17.4
is forwards-compatible with theDurableTask.AzureStorage v2.x
encoding, so please make sure to first upgrade toDurableTask.AzureStorage v1.17.4
before migrating toDurableTask.AzureStorage v2.0.0
. - If you're not doing a phased deployment, and instead all the nodes operating on your Task Hub will upgrade to the same package at once, then this guidance does not apply to your system.
- We are looking to invest in features to make migration easier, you may expect them in future iterations of this package.
- The new partition manager v3 does not interoperate with the default partition manager in
DurableTask.AzureStorage v1.17.4
https://www.nuget.org/packages/Microsoft.Azure.DurableTask.AzureStorage/1.17.4
Updates
- Add future-compatibility with the encoding of messages in DurableTask.AzureStorage 2.x, allowing for a downgrade path (#1120)
DurableTask.ServiceBus v4.0.1
https://www.nuget.org/packages/Microsoft.Azure.DurableTask.ServiceBus/4.0.1
Updates
- Virtually the same release as DurableTask.ServiceBus 4.0.0 except the package dependencies no longer list a CI-build of DurableTask.Core as it's dependency
DurableTask.ServiceBus v4.0.0
https://www.nuget.org/packages/Microsoft.Azure.DurableTask.ServiceBus/4.0.0
Breaking changes
Switch from legacy WindowsAzure.Storage SDK to modern Azure.Data.Tables and Azure.Data.Blobs SDK (#1112)
Updates
Adds support for Microsoft Entra ID for Azure Storage backend resources.
This is a breaking change release and existing orchestrations are not guaranteed to be compatible with this new SDK version.
Unlisting notice: this package was immediately unlisted due to accidentally depending on a CI-build of DurableTask.Core. Please use DurableTask.ServiceBus v4.0.1 instead
DurableTask.AzureStorage v2.0.0-rc.2
https://www.nuget.org/packages/Microsoft.Azure.DurableTask.AzureStorage/2.0.0-rc.2
Updates
- Bug fix to ensure pop receipt is updated on message renewal operations: #1066 by @wsugarman
Dependency Updates
- DurableTask.Core 2.15.1 ->2.17.1
- Azure.Core 1.35.0 -> 1.39.0
- Azure.Data.Tables 12.9.1 -> 12.8.3
- Azure.Storage.Blobs 2.18.0 -> 12.20.0
- Azure.Storage.Queues 2.16.0 -> 12.18.0
Notes
- This is a preview release, not ready for production use